Agents_Team/README.md
2026-03-16 15:22:39 +08:00

140 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```