常见问题

MUX 会改我 agent 配置里已有的其它 server 吗？

不会。MUX 按单个 server 操作——安装 / 卸载只动它自己那一个条目，保留同文件里其它 server 的原始字节。而且每次写入前都会先把目标文件备份到 ~/.mux/backups/。

桌面 App 和命令行的数据是分开的吗？

不是。两者共享同一个数据目录 ~/.mux/，构建在同一个 Rust 核心之上。一端的改动，另一端刷新后立刻可见。你可以只装一个，也可以都装。

提示「MUX 已损坏，无法打开」怎么办？

这是 macOS 对未签名应用的隔离，不是应用坏了。执行：

xattr -dr com.apple.quarantine /Applications/MUX.app

或右键 App → 打开 → 在弹窗里再点「打开」。详见 安装。

有 Windows / Linux 版吗？

目前桌面 App 打包发布的是 macOS（Apple Silicon） 的 .dmg。CLI 是原生 Rust，理论上能在其它平台从源码编译（cargo install --path cli），但发布的预编译二进制目前是 macOS aarch64。

「停用」和「删除」有什么区别？

• 停用（Disable）：从 agent 配置里移除该 server，但记住它的完整配置——随时能开回来。适合临时关掉。
• 删除：从 agent 卸载。对 manual / 探索 条目，还能从目录彻底删除（Forget），同时从所有 agent 卸载。

详见 核心概念。

我改了一个目录条目，为什么某个 agent 没更新？

编辑传播是有意保守的：只自动重刷进「干净」安装了它的全局作用域 agent（磁盘配置 == 编辑前的目录配置）。被手改过或项目作用域的安装会被保留不动。

想强制推送，用重新同步（Resync）——桌面编辑器里的按钮，或 TUI Registry 屏幕的 S 键。定制过的会被跳过并报告，可选强制覆盖。详见 编辑传播。

同名的 stdio 和 http 会冲突吗？

不会。MUX 的身份是 name::transport 组合键，sse 归入 http。同名的 stdio 与 http 是两个独立条目，各自安装、编辑、删除互不影响。

目录里的条目从哪来？我能只留一部分吗？

目录是所有已启用来源的并集，MUX 不内置写死的清单。你可以单独启停每个来源来控制目录内容——停用一个来源，它的条目就消失（底层文件不删）。详见 来源。

官方精选合集是必须的吗？

不是。它只是一个可选的一键订阅（订阅一个内置的整理过的远程来源）。不加它，目录一样能靠你自己的订阅 / 导入 / 手动 / 探索来源工作。

数据能在多台机器间同步吗？

MUX 所有数据都在 ~/.mux/ 下，且配置路径都用可移植的 ~/… 形式，所以理论上把 ~/.mux/ 同步过去就行。但注意：不同机器上 agent 的实际安装位置可能不同，跨机器时留意路径差异。

还有问题？

到 GitHub Issues 提问或反馈。