Agents Team 项目级 Lead 工作台 v1

这是一个本地优先的项目工作台。

它的核心不是“全局固定团队”，而是：

• 每个项目都有自己的 lead
• 用户默认只和这个项目的 lead 对话
• 团队先讨论出草案，再确认创建真实成员
• 正式团队变更会先给出新增 / 移出 / 调整清单，再单独确认
• 团队内正式成员可以互相直连发消息
• 默认不自动 commit / push

这版已经能做什么

• 首页查看项目列表，手动接入本地项目目录
• 新建项目时先创建一个真实 lead 运行会话
• 在项目页和 lead 对话，生成项目专属团队草案
• 确认团队后创建真实成员线程和运行态
• 任务派发、送审、打回、复审、lead 汇总
• 成员之间通过 mailbox 直接协作
• 维护共享记忆、任务活动流、人工接管记录
• 展示 Codex CLI 默认模型，并支持按会话覆盖模型
• 支持按角色同步恢复入口、重建角色会话
• 一键打开角色对应的原生 Codex 接管口

Codex CLI 集成现状

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

• lead 主对话回复
• 团队草案生成
• 成员线程回复
• 任务启动回执
• reviewer 审查接单回执
• reviewer 审查通过 / 打回结论
• 执行成员返工后的复审回执

默认模型跟随本机 Codex CLI 配置。 Web 端可以对单个角色会话临时覆盖模型，也可以切回继承默认模型。 可选模型列表现在优先通过 Codex app-server 的 model/list 动态获取，只有失败时才退回配置文件兜底。

本地存储现在放在哪里

全局索引只保留在：

data/db.json

这个文件现在只保存项目索引，不再塞整份项目运行状态。

每个项目自己的工作台数据会放到该项目目录下：

<项目目录>\.agents-team\workbench\

目前会生成这些文件：

project-state.json      项目主状态
mailbox.json            队内消息
shared-memory.json      结构化共享记忆
shared-memory.md        可直接阅读的共享记忆摘要
task-activity.json      任务活动流

这样项目级的“乱七八糟文件”都会被收口到项目自己的隐藏目录里，不会把用户项目根目录弄乱。

另外，mailbox 现在已经有服务端摘要分组：

• lead 先看摘要卡
• 原始成员往来默认折叠
• 同任务或同成员对话会自动收进同一组

还没做完的部分

• 固定角色已经支持按 thread 恢复，但还没完全做到“所有长期身份都只靠原生会话驱动”
• 页内还没有嵌入原生终端
• mailbox 目前已经可用，但“长对话自动折叠成更强摘要卡”还可以继续加强
• README 之外的设计文档还会继续补齐

运行方式

安装依赖：

npm install

开发模式：

npm run dev

构建：

npm run build

启动构建产物：

npm run start

默认地址：

http://localhost:8787

当前目录结构

server/      本地后端 API
web/         前端工作台
data/        全局项目索引
docs/        设计与交接文档

本轮已验证

已经实际验证过：

• npm run build
• 旧 data/db.json 自动迁移到项目自己的 .agents-team/workbench
• /api/health
• /api/projects
• /api/projects/:projectId

如果你正在推进这个仓库本身，直接打开当前仓库目录就能看到：

D:\AI Code\Agents Team\.agents-team\workbench