# 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` 动态获取，只有失败时才退回配置文件兜底。

## 本地存储现在放在哪里

全局索引只保留在：

```text
data/db.json
```

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

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

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

目前会生成这些文件：

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

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

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

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

## 还没做完的部分

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

## 运行方式

安装依赖：

```bash
npm install
```

开发模式：

```bash
npm run dev
```

构建：

```bash
npm run build
```

启动构建产物：

```bash
npm run start
```

默认地址：

```text
http://localhost:8787
```

## 当前目录结构

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

## 本轮已验证

已经实际验证过：

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

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

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