# @chorus-aidlc/chorus 中文文档 规范地址：https://npmcn.com/package/%40chorus-aidlc/chorus/ 版本：0\.24\.0 npm 元数据更新时间：2026-11-05T16:03:06.451Z 中文译文更新时间：2026-11-09T14:35:47.604Z 软件包许可：AGPL-3\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40chorus-aidlc/chorus 原文对照：https://npmcn.com/package/%40chorus-aidlc/chorus/?lang=original 项目主页：https://github.com/Chorus-AIDLC/Chorus 源码仓库：https://github.com/Chorus-AIDLC/Chorus ## 关键信息（来自 npm 元数据） - 包体积（解压后）：114 MB，2741 个文件 - TypeScript 类型：未声明 - 运行依赖：63 个 - 首次发布：2026-04-18T09:09:41.192Z - 最新版本发布：2026-11-05T16:03:06.106Z - 近 30 天下载量：4521（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：54（近 12 个月 54 个） ## 中文简介 AI-Human合作代理商——会话周期、任务状态、副代理管弦、可观察性和故障恢复 ## 安装 ```sh npm install @chorus-aidlc/chorus ``` 也可以使用：`pnpm add @chorus-aidlc/chorus`、`yarn add @chorus-aidlc/chorus`、`bun add @chorus-aidlc/chorus` ## README ![Chorus](https://npmcn.com/package/%40chorus-aidlc/chorus/packages/landing/public/images/chorus-slug.png) **你的编程 Agent 之上的 Harness：Agent 提议，人类把关，软件交付。** [English](https://npmcn.com/package/%40chorus-aidlc/chorus/README.md) · **中文** · [한국어](https://npmcn.com/package/%40chorus-aidlc/chorus/README.ko.md) · [日本語](https://npmcn.com/package/%40chorus-aidlc/chorus/README.ja.md) [**📖 文档**](https://doc.chorus-ai.dev/zh/) Chorus 是你的编程 Agent 之上的 Harness。编程 Agent 是把模型 harness 起来写代码的那层；Chorus 高它们一层，把多个这样的 Agent 和你收进同一条流水线：Agent 提议，你来验收，想法最终交付成软件，而不只是写代码。在底层，它把这套多 Agent、真人把关的协作稳稳跑起来所需的一切都处理好：会话生命周期、任务状态、子 Agent 编排、可观测性和故障恢复。每个 AI Agent 都有细粒度、可配置的权限。 受 **[AI-DLC（AI-Driven Development Lifecycle）](https://aws.amazon.com/blogs/devops/ai-driven-development-life-cycle/)** 方法论启发。核心理念：**Reversed Conversation**：AI 提议，人类验证。 * * * ## AI-DLC 工作流 ``` Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Verify ──> Done ^ ^ ^ ^ ^ ^ 人类 idea:write proposal:write task:write *:admin *:admin 提出 + 需求澄清 + 起草 PRD/任务 + 报告进度 + 验收 + 关闭 ``` 每个阶段下方标的是「执行该阶段所需的权限」，可以授予人类、Agent 或两者。没有固定角色，5 × 3 权限矩阵的任意组合都合法。→ [Agent 权限](https://doc.chorus-ai.dev/zh/guides/manage-agents/) * * * ## 最近更新 **[v0.24.0](https://chorus-ai.dev/zh/blog/chorus-v0.24.0-release/)**：把你的 Agent 按角色组成项目私有团队，产品、开发和评审分派给不同成员。评审现在跑在自己的会话里，不带开发记忆；一个 Agent 可以同时推进同一个 Idea 的多个任务；Quick Task 也能直接关联到 Idea。 **[v0.23.0](https://chorus-ai.dev/zh/blog/chorus-v0.23.0-release/)**：新增工作区本地账号管理、自定义显示名和头像。支持方案依赖校验、Pi 可选提交前检查及 Redis 共享认证限流，修复任务操作归属和重复提及通知。 **[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 安全与配置问题。 **[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 安装插件。 **[v0.21.0](https://chorus-ai.dev/zh/blog/chorus-v0.21.0-release/)**：新增私有项目与私有项目组，支持 Viewer、Editor、Admin 分级访问和实时权限继承。Agent 启动与执行失败的诊断信息会保存在会话中，同时改进 Linux daemon 持续运行并更新安全依赖。 **[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 集成。 **[v0.19.1](https://chorus-ai.dev/zh/blog/chorus-v0.19.1-release/)**：新增轻量 Research，在 Idea 澄清和 Proposal 设计时查证关键事实；行内证据引用让结论直接关联来源。开发开始前，也可从 Tracker 发起补充调查。 **[v0.19.0](https://chorus-ai.dev/zh/blog/chorus-v0.19.0-release/)**：借鉴 Cloudflare，明确 reviewer 职责、保留完整证据，用稳定 ID 逐轮追踪问题。任务审查默认检查验收标准之外的代码质量。 **[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 会话。 **[v0.17.2](https://chorus-ai.dev/zh/blog/chorus-v0.17.2-release/)** — Pi 现在可以正式安装并由 daemon 唤醒，`chorus agents run` 还能一条命令切换本地 Agent profile。 **[v0.17.0–0.17.1](https://github.com/Chorus-AIDLC/Chorus/releases/tag/v0.17.1)** — 一个 CLI 即可为各类编程 Agent 安装和更新 Chorus。现在还能在 Tracker、Graph 和 Idea 详情中直接看到 daemon 的实时活动。 > 完整更新日志：[CHANGELOG.md](https://npmcn.com/package/%40chorus-aidlc/chorus/CHANGELOG.md) * * * ## 快速开始 两条命令即可，无需数据库、无需 Docker、无需配置文件。 ```bash npm install -g @chorus-aidlc/chorus@0.21.0 chorus ``` Chorus 会自动启动内嵌 PostgreSQL (PGlite)、执行数据库迁移，然后在 **http://localhost:8637** 提供服务。默认登录账号：`admin@chorus.local` / `chorus`。 > 需要运行多个 agent，或部署到生产环境？可使用外部 PostgreSQL、Docker 或 AWS → **[部署与自托管](https://doc.chorus-ai.dev/zh/guides/deployment-overview/)**。 > 想在自己的机器上部署，或接入 Cloudflare Tunnel？参阅 **[在本机自托管](https://doc.chorus-ai.dev/zh/guides/deploy-local/)**，了解安装、局域网 HTTPS 和 Cloudflare Named Tunnel 配置。 想把本地机器变成领取任务的 agent 运行时，运行 `chorus daemon` → **[Daemon 运维](https://doc.chorus-ai.dev/zh/guides/daemon-operations/)** · **[远程控制](https://doc.chorus-ai.dev/zh/guides/remote-control/)**。 ### 升级 CLI 和插件 ```bash chorus upgrade # 仅升级 CLI；chorus update 为同义命令 chorus upgrade --plugins # 同时刷新已配置 Agent 的 Chorus 插件 ``` 自升级支持 Linux、macOS 和 Windows 上当前使用的 **npm 全局安装**：检查 npm prefix、查询最新稳定版本、避免降级，并在安装后验证版本。源码目录、链接、npx 和其他包管理器安装请使用各自的更新方式。CLI 检查、安装或版本验证失败后，不会继续更新插件。 `--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 接入](https://npmcn.com/package/%40chorus-aidlc/chorus/docs/CONNECT_PI.md)。 命令非交互执行并逐项汇总。退出码 **0** 表示请求全部完成（配置不存在或为空也算成功）；**1** 表示失败或未全部完成，包括 offline、未知或缺少类型的记录、宿主缺失及不支持定向更新。单个插件失败不影响后续目标，已完成的变更不回滚。更新后请开启新的 Agent 会话，并在方便时重启 daemon；命令本身不会重启进程或中断现有会话。 npm 安装过程不设置自动超时或强制终止，会持续显示脱敏进度直到退出；查询仍保留超时。失败会显示脱敏原因和退出状态，权限问题会提示使用 nvm 等用户级 Node 安装。配置备份使用固定的 `.chorus-upgrade.bak` 文件，下次升级时替换，避免堆积。 * * * ## 界面预览 ### 远程唤醒 Agent：派活到指定目录，实时看它跑 ![远程唤醒 Agent](https://npmcn.com/package/%40chorus-aidlc/chorus/packages/landing/public/images/agent-daemon-wake.gif) 把一条想法派给远程 Agent 的某个目录，打开对话窗口，就能实时看到本地的 Claude Code 接活、开跑，全程不用碰终端，也不用手动 resume。 ### 项目资源图谱：整个项目一张实时思维导图 ![项目资源图谱](https://npmcn.com/package/%40chorus-aidlc/chorus/packages/landing/public/images/mind-map.png) 想法、提案、文档、任务连成一棵树，每张卡片的状态随着 Agent 工作实时更新。 ### Proposal：AI Agent 实时生成计划 ![Proposal Presence](https://npmcn.com/package/%40chorus-aidlc/chorus/packages/landing/public/images/proposal-presence.gif) PM Agent 分析需求并实时生成包含 PRD 和任务 DAG 的提案，Presence 指示器实时显示 Agent 活动状态。 ### Kanban：任务状态实时流转 ![Kanban Presence](https://npmcn.com/package/%40chorus-aidlc/chorus/packages/landing/public/images/kanban-presence.gif) Kanban 看板随 Agent 工作进度自动更新，任务卡片在 To Do → In Progress → To Verify 之间实时流转。Presence 指示器高亮显示正在被操作的资源。 * * * ## 连接 Agent 最快的方式是应用内的 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](https://npmcn.com/package/%40chorus-aidlc/chorus/docs/CONNECT_TRAE.zh.md)。 按客户端分的完整接入指南 → **[Agent 接入平台](https://doc.chorus-ai.dev/zh/reference/agents/)**。 在 **Settings → Agents → Create API Key** 创建 API Key。Key 以 `cho_` 开头，仅在创建时显示一次。 * * * ## 技术栈 | 组件 | 技术 | | --- | --- | | 框架 | Next.js 15 (App Router, Turbopack) | | 语言 | TypeScript 5 (strict mode) | | 前端 | React 19, Tailwind CSS 4, shadcn/ui | | 数据 | PostgreSQL 17 + Prisma 7, Redis 7（可选） | | Agent 集成 | MCP SDK (HTTP Streamable Transport) | | 认证 | OIDC + PKCE / API Key / SuperAdmin | | i18n | next-intl (en, zh, ko, ja) | | 部署 | npm / Docker / AWS CDK | * * * ## 文档 **📖 完整文档：[doc.chorus-ai.dev](https://doc.chorus-ai.dev/zh/)** - [快速上手](https://doc.chorus-ai.dev/zh/guides/getting-started/) - [连接 agent](https://doc.chorus-ai.dev/zh/reference/agents/) - [AI-DLC 工作流](https://doc.chorus-ai.dev/zh/guides/ai-dlc-workflow/) - [插件与命令](https://doc.chorus-ai.dev/zh/guides/plugin-commands/) - [MCP 工具参考](https://doc.chorus-ai.dev/zh/reference/mcp-tools/) - [部署与自托管](https://doc.chorus-ai.dev/zh/guides/deployment-overview/) - [本机自托管与 Cloudflare Tunnel](https://doc.chorus-ai.dev/zh/guides/deploy-local/) * * * ## License AGPL-3.0 — see [LICENSE.txt](https://npmcn.com/package/%40chorus-aidlc/chorus/LICENSE.txt) ## 常见问题 ### @chorus-aidlc/chorus 是什么？ AI-Human合作代理商——会话周期、任务状态、副代理管弦、可观察性和故障恢复 ### 如何安装 @chorus-aidlc/chorus？ 在项目目录运行 npm install @chorus-aidlc/chorus，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 chorus，可以用 npx chorus 直接运行。 ### @chorus-aidlc/chorus 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chorus-aidlc\_\_chorus 是否存在。 ### @chorus-aidlc/chorus 可以商用吗？ @chorus-aidlc/chorus 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。 ### @chorus-aidlc/chorus 的下载量有多少？ 根据 npm 官方下载统计，@chorus-aidlc/chorus 在 2026/10/10 – 2026/11/08 这 30 天内被下载 4,521 次，日均约 151 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @chorus-aidlc/chorus 还在维护吗？ 最新版本 0\.24\.0 发布于 2026/11/06（3 天前）；至今共发布 54 个版本，其中过去 12 个月发布了 54 个；首次发布于 2026/04/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。