# 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 工作台”。