140 lines
3.5 KiB
Markdown
140 lines
3.5 KiB
Markdown
# 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
|
||
```
|