Agents_Team/docs/CODEX_APP_PRODUCT_HANDOFF.md

Codex App 产品交接文档

更新时间：2026-03-14

1. 先看什么

如果后面在 Codex app 里开新对话，先按这个顺序读：

1. D:\AI Code\Agents Team\README.md
2. D:\AI Code\Agents Team\docs\design.md
3. D:\AI Code\Agents Team\docs\OLD_MAIN_20260314_PLAN_SUMMARY.md
4. C:\Users\54972\.openclaw\agents\main\sessions\2b99b736-9bb5-4444-a72e-36fe796ccf3a.jsonl

优先级也按这个顺序理解：

1. 当前仓库真实代码和文档
2. 本文件
3. 旧总结
4. 旧原始会话

2. 当前仓库已经实现到哪里

当前仓库不是空壳，也不再只是“mock MVP”。

现在已经有：

• 项目级 lead
• 项目级团队草案
• 正式团队确认
• 团队变更确认
• lead 主对话
• 成员线程
• mailbox
• 共享记忆
• 任务推进
• reviewer 审查闭环
• 角色运行态
• 原生接管口
• 会话恢复 / 重建
• 动态模型列表

而且已经接入真实 Codex CLI，用在这些环节：

• lead 回复
• 团队草案生成
• 成员线程回复
• 任务启动回执
• reviewer 接单回执
• reviewer 审查结论
• 成员返工后复审回执

3. 现在这个产品到底是什么

一句话：

这是一个本地优先、项目级 lead 驱动、面向非程序员的多-agent 工作台。

再拆开说：

• 不是全局固定团队系统
• 不是后台管理表单页
• 不是点开就自动扫描项目的工具
• 不是一堆 agent 名字平铺展示的假看板

它的核心一直是：

• 项目级 lead
• 项目级团队
• lead 对话驱动工作台

4. 已经锁死的产品原则

后面新对话不要再把这些重新讨论一遍：

• 用户默认只和当前项目的 lead 聊
• 团队先讨论出草案，再确认正式创建
• 正式团队变更要先出变更清单，再单独确认
• 正式成员之间允许直接互相通讯
• mailbox 默认“任务优先，但允许自由消息”
• 共享记忆默认由 lead 整理入库
• 默认不自动 commit
• 默认不自动 push
• 项目摸底必须显式确认
• 不改 Codex CLI 本体，只做外层薄适配
• 项目里的协作状态放在项目自己的 .agents-team\workbench

5. 当前 UI 方向

当前项目页已经是下面这个结构：

• 左侧：像素办公室 / 成员状态
• 中间：大面积主对话区
• 右侧：收纳区

收纳区现在已经有：

• 团队草案
• 团队变更确认清单
• 任务推进
• Mailbox
• 共享记忆
• 项目摸底
• 运行态 / 接管口
• 人工接管
• Git 状态

当前风格方向：

• 默认深色工作台
• 中文白话文案
• 面向非程序员
• lead 主窗口始终是默认入口

6. 当前架构要点

6.1 存储

全局索引：

• D:\AI Code\Agents Team\data\db.json

项目状态：

• <项目目录>\.agents-team\workbench\project-state.json
• <项目目录>\.agents-team\workbench\mailbox.json
• <项目目录>\.agents-team\workbench\shared-memory.json
• <项目目录>\.agents-team\workbench\shared-memory.md
• <项目目录>\.agents-team\workbench\task-activity.json

6.2 角色会话

每个正式角色都有独立运行态。

当前已经支持：

• lastThreadId
• resumeCommand
• takeoverCommand
• 身份状态
• 模型覆盖
• 同步恢复入口
• 重建角色会话

6.3 模型来源

当前模型能力已经升级成：

1. 优先走 Codex app-server model/list
2. 失败时退回配置文件

所以现在页面里拿到的模型，不只是字符串列表，而是带元数据的真实可用模型集合。

7. 当前最值得继续推进的尾项

如果后面继续推进，优先顺序建议是：

1. 继续把角色长期身份往“更彻底的原生会话连续性”收口
2. 继续增强 mailbox 的超长对话摘要和冲突压缩
3. 评估页内原生终端 / 更顺手接管体验
4. 同步剩余历史文档

8. 最容易跑偏的地方

后面最容易犯的错还是这几个：

• 把它做成全局固定团队系统
• 把它做成后台管理表单页
• 先做一堆视觉炫技，主工作流反而变假
• 偷偷自动做项目摸底
• 过早把产品做成黑盒自动驾驶
• 把整个产品焊死在某个 CLI 私有实现上

9. 给后续 Codex app 的执行要求

如果后面继续用 Codex app 做：

• 默认中文输出
• 面向非程序员表达
• 没有阻塞就继续推进，不要频繁停下来问
• 优先看当前代码，不要只看历史聊天
• 修改后一定要自己验证

如果要做长任务或隐藏执行：

• 要有日志 / 输出监控
• 要能看到文件变化
• 要做阶段性验收

核心提醒：

每一步都要反问自己，这一步是不是让它更像一个真正的“项目级 lead 工作台”。