Roam Crew — Multi-Model AI Team for VS Code

在 VS Code 里组建一支由多个 AI Agent 组成的「虚拟开发团队」：每个 Agent 跑在独立 session、绑定自己的角色 / Skill / 模型，可按角色配不同的 Provider 与模型——贵的模型干脑力活、便宜的 Roam 模型干体力活，彼此还能通过消息总线交接。一个 PM Agent 作为协调者动态派活、收结果、跑验证门、驱动修复闭环。

Powered by Roam tokens.（隶属 Roam / weroam.xyz — ComputeVault OpenAI 兼容 token 网关）

这是什么


形态	VS Code 扩展（TypeScript + VS Code API）
默认后端	`OpenAICompatBackend`（进程内直连 `/v1/chat/completions`，自带工具循环 + 文件沙箱）
备用后端	`ClaudeHeadlessBackend`（spawn `claude` 无头 CLI，stream-json）
核心差异化	IDE 内 · 按角色异构 Provider/模型（成本套利）· 真正的 A2A 通信 + PM 编排 · 安全/并发内建
状态	MVP 闭环跑通；111 个单元测试全绿；Marketplace 发布前还差打包收尾（见 STATUS）

一句话价值：在 IDE 里按角色把活分派到不同模型，彼此还能交接。

快速开始

npm install
npm run build      # 编译到 out/
npm test           # 运行 Vitest（当前 111 用例）

在 VS Code 打开本项目，按 F5 启动「扩展开发宿主」窗口，Roam Crew 已激活。完整上手见 USAGE.md。

文档地图

文档分三类，对应不同的「新鲜度契约」：

📗 活文档（随代码持续更新，看这些就是最新状态）

文档	用途	读者
README.md	项目入口 + 文档地图（本文件）	所有人
USAGE.md	安装、配置、三种用法、设置/命令一览、FAQ	使用者
PRD_MultiAgent_VSCode_Extension.md	产品需求规格（含逐项实现状态、架构、ADR、威胁模型）	产品 / 开发
docs/STATUS.md	开发进展 + 下一步工作方向（唯一权威源）	开发 / 维护者
docs/AUDIT_NOTES.md	审计/Review 指南：依赖漏洞 triage（shipped vs dev）、已知限制、模块→测试地图	评审 / 审计

📘 设计文档（前瞻设计，描述「打算怎么做」，状态标记随实现推进更新）

文档	主题	落地状态
docs/MCP_Skills_Integration.md	Skill 即能力声明（段1）+ MCP 后端感知集成（段2）	段1✅ · 段2核心✅ · 收尾⬜
docs/Team_Workflow_And_Cost_Optimization.md	SDLC 阶段门 + 动态切模型 + 防上下文漂移（Team Config v2 / "req4"）	基础✅ · 动态机制⬜
docs/Settings_Panel_Design.md	混合式 Settings 面板（API Key 可见性 + MCP GUI + Agent 编辑），后端感知、默认安全	全部⬜（分散接入 P1）

📕 评审快照（时点报告，冻结不改写，最新状态以 STATUS.md 为准）

文档	评审人	基准
docs/Project_Review.md	GLM	PRD v2.2 + 代码 @ 2026-06-02
docs/PRD_vs_Implementation_Review.md	Cline	PRD v2.2 + 代码快照 @ 2026-06-02

建议阅读顺序：README → USAGE（想用）/ PRD（想懂全貌）→ STATUS（想知道现在做到哪、接下来干啥）→ 两份设计文档（想参与某个方向的实现）。评审快照是历史依据，理解「为什么下一步这么排」时回看。

仓库结构

RoamCrew/
├─ README.md                 ← 入口 + 文档地图（本文件）
├─ USAGE.md                  ← 使用文档
├─ PRD_MultiAgent_VSCode_Extension.md  ← 产品需求规格
├─ package.json              ← 扩展清单（命令 / 配置 roam.*）
├─ src/
│  ├─ extension.ts           ← 扩展入口（命令注册 + 事件布线）
│  ├─ backend/               ← AgentBackend 抽象 + OpenAICompat / ClaudeHeadless + CommandPolicy + FileCoordinator + WorkspaceTools + TeamTools
│  ├─ session/               ← SessionManager（生命周期 + 总线桥 + 路由）
│  ├─ bus/                   ← MessageBus（进程内 pub/sub）
│  ├─ workflow/              ← WorkflowEngine（线性模板）
│  ├─ roles/                 ← RoleConfig + SkillResolver（skills → allowedTools）
│  ├─ models/                ← ModelCatalog / ModelPricing / LivePriceService（成本估算）
│  ├─ mcp/                   ← MCPHub + ClaudeMcpConfig + RealMcpClient（MCP 段2）
│  ├─ secrets/ state/        ← SecretsManager / PersistenceManager
│  └─ views/                 ← Team / MessageLog / Dashboard Webview
└─ docs/                     ← STATUS + 设计文档 + 评审快照

License

MIT

Codex Release Note（2026-06-02）

Codex 已完成一轮发布硬化：MCP 授权/审批、webview CSP、.roam/team.json schema 校验、命令执行默认关闭、文件沙箱 realpath 校验、ESLint、CI、LICENSE 与 VSIX 文档白名单已落地。当前剩余发布环境事项是刷新 package-lock.json 中的 E2E devDependencies，并在可联网环境恢复 npm ci / E2E 门禁。

Roam Crew — Multi-Model AI Team

RoamAI