# Agent Team — 开发进度

**最后更新**: 2026-03-04
**仓库**: https://gitea.catter.cn/sdaduanbilei/agent-team.git

---

## 已完成

### Go 后端
- [x] `go.mod` 初始化，依赖已锁定（Go 1.20 兼容版本）
- [x] `internal/llm/client.go` — OpenAI 兼容客户端，支持 DeepSeek/Kimi/Ollama/OpenAI，流式输出
- [x] `internal/agent/agent.go` — AGENT.md frontmatter 解析，SOUL.md 加载，memory 读写，system prompt 构建
- [x] `internal/skill/skill.go` — agentskills.io 标准，skill 发现/加载/XML 生成
- [x] `internal/room/room.go` — 群配置加载，master orchestration 循环，消息历史持久化，memory 自动更新
- [x] `internal/hub/hub.go` — GitHub repo clone，团队包安装
- [x] `internal/api/server.go` — Echo HTTP 服务，WebSocket hub，全部 REST 接口（含 skill 创建、workspace 文件预览、消息历史）
- [x] `cmd/server/main.go` — 入口

### React 前端
- [x] Vite + React + TypeScript + Tailwind v4
- [x] `web/src/types.ts` + `store.ts` — 类型定义，Zustand store，WebSocket 流式消息
- [x] `App.tsx` — 四栏导航（群聊/Agents/Skills/市场）
- [x] `RoomSidebar.tsx` — 群列表，实时状态，创建群（agent 下拉多选）
- [x] `ChatView.tsx` — 消息流，右侧面板，workspace 文件预览 Modal
- [x] `AgentsPage.tsx` — Monaco MD 编辑器，AGENT.md/SOUL.md 编辑
- [x] `SkillsPage.tsx` — skill 列表，详情查看，新建 skill
- [x] `MarketPage.tsx` — GitHub 一键雇佣，发布说明

### 构建验证
- [x] `go build ./...` 通过
- [x] `npm run build` 通过（386KB JS bundle）

---

## 待完成

### 下次开始（优先级高）

- [ ] **Leader 群 orchestration** — 目前 room.go 的 Handle 只支持单 master，Leader 群需要广播给多个 master
  - Leader 群：用户消息广播给所有 master，每个 master 在自己的部门群里处理
  - 需要在 Room 结构里区分 TypeLeader，Handle 时遍历所有 master

- [ ] **环境变量配置页** — 前端提供设置页，配置各 provider 的 API Key
  - 新增 `web/src/components/SettingsPage.tsx`
  - 后端 `PUT /api/config` 写入 `.env` 文件，启动时 `godotenv` 加载

- [ ] **实际测试** — 配置真实 DeepSeek API Key 跑通一次完整流程
  ```bash
  export DEEPSEEK_API_KEY=your_key
  go run cmd/server/main.go
  # 另一个终端
  cd web && npm run dev
  ```

### 后续迭代

- [ ] Skill 脚本执行沙箱（scripts/ 目录下的脚本安全执行）
- [ ] 用户认证
- [ ] 消息搜索

---

## 环境要求

| 工具 | 版本 |
|------|------|
| Go | 1.20+ |
| Node.js | 18+ |
| git | 任意 |

## 启动方式

```bash
# 后端
export DEEPSEEK_API_KEY=your_key
go run cmd/server/main.go

# 前端（另一个终端）
cd web
npm install
npm run dev
# 访问 http://localhost:5173
```

## 关键设计决策（供参考）

1. **一切皆 MD** — agent 配置、soul、memory、tasks、history 全部是 MD 文件，无数据库
2. **Context 隔离** — 每个 agent 的 LLM 调用独立，master 只看摘要，子 agent 只看自己的任务
3. **agentskills.io 标准** — skill 格式遵循开放标准，可复用社区 skill
4. **OpenAI 兼容接口** — 所有 provider 统一用 go-openai，只改 BaseURL
5. **去中心化 Hub** — 团队包就是 GitHub repo，topic `agent-team` 聚合发现

## 用户问题备忘

> "导演 agent 会不会忘记之前的内容？"

**答**：不会忘，通过两个机制保证：
1. **任务内 context**：整个 orchestration 循环（分配→执行→review）是同一个 `masterMsgs` 数组，导演始终看到完整对话
2. **跨任务 memory**：任务完成后经验写入 `agents/director/memory/`，下次任务时注入 system prompt

导演的 identity（SOUL.md）永远不变，memory 会随经验积累越来越丰富。