# @bex-co/muse-code-acp 中文文档 规范地址：https://npmcn.com/package/%40bex-co/muse-code-acp/ 版本：0\.11\.0 npm 元数据更新时间：2026-10-26T08:32:23.624Z 中文译文更新时间：2026-11-08T00:32:42.780Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40bex-co/muse-code-acp 原文对照：https://npmcn.com/package/%40bex-co/muse-code-acp/?lang=original 项目主页：https://github.com/bex-co/muse-code-acp#readme 源码仓库：https://github.com/bex-co/muse-code-acp ## 关键信息（来自 npm 元数据） - 包体积（解压后）：859 kB，225 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22 - 运行依赖：3 个 - 首次发布：2026-08-27T08:38:05.847Z - 最新版本发布：2026-10-26T08:32:23.169Z - 近 30 天下载量：4735（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：13（近 12 个月 13 个） ## 中文简介 由Muse Code(Meta's muse CLI的非官方适配器)提供动力的ACP兼容编码代理 ## 安装 ```sh npm install @bex-co/muse-code-acp ``` 也可以使用：`pnpm add @bex-co/muse-code-acp`、`yarn add @bex-co/muse-code-acp`、`bun add @bex-co/muse-code-acp` ## README ![muse-code-acp — Muse Code for any ACP client](https://npmcn.com/package/%40bex-co/muse-code-acp/.github/social-preview.webp) # 使用 Zed 内部的 Muse 代码, 以及任何 ACP 编辑器 **`muse-code-acp`** 连接 [密码](https://dev.meta.ai/docs/muse-code/) 改为 [代理客户协议( ACP)](https://agentclientprotocol.com/) 客户喜欢 **齐德** 财务报告和审定财务报表 **具有非加太扩展的VS代码**,所以您可以得到流化的工具呼叫,编辑本地权限,计划模式,会话,MCP,和斜线命令工作流程——而不离开您的编辑器. [![npm version](https://img.shields.io/npm/v/@bex-co/muse-code-acp)](https://www.npmjs.com/package/@bex-co/muse-code-acp) [![npm downloads](https://img.shields.io/npm/dm/@bex-co/muse-code-acp)](https://www.npmjs.com/package/@bex-co/muse-code-acp) [![CI](https://github.com/bex-co/muse-code-acp/actions/workflows/ci.yml/badge.svg)](https://github.com/bex-co/muse-code-acp/actions/workflows/ci.yml) [![License: Apache-2.0](https://img.shields.io/github/license/bex-co/muse-code-acp)](https://npmcn.com/package/%40bex-co/muse-code-acp/LICENSE) [![Node 22+](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://npmcn.com/package/%40bex-co/muse-code-acp/package.json) [**QQ 快速启动**](https://npmcn.com/package/%40bex-co/muse-code-acp/#readme-quickstart) • 妇女 [**\* 特性**](https://npmcn.com/package/%40bex-co/muse-code-acp/#readme-features) • 妇女 [**如何运作**](https://npmcn.com/package/%40bex-co/muse-code-acp/#readme-how-it-works) • 妇女 [**医生**](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/capability-audit.md) • 妇女 [**GitHub 上的"星"("星")**](https://github.com/bex-co/muse-code-acp) ```sh npm install -g @bex-co/muse-code-acp ``` > **非官方适配器.** Muse Code和Muse Spark是Meta平台股份有限公司的产品. 这个社区项目与Meta没有关联,也没有得到它的认可或支持. 您单独安装 Muse —— 此软件包不捆绑 Muse 可执行文件 . * * * ## 为什么开发者使用它 编码代理只有在实际写出代码时才有用. `muse-code-acp` 把Muse带入编辑器表面ACP的设计目的是: - **留在编辑室** – 流回音,工具调用,diffs,和许可提示在Zed/你的ACP客户端中本地化而成,而不是在单独的终端UI中. - **继续控制** ——默认,只读,并被守护的"计划"模式;每个批准都是通过ACP进行的主机选择,在被取消或被搁置的答复时未能关闭. - **继续开会** ——列表,装入完整历史,不重复播放而恢复,关闭,以及来自客户端的本土分叉Muse会话. - **带上工具** ——客户端提供的MCP服务器(stdio + HTTP),图像和嵌入上下文,模型切换,技能,规划,Git评论,和目标. - **相信什么已经核实** ——行为被固定在一个经过核实的Muse主机上,包含在决定性的合同测试中加上CI中所需的真主机回放套房. 界限在下面清楚说明,从不隐藏. > ⭐ **如果这样可以节省你的时间, 将重播** 它帮助其他ACP+Muse用户找到它 [打开一个问题](https://github.com/bex-co/muse-code-acp/issues) 使用编辑器 + Muse 版本,当某事中断时. ## 你得到的东西 在默认 SDK 后端与已核实的主机 : | 你会得到 | 细节 | | --- | --- | | • 流线代理 | 文本、工具呼叫/结果、取消、多回合连续性 | | 丰富背景 | PNG/JPEG/GIF/WebP 图像,资源链接,嵌入式文本(自动/二进制资源不支持) | | 🧭会 | 排列列表, 完整历史负载, 不重放的恢复, 关闭, 本地叉 | | QQ 权限 | 通过非加太公司提供的互动主机选择;取消/出售答复失败 | | QQ 模式( M) | 默认/ 只读/ 计划; 提供者和配置合格模式目录, `/models` 刷新已核实的闲置模式切换 | | \* | 客户端 stdio + HTTP 服务器,带有本地配置/最后故障诊断 | | 文件更改 | 已观察到的受约束的diffs;可选的谈判报告标出部分覆盖面 | | \* 斜线工作流程 | 作为斜线命令的技巧, `/plan`, (中文(简体) ), `/review`目标,以及更多(以下) | | 目标 | 目标状况;本地 `/goal set|edit|pause|resume|clear` 关于Muse 1.4.6+ | | 中间方向 | 当客户明确谈判时 | ### 需要先尝试的斜线命令 斜线命令可以在任何上层文本块中与编辑器上下文并列出现. | 命令 | 试试看 | | --- | --- | | `/plan ` | 守备规划第一; `/plan` 单启用计划模式而不开始 | | `/review ` | 带有焦点指示的 Git 审查; 附件保存 | | `/goal ` | 执行一次任务; `/goal set ` 长期本土目标(1.4.6+) | | `/models` | 在转弯前刷新模型目录 | | `/recap` • 妇女 `/rename` | 土著会话在Muse 1.4.7+上重现/重命名 | | `/compact` | Muse 1.4.12+上的土著环境收缩 | | `/skills` • 妇女 `/plugins` • 妇女 `/hooks` | 检查、启用/残疾和导入技能;列表/安装插件(1.4.7+) | | `/status` • 妇女 `/mcp ` | 会话+订阅使用; MCP 诊断结合正常任务 | | `/feedback bug|bad|good|other ` | 向 Muse 发送反馈( 仅使用 `--with-session`(中文(简体) ) | **完整斜线命令注释** 在Muse 1.4.7或更新, `/recap` 要求Muse对会议作简短的回顾(一种没有增加历史内容的副调用模式)和 `/rename` 还设置了Muse自己的会话名. `/skills enable|disable ` 改变技能的激活范围 从它产生, `/skills import claude|codex` 导入外国技能的预览( e)`--apply` 进口),以及 `/feedback bug|bad|good|other ` 将反馈发送给未附加文件的Muse( 会话记录仅使用 `--with-session`) (中文(简体) ). `/status` 也显示Muse在Muse报告时自己的订阅用法. 在Muse 1.4.12或更新, `/compact` 请 Muse 压缩会议背景并报告结果(客户广告) `session.compaction` 也得到标准的收缩更新; Muse 的拒绝被逐字报告. `/plugins` 财务报告和审定财务报表 `/hooks` 列表已安装的 Muse 插件和钩子,以及 `/plugins install ` 安装本地插件,仅在此明确命令上. 规划和审查保留附件. `/goal ` \* 执行一次任务而不设定目标; `/goal set `, (中文(简体) ), `edit`, (中文(简体) ), `pause`, (中文(简体) ), `resume` 财务报告和审定财务报表 `clear` 控制Muse在Muse 1.4.6或较新的原生目标(见 [目标控制](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/goal-extension.md#native-goal-controls)) (中文(简体) ). 本地状态查询不向一个模型发送附件;在状态回复后处理额外的明确任务. `/mcp ` 结合本地诊断和当前模式中的正常任务,而不声称本地MCP控制. > **诚实的限制 :** 授权工人和象征性用途被报告为无法使用。 说明理由摘要,编辑-侧文件系统代理,多个授权的工作空间根,以及本地会话删除未执行. 闭幕会议保留了会议的历史。 这个适配器不执行Muse终端UI的每个ACP特性或每个特性. 可用的功能也取决于您的 ACP 客户端. ## QQ快起步——约60秒 **先决条件** - [ ] **节点.js 22+** - [ ] **Muse码1.1.1-R2514.1** (核实主机,单独安装,与 `muse serve`)——最新的Muse安装器可能安装了不同的版本,因此将二进制与 `MUSE_CODE_EXECUTABLE` (见 [兼容性](https://npmcn.com/package/%40bex-co/muse-code-acp/#readme-compatibility)(中文(简体) ) - [ ] 通过浏览器登录 Muse auth **或者说** `META_API_KEY` ```sh export MUSE_CODE_EXECUTABLE="/absolute/path/to/muse-1.1.1" "$MUSE_CODE_EXECUTABLE" --version "$MUSE_CODE_EXECUTABLE" serve --help "$MUSE_CODE_EXECUTABLE" login npm install -g @bex-co/muse-code-acp muse-code-acp --version ``` 用于无头用途,提供 `META_API_KEY` ,而不是浏览器登录。 适配器会说ACP over stdio——通过你的编辑器推出,而不是作为交互式终端聊天. ### 齐德 添加一个 [自定义外部代理](https://zed.dev/docs/ai/external-agents#custom-agents) ,替换 Muse 路径 : ```json { "agent_servers": { "Muse Code": { "type": "custom", "command": "muse-code-acp", "args": [], "env": { "MUSE_CODE_EXECUTABLE": "/absolute/path/to/muse-1.1.1" } } } } ``` 然后选择 **密码** 在Zed的代理小组中发送您的第一个提示——尝试 `/plan explain this repo` 将“计划”模式付诸行动. > **Tip – GUI 应用程序不会继承您的外壳.** 设定 `MUSE_CODE_EXECUTABLE` (和 `META_API_KEY`,如果使用)在编辑器配置中,即使您在终端中导出它们。 如果泽德找不到 `muse-code-acp`,将其绝对路径作为 `command`;节点也必须提供给编辑. **其他非加太客户** 使用同样的 `command` 财务报告和审定财务报表 `env`。浏览器登录到客户端需要终端-自动支持;否则会事先认证. ## 如何运作 ```text Zed / VS Code (ACP client) ↕ ACP over stdio muse-code-acp (this adapter) ↕ official Muse SDK (@muse-code/sdk, pinned) muse serve (MSP) → native sessions, tools, sandbox, models ``` 官员 [缪斯 SDK](https://github.com/meta-models/muse-code-sdk) 与 `muse serve` 超过MSP。 适配器开始或恢复本地会话,将消息/工具项目翻译为ACP更新,向客户端请求路由许可,并使用 `turn/cancel`原生处决、模式获取、持久性和沙箱制仍然是Muse所有. - **模式,同步的两个方式.** 模式选择通过 ACP 配置选项和遗留会话-模式界面工作; 改变或保持同步,以及 `/plan` 更新模式选择器。 SDK会话提供默认,只读,和计划. 这些不是Codex的"Approve for me"或"Full access"的预设——在被支持的主机上没有验证本地自动批准(`allowAll` 在孤立的测试中被接受,但外壳写作仍然需要决定。 其余的审批是转交的,从未自动批准. - **会话主持人.** 每个SDK会话可以保留其主机跨相容转折. Idle主机在60秒后到期;会话关闭也会释放它们. 在将本地对话移到另一个客户端之前关闭一个会话 。 公开上市 `session/list` 带有有界限的 pagination; 完整历史重放使用验证 `muse export`; 仅读存储帮助器仍然用于兼容性检查和标题倒置. 索引最终是一致的,因此新会话可能不会立即出现. **允许深潜:多阶段批准、摊位和会话状态** 一个 shell 命令需要不止一个批准: Muse 将一个复合命令分割为几个阶段,并询问每个未知的安全性. 适配器从主机最新公布的要求中决定每个阶段,因此一个工具调用每个未解决的阶段产生一个许可请求并只在最后决定后运行. 拒绝任何阶段都会取消整个命令. 只有提供主机的选择才能提交。 每个多阶段的提示显示当前阶段主机公布的论点和立场,例如: `Stage 3 of 4: echo two`即使没有Muse的扩展。 总共包括已知的安全阶段,而不仅仅是对话。 请求中保留了完整的命令;适配器不分析shell文本来发明一个相位. 单阶段提示保留了现有的标题. 如果主机停止在请求上取得进展,适配器欠它一个答案,则转会失败 `MUSE_CODE_ACP_STALL_MS` 而不是无限期等待。 客户还收到 `muse/hostCompatibility` 开始 `session_info_update` 每个主机一次,携带被钉住的并服务到的图案指纹和被检测到的主机版本;不匹配是建议,从不屏蔽会话. 客户可以选择加入 `muse/sessionState` 接受观察的东道主模式和核准模式的修改,加上经核实或明确未核实的持久规则结果。 这些报告并不改变非加太的配置或许可政策。 见 [已观测到会话状态](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/sdk-migration.md#observed-session-state-w2006)。 。 。 . **批准和沙盒控制** SDK 软件 `bypassApprovals` 自动选择所有阶段经批准后才提供的主机,没有非加太对话或持续的赠款. `rejectApprovals` 拒绝使用一次性拒绝选择的待发提示;已知的安全工具仍然可以运行。 这两项工作都涉及Muse 1.1.1和1.2.1。 选择其中之一 `session/set_mode` 或者说 `session/set_config_option` 与 `configId: "mode"`。 。 。 . 选择单独的 SDK 配置选项 `nativeApprovalPolicy`, (中文(简体) ), `sandbox`, (中文(简体) ), `sandboxNetwork`, (中文(简体) ), `workspaceWrite` 财务报告和审定财务报表 `shell`默认值 `onRequest`,已启用 sandbox, 仅启用代理网络、 写入和 shell 。 当地非违约政策要求Muse 1.2.1+;一旦在1.1.1上作出裁决,没有这些政策就自动生效。 使沙盒失效还需要 `MUSE_CODE_ACP_ALLOW_YOLO=1`。没有 SDK 选项默认信任工作空间规则. 更改需要空闲会话并替换保留的主机 。 装入/重置恢复已验证的首选项; 三叉重置安全设置和模式 。 见 [政策矩阵和平台限制](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/sdk-migration.md#approval-and-sandbox-settings)。 。 。 . **遗产执行后端( 回滚)** ```sh MUSE_CODE_ACP_BACKEND=exec muse-code-acp ``` 遗留后端运行 `muse exec --json` 每个转弯。 它支持回声提供者,使用基于存储的会话列表,并且只接受stdio MCP服务器. 批准在Muse内部解决,而不是通过ACP互动许可解决。 默认、只读和绕行核准模式可供使用; 广告yolo需要 `MUSE_CODE_ACP_ALLOW_YOLO=1`。 。 。 . SDK故障从不默默切换到执行. 为Muse 0.2.1采用了后端;该版的整合基线仍然是1.1.1-R2514.1. ## 兼容性 | 块 | 核实/要求 | | --- | --- | | 节点.js | **22岁以上** (npm安装) | | 缪斯主机 | **1.1.1 -- -- R2514.1** 基线`muse serve`;通过 `MUSE_CODE_EXECUTABLE` | | 也核实 | 1.2.1-R2847.1(会场负载/重置、多相允许/低排、HTTP MCP);CI还运行1.4.13-R6996.1 | | 缪斯 SDK | `@muse-code/sdk@1.4.12` (被绑定的依赖;不包括Muse 二进制) | | 新主机特性 | 土著目标1.4.6+; `/recap`,技能导入,插件/插件 1.4.7+; `/compact` 1.4.12+ (中文(简体) ) | | 认证 | 浏览器登录或 `META_API_KEY` | > **当会话必须在1.4.6 之前在主机上保留可恢复时保留默认的 SDK 后端** ——见: `:auto-review` 页:1 别指点 `MUSE_CODE_EXECUTABLE` 在旧的发射器缓存中(发射器去除被取代的二进制); 将已验证的二进制保存在单独的路径上 。 CI的1.1.1公开文物,准确的macOS ARM64/Linux URL,和SHA-256的检查在 [中情局](https://npmcn.com/package/%40bex-co/muse-code-acp/.github/workflows/ci.yml)。 。 。 . **完全相容历史( 1.2.1 – 1.4.6,: 自动审查, 执行档)** **支持的基准仍然是Muse 1.1.1-R2514.1** (验证适配器主机) **0.5.x (中文(简体) )**) (中文(简体) ). 适配器 **0.5.0 (单位:千美元)** 还验证 SDK 创建的会话负载/ 重置, 多阶段允许/ 拒绝, 以及 HTTP MCP 工具调用和启动失败 **1.2.1 -- -- R2847.1**非加太公司提供的MCP服务器明确使用所需的启动模式;认证、错误反应和无法到达的端点未能及时实现. 一个东道方限制仍然是1.2.1、1.3.0、1.4.3和1.4.4:遗产 `muse exec` 保存为 `:auto-review` 无法恢复 `muse serve`,其自动审查器无法使用。 从1.3.0-R3401.1起,东道主也拒绝阅读,因此ACP `session/load` 以相同消息失败, 而不是重放历史 。 从1.4.3 `muse exec` 保存新会话 `:auto-review` 默认情况下, 因此从 exec 后端选择的新会话也会受到影响 。 从 1.4.4 执行后端 仅读和计划会话使用 Muse 的内置 `:read-only` 配置文件并保留可装入; 默认模式保留 `:auto-review`,因为可装入的替代品将不经批准运行工具(上游: [muse-code-sdk#80 (英语)](https://github.com/meta-models/muse-code-sdk/issues/80)) (中文(简体) ). Muse 1.4.6 运行于 `muse serve` 并负载和继续这些会话, **当会话必须保持可恢复时保留默认的 SDK 后端 .** 在1.4.6上,审查者还先决定SDK后端的审批请求:低风险的调用在未经ACP许可的情况下批准运行,只有升级才到达客户. 在exec Default模式下,一个工具调用Muse的审阅器升级为用户,不能被无端回答;适配器在120秒后停止了运行(N`MUSE_CODE_ACP_EXEC_APPROVAL_STALL_MS`) 并且以这个理由不及时而不是绞刑([muse-code-sdk#99 (英语)](https://github.com/meta-models/muse-code-sdk/issues/99)) (中文(简体) ). 这影响了三次直播测试的遗产续作部分;SDK所创建的会话续作通过. 适配器报告一个可操作错误,不重放即时或更改已保存的权限配置 。 启动一个新的非加太会议,或在审评员的支持下继续穆斯的旧会议。 这些修正包括在 **0.5.0 (单位:千美元)**。 。 。 . Muse 1.2.1上存储的完整工具产出可供谈判客户通过 [限制公共产出为](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/stored-output.md),包括会话后加载。 对于缓慢的 SDK 启动,请配置 [启动和提交期限](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/failures.md#startup-phases-and-deadlines)失败的答复将未提交模型的作业与结果不明的提交作业区分开来. ## QQ 配置 | 变量 | 含义 | | --- | --- | | `MUSE_CODE_EXECUTABLE` | 外部 Muse 二进制路径; 优先于 PATH 发现 | | `MUSE_CODE_ACP_BACKEND` | `sdk` (违约)或 `exec`; 未知值在启动时失败 | | `META_API_KEY` | 提供者证书; 优先于存储的认证 | | `MUSE_CODE_ACP_ALLOW_YOLO` | 选择执行 Yolo 或单独选择 SDK 沙盒关闭 | | `MUSE_AGENT_LOGS` | 适配器产卵/stderr日志目录 | | `MUSE_CODE_ACP_STALL_MS` | 锁定待决主机请求, 默认 `10000` (SDK后端) | | `MUSE_CODE_ACP_GATEWAY_URL` | 明确模式网关终点;需要 `MUSE_CODE_ACP_GATEWAY_KEY` | | `MUSE_CODE_ACP_GATEWAY_KEY` | 这道门的代号是: | `muse-code-acp --cli login` 财务报告和审定财务报表 `muse-code-acp --cli logout` 向选定的Muse可执行文件代表。 日志不设置已导出 `META_API_KEY`。 。 。 . ## 问 题 **Zed说 `muse-code-acp` 没找到?** 使用安装二进制的绝对路径作为 `command`,并确保节点22+可供编辑器进程使用(GUI apps可能不会继承您的 shell) `PATH`) (中文(简体) ). **它在终端工作,但在编辑?** 设定 `MUSE_CODE_EXECUTABLE` (和 `META_API_KEY` 如果你使用它)在编辑的代理内 `env`不仅在你壳里. **我该运行哪个Muse版本?** 键 **1.1.1 -- -- R2514.1** 除非您需要有记录的新主机功能。 检查 `"$MUSE_CODE_EXECUTABLE" --version`。验证较新的主机的特定表面——见 [兼容性](https://npmcn.com/package/%40bex-co/muse-code-acp/#readme-compatibility)。 。 。 . **无头/ CI Auth?** 提供 `META_API_KEY` 到适配器进程。 客户端内部的浏览器登录需要终端- 自动支持; 否则运行 `muse login` (或 `muse-code-acp --cli login`————————————————. **SDK还是执行后端?** 保持默认的 SDK后端. Exec后端仅是一个回滚路径(只有Stio MCP,批准在Muse内部解决, `:auto-review` 1.4.6之前的恢复性说明。 SDK的失败从不默不作声地回归执行. ## 页:1 **从这里开始** - [能力证据和当前所有权](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/capability-audit.md) - [观察到的使用、计划、摘要和工具产出](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/progress.md) - [失败和认证观察](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/failures.md) 结构化 SDK 错误、证书、启动期限、回收 **会话和工作流程** - [会话发现和元数据](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/session-discovery.md) • 妇女 [土著会话分支](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/session-fork.md) • 妇女 [嵌入式输入和本地会话命令](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/session-commands.md) - [规划和Git审查](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/workflows.md) • 妇女 [目标观察和控制](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/goal-extension.md) • 妇女 [工作流程和背景任务](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/async-tasks.md) **协议和内部** - [SDK 支持、模型发现、编辑器上下文和引导](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/sdk-migration.md) - [MCP 通过和诊断](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/mcp-passthrough.md) • 妇女 [档案变更证据和谈判报告](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/file-change-report.md) • 妇女 [存储输出读取](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/stored-output.md) - [独立的苹果硅macOS构建](https://npmcn.com/package/%40bex-co/muse-code-acp/docs/standalone.md) ——只有源建+CI验证;预建的二进制不发布. 这些建筑包括了节点,仍然需要外部的Muse. ## 发展 从仓库取出 : ```sh npm ci npm run check # eslint + prettier npm run build # TypeScript compilation npm run test:unit # deterministic contracts; no Muse host required npm run test:coverage # same suite with enforced coverage thresholds npm run test:unit:shuffle # same suite in random order (prints its seed) npm run test:pack-smoke # clean tarball install and ACP execution ``` 对于真主机测试,将经过核实的Muse 二进制放入 PATH 上作为 `muse`设置 `MUSE_CODE_EXECUTABLE` 然后先建起来 ```sh MUSE_CODE_ACP_REQUIRE_MUSE=1 npm run test:muse-loopback ``` 这些测试使用本地回回提供商,并在CI中被要求;旗下防止一个缺失的主机默默地跳过接受. 适合较新的主机特性(例如Muse 1.4.6的本地目标控制)跳过旧主机——设置 `MUSE_CODE_ACP_REQUIRE_HOST_FEATURES=all`,或逗号分隔列表,例如 `goal-controls,session-commands`让那些跳伞失败 CI在1.1.1-R2514.1基线和1.4.8-R6256.1上运行回路套房,并具备所需的各种能力. `npm run test:run` 建造和运行完整的当地Vitest套房;付费提供者测试通过 `npm run test:integration` 并需要全权证书. 工作委员会住在这里 `.pm/`. 存储技能 [释放](https://npmcn.com/package/%40bex-co/muse-code-acp/.agents/skills/release/SKILL.md), (中文(简体) ), [首相](https://npmcn.com/package/%40bex-co/muse-code-acp/.agents/skills/pm/SKILL.md),以及 [工作流程执行](https://npmcn.com/package/%40bex-co/muse-code-acp/.agents/skills/loopx/SKILL.md) 住在这里 `.agents/skills/`. npm 发布通过 GitHub Actions 验证了准确的发布承诺后运行. ## \* 支持项目 - **启动重播** 若为 `muse-code-acp` 让Muse进入了你的编辑器——这是帮助其他开发者找到它的最廉价的方法. - **证据文件问题:** 编辑/客户, `muse --version`,适配器版本,后端(`sdk`编号 :`exec`),以及失败的命令或会话流. - **认真贡献:** 运行 `npm run check && npm run build && npm run test:unit` 在发送更改之前保留能力要求,并辅之以测试或 `docs/` 证据. ## 许可证 阿帕奇2.0 (英语). 衍生自 [幽灵 - 代理 - acp](https://github.com/agentclientprotocol/claude-agent-acp) (Zed Industries)——见 [通知](https://npmcn.com/package/%40bex-co/muse-code-acp/NOTICE)。 。 。 . ## 常见问题 ### @bex-co/muse-code-acp 是什么？ 由Muse Code\(Meta's muse CLI的非官方适配器\)提供动力的ACP兼容编码代理 ### 如何安装 @bex-co/muse-code-acp？ 在项目目录运行 npm install @bex-co/muse-code-acp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 muse-code-acp，可以用 npx muse-code-acp 直接运行。 ### @bex-co/muse-code-acp 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @bex-co/muse-code-acp 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @bex-co/muse-code-acp 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @bex-co/muse-code-acp 可以商用吗？ @bex-co/muse-code-acp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @bex-co/muse-code-acp 的下载量有多少？ 根据 npm 官方下载统计，@bex-co/muse-code-acp 在 2026/10/08 – 2026/11/06 这 30 天内被下载 4,735 次，日均约 158 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @bex-co/muse-code-acp 还在维护吗？ 最新版本 0\.11\.0 发布于 2026/10/26（13 天前）；至今共发布 13 个版本，其中过去 12 个月发布了 13 个；首次发布于 2026/08/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。