#Muse Code

使用你现有的 Muse 安装和凭据，在 Paseo 中运行 Meta 的终端编程 Agent。

#开始使用

在运行 Paseo daemon 的机器上安装 Muse Code：

curl -fsSL https://dev.meta.ai/install.sh | sh
muse login

请使用 Muse 1.3.0 或更高版本。此集成已在 1.4.1 上验证。如需 API 访问，请在 daemon 的环境中设置 META_API_KEY，而不是登录。参见 Provider 环境变量覆盖。

在 Paseo 中选择 Muse Code，然后选择模型、审批模式和推理强度。Paseo 运行 muse serve，并通过 Muse Session Protocol（MSP）通信。可用的模型由你的 Muse 配置决定。

#Provider 选项

Paseo 启动 Muse 时会禁用沙箱（--disable-sandbox）并开启工作区信任（--trust-workspace）。Muse 可以使用你的 npm 缓存安装软件包，并加载项目规则、技能和配置。

在 daemon 所在机器的 config.json 中，于 agents.providers.muse.options 下为所有 Muse Agent 设置默认值：

{
  "agents": {
    "providers": {
      "muse": {
        "options": {
          "sandbox": { "enabled": true, "network": "proxy-only" },
          "trustWorkspace": false
        }
      }
    }
  }
}

创建 Agent 时，你也可以提供每个 Agent 各自的 providerOptions。daemon 会把 Provider 默认值与每个 Agent 的选项合并，并把生效的 providerOptions 传给 Muse。配置和创建方法见 Provider 选项。

每个 Agent 的选项会随 Agent 一起保存，并在刷新或恢复时打开其 Muse 主机时重新应用。无效的值和未知的键会使会话创建失败，并报告 providerOptions 错误。

选项	默认值	作用
sandbox.enabled	false	启用 Muse 的文件系统和网络沙箱。沙箱中的主目录是只读的，npm 无法写入默认缓存。
sandbox.network	"proxy-only"	沙箱网络策略："proxy-only"、"restricted" 或 "enabled"。禁用沙箱时，Muse 允许完全的网络访问。
trustWorkspace	true	允许 Muse 加载项目规则、技能和配置。

审批模式单独控制工具决策：Default、Ask、Strict 和 Full access。Full access 会自动允许升级的审批阶段，并保留生效的 Provider 选项。技能会和 /compact 一起出现在斜杠命令菜单中。

#Muse 1.4.1 中的限制

• Paseo MCP 工具不可用。 Muse 在匹配 MCP 调用之前丢弃了返回的工具命名空间。这是上游问题，必须先在 Muse 中修复，它的 Agent 才能使用 Paseo 工具。
• 上下文压缩需要模型的上下文上限。 如果你的端点不报告上限，请在 Muse 中为所选模型配置 context_compaction.provider_context_limit_tokens。
• 只有 Muse 报告用量窗口时才会显示。 usage/read 返回空响应时，订阅用量将不可用。
• 原生子 Agent 可能需要 Muse 的实验性 SDK 开关。 如果缺少原生子 Agent 工具，请在 Provider 环境中设置 MUSE_EXPERIMENTAL_SDK_ENABLED=on。只有当 Muse 提供 childSessionId 时，关联的子会话才会出现。

要在 agents.providers.muse 下覆盖二进制文件或环境变量，请参见自定义 Provider。