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用户找到它 打开一个问题 使用编辑器 + Muse 版本,当某事中断时.

你得到的东西

在默认 SDK 后端与已核实的主机 :

需要先尝试的斜线命令

斜线命令可以在任何上层文本块中与编辑器上下文并列出现.

诚实的限制 : 授权工人和象征性用途被报告为无法使用。 说明理由摘要,编辑-侧文件系统代理,多个授权的工作空间根,以及本地会话删除未执行. 闭幕会议保留了会议的历史。 这个适配器不执行Muse终端UI的每个ACP特性或每个特性. 可用的功能也取决于您的 ACP 客户端.

QQ快起步——约60秒

先决条件

• 节点.js 22+
• Muse码1.1.1-R2514.1 (核实主机,单独安装,与 muse serve)——最新的Muse安装器可能安装了不同的版本,因此将二进制与 MUSE_CODE_EXECUTABLE (见 兼容性(中文(简体) )
• 通过浏览器登录 Muse auth 或者说 META_API_KEY

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——通过你的编辑器推出,而不是作为交互式终端聊天.

齐德

添加一个 自定义外部代理 ,替换 Muse 路径 :

{
  "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。浏览器登录到客户端需要终端-自动支持;否则会事先认证.

如何运作

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 与 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; 仅读存储帮助器仍然用于兼容性检查和标题倒置. 索引最终是一致的,因此新会话可能不会立即出现.

MUSE_CODE_ACP_BACKEND=exec muse-code-acp

兼容性

当会话必须在1.4.6 之前在主机上保留可恢复时保留默认的 SDK 后端 ——见: :auto-review 页:1 别指点 MUSE_CODE_EXECUTABLE 在旧的发射器缓存中(发射器去除被取代的二进制); 将已验证的二进制保存在单独的路径上 。 CI的1.1.1公开文物,准确的macOS ARM64/Linux URL,和SHA-256的检查在 中情局。 。 。 .

QQ 配置

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。验证较新的主机的特定表面——见 兼容性。 。 。 .

无头/ 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

从这里开始

• 能力证据和当前所有权
• 观察到的使用、计划、摘要和工具产出
• 失败和认证观察 结构化 SDK 错误、证书、启动期限、回收

会话和工作流程

• 会话发现和元数据 • 妇女 土著会话分支 • 妇女 嵌入式输入和本地会话命令
• 规划和Git审查 • 妇女 目标观察和控制 • 妇女 工作流程和背景任务

协议和内部

• SDK 支持、模型发现、编辑器上下文和引导
• MCP 通过和诊断 • 妇女 档案变更证据和谈判报告 • 妇女 存储输出读取
• 独立的苹果硅macOS构建 ——只有源建+CI验证;预建的二进制不发布. 这些建筑包括了节点,仍然需要外部的Muse.

发展

从仓库取出 :

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 然后先建起来

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/. 存储技能 释放, (中文(简体) ), 首相,以及 工作流程执行 住在这里 .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 (Zed Industries)——见 通知。 。 。 .