项目业务与应用场景
本地 Codex 与具体电脑、项目目录和会话绑定，团队成员离开电脑后无法继续任务，也不能让同事在明确授权下参与同一上下文。
07REMOTE AI COLLABORATION
飞书远程协同 AI 助手（Codex 飞书桥接）
开发人员和授权同事可以通过飞书手机端继续使用本地 Codex，话题自动恢复项目与会话上下文。
Node.js 22TypeScriptFeishu Channel SDKCodex App Server JSON-RPCSQLitemacOS Keychain
从手机继续已有开发任务
通过飞书话题恢复授权项目中的 Codex 会话，离开电脑后仍可查看进展与继续操作。
话题与项目上下文稳定绑定
群聊绑定项目、顶层话题对应 Session 与 Thread，使同一讨论持续进入同一工作上下文。
排队和审批都有明确归属
同一会话内的消息按顺序处理，高风险操作只接受原请求人的确认，重复消息不会重复执行。
BUSINESS FLOW
核心业务链路
从用户进入系统开始，查看业务数据如何经过各环节并形成最终结果。
SYSTEM NODE 01
飞书群与话题
群绑定项目，顶层话题提供稳定的会话入口。
ENGINEERING DECISIONS
难题如何变成系统能力
从业务约束出发，说明机制为什么成立、边界在哪里。
群聊—项目—话题—Thread 路由
- 难题
- 错误导入会话可能把另一项目的上下文带入群聊。
- 机制
- 成员与项目授权检查后执行精确项目路径匹配，SQLite 持久化群绑定、Session、Turn 与幂等记录。
- 结果
- 话题恢复有稳定目标，不跨项目混用本地上下文。
FIFO 与消息幂等
- 难题
- 飞书重发事件与同一话题的并发消息可能让本地任务重复或乱序执行。
- 机制
- 每个 Session 只允许一个活动 Turn，其余进入有界 FIFO 队列；消息 ID 去重并施加全局并发限制。
- 结果
- 同一消息只执行一次，同一会话内的请求保持先后顺序。
请求人绑定的审批
- 难题
- 群里的其他成员不应代替请求人批准高风险操作。
- 机制
- 显式 @bot 触发、项目级授权与一次性审批令牌共同约束动作；附件按 Session 隔离，凭据保存在系统钥匙串。
- 结果
- 审批对象与请求人一致，回传文件限定在授权项目范围内。
展开补充设计与约束
- 导入 Thread 时执行精确项目路径匹配，防止把其他目录的 Codex 上下文带入群聊。
- 附件按 Session 隔离，输出文件只能来自已注册项目目录。
- App Secret 保存到 macOS Keychain，高风险操作不能由其他群成员代为批准。
CAPABILITIES & BOUNDARIES
能力范围与设计边界
以下描述既有项目的能力与约束，不把浏览器模拟运行结果计为生产实测。
01Session 内 Turn 严格 FIFO
02消息 ID 幂等去重
03审批令牌绑定真实请求人