Repository navigation
Accept a verified Steward card click while send readback is pending - #8773
Conversation
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
评审提交 eb5081d;精确目标基线 4604f93。源码评审通过:已显示的原卡片能接住第一次点击,结果仍只回原私聊一次。
动机 / Motivation
使用飞书私聊快捷卡片查询待办的管家用户。 菜单已经出现在聊天里。Bot 已拿到该卡片的消息 ID,但自己的发送回读暂时失败;用户这时点击「待我处理」。 主干必须等发送端回读成功才接受这种点击。用户已经看到了按钮,却要等发送重试后再点一次。 候选让点击使用 Bot 读回的同一张原卡片,先进入原会话的查询队列。发送回执仍由原发送端确认;同一事件重送只发一张结果卡。 独立测试走真实本地私聊、原绑定与回调代码,飞书通信使用合成提供商;本轮未验证已安装服务、真机飞书或 App 权限变化。
改动思路 / Approach
既有 Core 绑定、飞书精确消息回读和确定性快捷查询 worker。 原卡片读取证明同 App、同私聊、实际内容和动作;捕获查询与发卡对同一用户使用两份独立收据。 只放开已有原消息 ID、未退役的 captured 卡片;继续经现有确证、绑定、事件锁和发送 worker 处理。 直接用已入队的发送状态不够:发送结果未知且没有 ID 时,无法证明按钮属于哪张原卡,必须等待已知身份。回复 worker 在真正发回结果前独立重查权限。
具体改动 / Changes
关键代码讲解
- known-card-before-receipt:已验证。 点击入口 放开已有消息 ID、未退役的 captured;同 App、同 chat、同操作者、同动作、时限及 原卡片精确回读 均保留。主干在真实隔离回调入口要求 delivered,候选允许当前点击。直到发送 worker 自己回读成功,父请求文件保持逐字不变。
- fresh-scope-and-effect-denial:已验证。 卡片内容不能核对、复制消息和没有消息 ID 的未知发送继续被拒绝。把撤权放在点击读回原卡片期间,两版都可能先接受这个只表示捕获的排队回执;随后实际回复 worker 不发送任何结果,下一次重放也拒绝。把原指令编辑后再送回调,候选的发送端退役该结果,旧卡片随后拒绝。此处没有把回调排队当成权限成功。发送前复核
- one-return-no-model-turn:已验证。 两个并发的同 ID 事件,一个入队,一个复用原事件,原私聊只收到一张「待我处理」。原菜单只发送一次,既有回执恢复后独立标记 delivered。没有新增 Session、Core 业务请求或模型轮次。原事件幂等锁
现有私聊观察合同 要求只读观察留在原绑定且不调用模型;现有 权限与读回的验收原则 同样适用。本次 diff 两个文件 +82/−1,没有更改卡片模板和页面代码。
对主干的风险 / Risks
实际用户收益集中在可见但发送回读暂时失败的窗口。仍不能向身份未知、已退役或内容不符的卡片回放结果。上面的撤权测试区分登记和外部效果,发布时仍走既有 source、scope、binding 和 Session 检查。123 项快捷查询及管家回传用例通过;三组独立用例在两个提交上均执行,且正确区分早点击、并发重送、撤权及原消息编辑。标准预合并十项选中检查无失败。 托管 CI 未查询。
我的整体评价 / Verdict
通过。当前证据核实可见卡片在原回读延迟时仍能查询,且发送恢复不会重复影响原会话。实际飞书采用、移动端按钮及原会话回执仍需通过已安装版本独立验收;这份源码评审不授予合并资格。
English verdict: APPROVE at eb5081d. A visible pinned card can accept its first click before the sender verifies delivery, while replay and post-click revocation preserve one scoped reply or no reply.
用户已经看到飞书管家快捷卡片时,就可以点击按钮。此前如果 Bot 的发送已返回消息 ID,但独立的原卡片回读暂时失败,第一次点击会被拒绝。现在点击可用自己读到的原卡片完成核验,并将查询结果返回原私聊。
This changes the point from which a visible, verified Private Steward card can accept a click. Its layout, content, and controls are unchanged. The existing synthetic first-screen captures still represent the rendered menu and results. Menu and result cards from #8695.