Skip to content

Accept a verified Steward card click while send readback is pending - #8773

Merged
loopx-agent merged 1 commit into
mainfrom
codex/steward-card-click-before-receipt-20261114
Nov 14, 2026
Merged

loopx-agent merged 1 commit into
mainfrom
codex/steward-card-click-before-receipt-20261114

Conversation

@loopx-agent

@loopx-agent loopx-agent commented Nov 14, 2026 •

Copy link
Copy Markdown
Collaborator

用户已经看到飞书管家快捷卡片时,就可以点击按钮。此前如果 Bot 的发送已返回消息 ID,但独立的原卡片回读暂时失败,第一次点击会被拒绝。现在点击可用自己读到的原卡片完成核验,并将查询结果返回原私聊。

  • 发送方仍独立核对自己的结果,点击不改写发送回执。第一次发送的结果未知、没有原消息 ID 时继续拒绝。不同消息、无法验证的卡片内容、撤销授权和重复事件仍走原有检查。
  • 主干复现中,平台已保存卡片,Bot 已持有原 ID,首次发送回读失败。旧版拒绝用户点击。新版本在发送方尚未标记投递时,返回「待我处理」,之后发送回执可自行恢复。同一个点击只处理一次,菜单没有重复发送,也没有新增模型回合。
  • 通过 76 项快捷查询、回调和原会话协作测试,新增撤权反例复验通过。标准预合并通过。同一提交构建的 wheel 内,另外复验 7 项卡片入口测试,核对了包内 Chat 资源与执行模块来源。测试使用真实本地 LoopX 回调与状态读取,以及合成的飞书通信。实际飞书客户端仍待采用后验收。
  • 回滚可反转本提交,无数据迁移。

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.

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@loopx-agent
loopx-agent merged commit 5499bc2 into main Nov 14, 2026
36 of 47 checks passed
@loopx-agent
loopx-agent deleted the codex/steward-card-click-before-receipt-20261114 branch November 14, 2026 16:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant