Repository navigation
Fix shared Lark callback dispatch for query and operation cards - #8921
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; reasoning effort max; runtime_reported.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
动机 / Motivation
已绑定管家的使用者需要在同一 Bot App 中查看任务,并确认一张已有授权的操作卡。旧版共享回调只转发查询卡,操作确认卡会丢失或进入错误的 Chat action store;新版把它送回原协调根,同时查询卡继续使用原会话。源码和隔离 wheel 验证确认:原操作只执行一次、结果读回原卡,查询不增加模型 Turn 或替换已有 Session。本次只审查共享回调路由,不切换正式服务、不启动第二个消费者,也不新增 managed wake 授权。正式安装版本、同 App 的既有消费者切换与真实客户端点击尚未验收。
改动思路 / Approach
回调流只根据既有 schema_version 选择处理器。查询卡仍交给原来源授权与 Session 的查询 owner;操作卡交给原协调根下的 proposal、confirmation、claim 和结果读回 owner。选择现有操作 owner,保留查询与操作各自的授权和重放规则,比分建消费者或备用 action store 更小且可验证。当前 PR 完成共享回调在源码与 wheel 中的正确分发;正式消费者切换、已配置 wake 迁移和真实点击由既有服务 owner 继续验收。
| 输入分支 | 原有行为与本次结果 |
|---|---|
| 查询卡 | 保持原 Chat 来源与 Session;只排队查询结果,无额外模型 Turn |
| 操作卡 | 从旧的遗漏/manager fallback,改为原协调根的操作处理器;仍需原卡、App、principal 与确认摘要 |
| 未知回调或失效来源 | 未知形状忽略;App 或协调 owner 不可用时拒绝;没有 Chat-root fallback |
这个表是所审源码的路由说明,执行证据见下文。它不表示正式服务已切换。
具体改动 / Changes
评审 head:65e5897425f666e34dc924a4810101a93ad1668b。五个文件 +248/-6,其中生产代码只在两个既有适配器中增加路由与边界检查,测试增加182行,英中 RFC 同步说明资格与剩余边界。没有新增 schema、配置或卡片 renderer。
关键代码讲解
start_team_plan_review_callback_stream保留一条card.action.trigger订阅。jq 和 Python 两层处理字符串/对象 action,额外接受现有 operation schema;数组、数字、空值、未知版本和坏 JSON 不进入相应处理器。普通群聊 allowlist 和 required 标记维持原行为。handle_review_callback在操作分支重读当前 App,并要求控制器提供Path类型的协调根。原私有 Chat 根不会充当备用权威;缺失或改变的 App、不可用 owner 在调用操作处理器前失败。handle_goal_channel_operation_callback本身未改动,继续验证原卡、principal、App、摘要、成员身份与 proposal 生命周期,再通过既有 dispatch/result 锁处理重放和原卡更新。没有在新路由中复制这些规则。
规格基于主干 d25e044c8c2aa3d862fb868eea93b58c901b07cc 的 docs/architecture/rfcs/app-conversation-and-async-inbox-v0.md。Bound-steward-private-Chat:声明的协调根与私有 Chat 存储分离已实现并通过分根真实存储路径验证;Private-Chat-status-and-help:原 Session、来源授权和无额外模型调用的只读命令边界保留,File/SQLite 回归通过。新增 RFC 段落是本 PR 的交付说明,判断依据仍是修改前已接受的 owner 与会话契约。
对主干的风险 / Risks
未发现阻塞 finding。最危险的反例是测试直接伪造“操作完成”,而生产代码实际仍读错 action store。本轮使用真实 Core/store 和分离的协调根完成 proposal → confirmation → claim → outcome → 原卡读回;provider 与执行器为合成实现,未替代被审查的存储归属及 claim 语义。重复操作只执行一次,重放不重复外部写;查询回调重放保持原捕获,并且既有 Session 消息和模型请求捕获不变。
错误 chat 被拒绝;附加验证覆盖 App 缺失/变化、owner 为 None/字符串,以及错误根中找不到 proposal,均在执行前失败,没有备用存储降级;撤销 binding 后也不能执行。未知 shape 通过实际 jq 与分发器双层验证。关闭管家或普通 project profile 时不创建回调流;普通群聊的源参数与 required 标记,在相同输入的 base/head 调用中完全一致。仅凭安装、schema 可见或 provider readiness 不会激活权限。
| 本轮独立验证 | 结果 |
|---|---|
| 四个受影响 Lark 模块 | PASS,head158项;base156项 |
| 新混合协议用例反跑主干 | 预期 FAIL:操作事件未到达,另一路报 Lark manager review callbacks require Chat actions;head两项通过 |
| Native private 路径 / 额外失效边界 | PASS,74项 / 1项 |
| 隔离安装 wheel | PASS,10项;从 site-packages 加载,1445个 Python 模块与精确 head 字节一致;含真实 File/SQLite 查询路径 |
| 标准 premerge / Ruff / 配置内 mypy | PASS,6项直接检查、11项选中检查、17个配置内类型检查文件 |
初次测试命令含不存在的文件,修正后完成验证;初次 premerge 缺少 npm 依赖,补齐后完整通过。初次 wheel 构建缺少前端 bundle,按仓库流程构建后成功;初次 wheel 测试缺少测试所需 example,补齐相同 fixture 后10项通过,失败没有被改记为成功。没有查询或等待 CI。
语义与 CI 对齐
两个协议复用既有常量及类型状态;分发是 provider adapter 责任,确认和 effect 权威仍由现有 operation owner 持有。英中 RFC 差异门及语义检查均通过。没有增加泛化 Core 义务,也没有把 advisory 文字变成新的调度授权。已经配置的独立消费者与 managed wake 配置仍需原 owner 在切换前处理,本路由不会自动停止或迁移它们。
我的整体评价 / Verdict
APPROVE,限定为独立可回退的源码与打包路径增量。共享回调恢复了原操作的确认与结果返回,没有增加用户确认轮次或新的状态权威。长程效果的具体收益是保留同一操作的后续结果与重放,而非只获得一次“已接收”回执;这里没有用测试数量或旧 PR 的 approval 代替判断。本 PR 没有修改卡片 renderer、布局或文案;检查了现有 builder 与原卡更新路径,变化仅在回调归属。正式客户端点击与服务切换未验收。它们由既有服务 owner 按原任务继续验收,当前结果不能宣称真实手机按钮已恢复。该源码切片无需等待未获授权的正式切换才能评审;也不授予安装、wake、合并或发布权限。
English verdict: APPROVE — shared callback routing preserves the original authorities; live-service cutover remains unverified.
同一 Bot App 的卡片事件只有一个消费者入口。现有 Steward 回调流能识别查询卡,却没有把 typed operation 确认交给原操作处理器;两条运行路径并存时,按钮可见也不证明回调会被正确采用。
本次让既有回调流同时分发 Steward 查询卡与操作确认卡,不新增消费者、配置或 schema。操作仍使用控制器的协调根和原 Core 提案/确认/claim/结果读回;查询仍使用原 Chat binding、来源授权和 Session。未知 payload 会被忽略,App 变化或协调 owner 不可用时拒绝处理。Python 只承担既有 Lark 传输接入,决策权威仍在原 typed owner。
验证覆盖同一物理回调流的两类协议与实际 jq 过滤、Chat/协调根分离、错误会话拒绝、重放仅执行一次、原卡结果读回、解绑撤权,以及查询不增加模型 Turn。中英文 App conversation RFC 同步记录此边界;同域整理复用了一次 profile 读取,并为 jq schema 读取加 object 形状检查,没有另抽路由/队列。
Validation(head
65e5897425f666e34dc924a4810101a93ad1668b,based25e044c8c2aa3d862fb868eea93b58c901b07cc):cqr_86113ff77cf012d13840,PASS;标准预合并检查全部通过(6 项直接检查 + 11 项选择检查,零失败)。正式服务切换和真实桌面/手机客户端点击尚未执行。已有独立 operation consumer 需要按原归属协调切换;本 PR 不停止它、不安装或重启服务,也不迁移已配置的 managed wake 策略。未配置的 managed wake 仍无执行授权。源码和 wheel 资格不代替这些验收,也不授予 merge/install 权限。
Visual evidence:卡片 renderer 相对 #8870 的
69e0a080未改变,以下复用该提交的公开合成渲染截图(桌面 1180×945、窄屏 390×1580)。本次回调行为在上述 head 验证;图片不是原生客户端点击或已安装服务证据。