![\"Chorus\"](\"packages/landing/public/images/chorus-slug.png\")
\n\n \n
你的编程 Agent 之上的 Harness：Agent 提议，人类把关，软件交付。
\n\n\n\n\n\nChorus 是你的编程 Agent 之上的 Harness。编程 Agent 是把模型 harness 起来写代码的那层；Chorus 高它们一层，把多个这样的 Agent 和你收进同一条流水线：Agent 提议，你来验收，想法最终交付成软件，而不只是写代码。在底层，它把这套多 Agent、真人把关的协作稳稳跑起来所需的一切都处理好：会话生命周期、任务状态、子 Agent 编排、可观测性和故障恢复。每个 AI Agent 都有细粒度、可配置的权限。\n\n受 **[AI-DLC（AI-Driven Development Lifecycle）](https://aws.amazon.com/blogs/devops/ai-driven-development-life-cycle/)** 方法论启发。核心理念：**Reversed Conversation**：AI 提议，人类验证。\n\n---\n\n## AI-DLC 工作流\n\n```\nIdea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Verify ──> Done\n ^ ^ ^ ^ ^ ^\n人类 idea:write proposal:write task:write *:admin *:admin\n提出 + 需求澄清 + 起草 PRD/任务 + 报告进度 + 验收 + 关闭\n```\n\n每个阶段下方标的是「执行该阶段所需的权限」，可以授予人类、Agent 或两者。没有固定角色，5 × 3 权限矩阵的任意组合都合法。→ [Agent 权限](https://doc.chorus-ai.dev/zh/guides/manage-agents/)\n\n---\n\n## 最近更新\n\n**[v0.23.0](https://chorus-ai.dev/zh/blog/chorus-v0.23.0-release/)**：新增工作区本地账号管理、自定义显示名和头像。支持方案依赖校验、Pi 可选提交前检查及 Redis 共享认证限流，修复任务操作归属和重复提及通知。\n\n**[v0.22.2](https://chorus-ai.dev/zh/blog/chorus-v0.22.2-release/)**：支持在 Linux 或 macOS 主机上通过 Docker Compose 和 PostgreSQL 17 托管 Chorus，提供可重复部署、可选的局域网 HTTPS 和 Cloudflare Tunnel 接入指南。新增 TRAE CLI 后端，共用 Codex 插件参与现有工作流，并修复失效指派、删除失败及 daemon 安全与配置问题。\n\n**[v0.22.0](https://chorus-ai.dev/zh/blog/chorus-v0.22.0-release/)**：新增 Hermes Agent 接入，通过自身 gateway 参与 Chorus 现有工作流，无需另起 Chorus daemon。在 Chorus 分配工作，由 Hermes 执行，结果与审批请求回到项目中。支持通过 Chorus CLI 或直接使用 Hermes 安装插件。\n\n**[v0.21.0](https://chorus-ai.dev/zh/blog/chorus-v0.21.0-release/)**：新增私有项目与私有项目组，支持 Viewer、Editor、Admin 分级访问和实时权限继承。Agent 启动与执行失败的诊断信息会保存在会话中，同时改进 Linux daemon 持续运行并更新安全依赖。\n\n**[v0.20.0](https://chorus-ai.dev/zh/blog/chorus-v0.20.0-release/)**：daemon 后端改用 Codex App Server、Claude Code 双向 stream-json 和 Pi 原生 RPC，通过协议处理中断与执行状态。新增 `chorus upgrade`，支持 npm 全局安装的 CLI 自升级；加上 `--plugins` 可刷新已配置的 Claude Code、Codex、Kiro 和 Pi 集成。\n\n**[v0.19.1](https://chorus-ai.dev/zh/blog/chorus-v0.19.1-release/)**：新增轻量 Research，在 Idea 澄清和 Proposal 设计时查证关键事实；行内证据引用让结论直接关联来源。开发开始前，也可从 Tracker 发起补充调查。\n\n**[v0.19.0](https://chorus-ai.dev/zh/blog/chorus-v0.19.0-release/)**：借鉴 Cloudflare，明确 reviewer 职责、保留完整证据，用稳定 ID 逐轮追踪问题。任务审查默认检查验收标准之外的代码质量。\n\n**[v0.18.0](https://chorus-ai.dev/zh/blog/chorus-v0.18.0-release/)** — 内置 `spec-lite`，作为 OpenSpec 之外更轻量、可直接进 Git 的本地 Spec 管理方案。live session anchor 让 daemon Agent 的回复回到发起者已有的 Idea 会话。\n\n**[v0.17.2](https://chorus-ai.dev/zh/blog/chorus-v0.17.2-release/)** — Pi 现在可以正式安装并由 daemon 唤醒，`chorus agents run` 还能一条命令切换本地 Agent profile。\n\n**[v0.17.0–0.17.1](https://github.com/Chorus-AIDLC/Chorus/releases/tag/v0.17.1)** — 一个 CLI 即可为各类编程 Agent 安装和更新 Chorus。现在还能在 Tracker、Graph 和 Idea 详情中直接看到 daemon 的实时活动。\n\n> 完整更新日志：[CHANGELOG.md](CHANGELOG.md)\n\n---\n\n## 快速开始\n\n两条命令即可，无需数据库、无需 Docker、无需配置文件。\n\n```bash\nnpm install -g @chorus-aidlc/chorus@0.21.0\nchorus\n```\n\nChorus 会自动启动内嵌 PostgreSQL (PGlite)、执行数据库迁移，然后在 **http://localhost:8637** 提供服务。默认登录账号：`admin@chorus.local` / `chorus`。\n\n> 需要运行多个 agent，或部署到生产环境？可使用外部 PostgreSQL、Docker 或 AWS → **[部署与自托管](https://doc.chorus-ai.dev/zh/guides/deployment-overview/)**。\n\n> 想在自己的机器上部署，或接入 Cloudflare Tunnel？参阅 **[在本机自托管](https://doc.chorus-ai.dev/zh/guides/deploy-local/)**，了解安装、局域网 HTTPS 和 Cloudflare Named Tunnel 配置。\n\n想把本地机器变成领取任务的 agent 运行时，运行 `chorus daemon` → **[Daemon 运维](https://doc.chorus-ai.dev/zh/guides/daemon-operations/)** · **[远程控制](https://doc.chorus-ai.dev/zh/guides/remote-control/)**。\n\n### 升级 CLI 和插件\n\n```bash\nchorus upgrade # 仅升级 CLI；chorus update 为同义命令\nchorus upgrade --plugins # 同时刷新已配置 Agent 的 Chorus 插件\n```\n\n自升级支持 Linux、macOS 和 Windows 上当前使用的 **npm 全局安装**：检查 npm prefix、查询最新稳定版本、避免降级，并在安装后验证版本。源码目录、链接、npx 和其他包管理器安装请使用各自的更新方式。CLI 检查、安装或版本验证失败后，不会继续更新插件。\n\n`--plugins` 读取 `~/.chorus/daemon.json`，兼容旧版单 Agent 配置。明确指定 Claude Code、Codex、TRAE CLI、Kiro、Pi 类型的记录都会处理，不受唤醒开关影响；按每条记录的 home、配置目录和 PATH 定位宿主，共享目标只更新一次。仅刷新 Chorus 及必需的集成依赖，保留已有凭证和无关设置，不安装宿主 CLI。Kiro 模板来自记录配置的 Chorus 实例（以该实例提供的版本为准，可能落后于 npm），共享目录对应不同实例时报告冲突。稳定版 Pi >=0.99.0 <2.0.0 使用原生 MCP，仅定向更新 Chorus；Pi 0.84.4–0.98.x 保留已验证的 `pi-mcp-adapter@5.0.0` 策略固定版本。未知版本不操作 adapter、不宣称 MCP 已完成；不支持的宿主不执行包命令。只做定向更新，绝不更新全部扩展；缺少能力或约束不兼容时报告未完成。保留用户 pins/ranges（验证过的 adapter 固定版本是预期策略，不算刷新未完成）。原生宿主已有 adapter 或 `-builtin:mcp` 时仅按作用域提示手动迁移，不自动卸载或改设置。详见 [Pi 接入](docs/CONNECT_PI.md)。\n\n命令非交互执行并逐项汇总。退出码 **0** 表示请求全部完成（配置不存在或为空也算成功）；**1** 表示失败或未全部完成，包括 offline、未知或缺少类型的记录、宿主缺失及不支持定向更新。单个插件失败不影响后续目标，已完成的变更不回滚。更新后请开启新的 Agent 会话，并在方便时重启 daemon；命令本身不会重启进程或中断现有会话。\n\nnpm 安装过程不设置自动超时或强制终止，会持续显示脱敏进度直到退出；查询仍保留超时。失败会显示脱敏原因和退出状态，权限问题会提示使用 nvm 等用户级 Node 安装。配置备份使用固定的 `.chorus-upgrade.bak` 文件，下次升级时替换，避免堆积。\n\n---\n\n## 界面预览\n\n### 远程唤醒 Agent：派活到指定目录，实时看它跑\n\n\n\n把一条想法派给远程 Agent 的某个目录，打开对话窗口，就能实时看到本地的 Claude Code 接活、开跑，全程不用碰终端，也不用手动 resume。\n\n### 项目资源图谱：整个项目一张实时思维导图\n\n\n\n想法、提案、文档、任务连成一棵树，每张卡片的状态随着 Agent 工作实时更新。\n\n### Proposal：AI Agent 实时生成计划\n\n\n\nPM Agent 分析需求并实时生成包含 PRD 和任务 DAG 的提案，Presence 指示器实时显示 Agent 活动状态。\n\n### Kanban：任务状态实时流转\n\n\n\nKanban 看板随 Agent 工作进度自动更新，任务卡片在 To Do → In Progress → To Verify 之间实时流转。Presence 指示器高亮显示正在被操作的资源。\n\n---\n\n## 连接 Agent\n\n最快的方式是应用内的 setup 向导：打开 **Settings → Setup Guide**。它会创建 API Key，并给出适配你所用客户端的完整命令，无论是 Claude Code、Codex、TRAE CLI、Kiro、dsh、OpenCode、OpenClaw、Pi、Hermes，还是任何兼容 MCP 的 agent。TRAE CLI 接入说明：[docs/CONNECT_TRAE.zh.md](docs/CONNECT_TRAE.zh.md)。\n\n按客户端分的完整接入指南 → **[Agent 接入平台](https://doc.chorus-ai.dev/zh/reference/agents/)**。\n\n在 **Settings → Agents → Create API Key** 创建 API Key。Key 以 `cho_` 开头，仅在创建时显示一次。\n\n---\n\n## 技术栈\n\n| 组件 | 技术 |\n|------|------|\n| 框架 | Next.js 15 (App Router, Turbopack) |\n| 语言 | TypeScript 5 (strict mode) |\n| 前端 | React 19, Tailwind CSS 4, shadcn/ui |\n| 数据 | PostgreSQL 17 + Prisma 7, Redis 7（可选） |\n| Agent 集成 | MCP SDK (HTTP Streamable Transport) |\n| 认证 | OIDC + PKCE / API Key / SuperAdmin |\n| i18n | next-intl (en, zh, ko, ja) |\n| 部署 | npm / Docker / AWS CDK |\n\n---\n\n## 文档\n\n**📖 完整文档：[doc.chorus-ai.dev](https://doc.chorus-ai.dev/zh/)**\n\n- [快速上手](https://doc.chorus-ai.dev/zh/guides/getting-started/)\n- [连接 agent](https://doc.chorus-ai.dev/zh/reference/agents/)\n- [AI-DLC 工作流](https://doc.chorus-ai.dev/zh/guides/ai-dlc-workflow/)\n- [插件与命令](https://doc.chorus-ai.dev/zh/guides/plugin-commands/)\n- [MCP 工具参考](https://doc.chorus-ai.dev/zh/reference/mcp-tools/)\n- [部署与自托管](https://doc.chorus-ai.dev/zh/guides/deployment-overview/)\n- [本机自托管与 Cloudflare Tunnel](https://doc.chorus-ai.dev/zh/guides/deploy-local/)\n\n---\n\n## License\n\nAGPL-3.0 — see [LICENSE.txt](LICENSE.txt)\n","readmeFilename":"README.zh.md"}