跨机同跑 TwinsEarth/dsh-windows2macos

DSH: Windows2MacOS

一个 DeepSeek 账号。一句指令。你手上的每台机器都跑同一个项目。

安装

五条路，任选一条。最后都会在你的智能体里注册 16 个工具。

1. DSH 插件（推荐 —— 零配置）

1. install the package into your DSH profile
dsh plugin add @twinsearth/w2m-dsh-plugin

2. name it in the profile's bundle list — a package that is not bundled never loads ~/.dsh/profiles/<profile>/dsh.profile.yml plugins:
- '@twinsearth/w2m-dsh-plugin'

3. restart DSH; joining happens at mount time, so a hot reload is not enough

从 1.1.15 起，智能体会自己启动（autoStartAgent 默认为 true）：新装好的机器会自行推导账号身份，加入该账号的设备集群，直接出现在 w2m_devices 里，不需要配对步骤。想关掉这个行为，请修改已有的 w2m 那一行 —— 不要新增第二行：

cordis.patch.yml
- id: w2m
config:
autoStartAgent: false

2. npm（MCP 服务器，任意客户端）

npm install -g @twinsearth/w2m-dsh-plugin
w2m-mcp --help

把任意 MCP 客户端指向 w2m-mcp 即可。零运行时依赖；中继、智能体和工具都打在这个包里。

3. Claude Code

/plugin marketplace add TwinsEarth/dsh-windows2macos
/plugin install w2m@twinsearth

清单文件放在 .claude-plugin/，版本与发布版锁定。

4. Codex 及其他支持 MCP 的命令行

copy this block into your own codex/mcp-servers.toml
[mcp_servers.w2m]
command = "npx"
args = ["-y", "@twinsearth/w2m-dsh-plugin@1.1.19", "w2m-mcp"]

5. 校验过的发布压缩包（离线）

从 v1.1.19 发布页下载两个文件 —— twinsearth-w2m-dsh-plugin-1.1.19.tgz 和 SHA256SUMS —— 然后：

curl -LO https://github.com/TwinsEarth/dsh-windows2macos/releases/download/v1.1.19/twinsearth-w2m-dsh-plugin-1.1.19.tgz
sha256sum -c SHA256SUMS # verify before installing, always
npm install -g ./twinsearth-w2m-dsh-plugin-1.1.19.tgz

每次发布都带 SHA256SUMS，就是为了这个。哪个发布版缺了它，就别装那个版本。

6. Beta（预发布 —— 从不上 npm）

beta 是 GitHub prerelease，不是 npm 版本。npm install 解析不到它，latest 也永远不会指向它。它面向已获得 beta-access 权限、并接受它可能出问题的开发者。

1. find the newest prerelease (a beta is marked "Pre-release" on the releases page)
https://github.com/TwinsEarth/dsh-windows2macos/releases -> latest entry labelled Pre-release
2. download BOTH files attached to it: twinsearth-w2m-dsh-plugin-<version>.tgz and SHA256SUMS
sha256sum -c SHA256SUMS # verify before installing, always
npm install -g ./twinsearth-w2m-dsh-plugin-<version>.tgz

- 权限：beta 工作流要等受保护的 beta-access 环境，所以每次运行都得审核人批准，产物才会生成。
- 风险确认：只有读过 SECURITY.md，并接受 beta 可能在稳定版不会出问题的地方失败，才可以安装。
- 回退：执行 npm install -g @twinsearth/w2m-dsh-plugin@latest 即可回到稳定通道。
- 为什么不上 npm：beta 工作流里没有 npm publish 这一步。发布根本不会发生，通道也就漏不进默认安装。

快速开始

w2m_status # am I paired? which fleet?
w2m_devices # what is in the fleet?
w2m_run mode="replicate" command_argv=["git","rev-parse","HEAD"]
w2m_wait task_id="..."

replicate 在每台在线机器上运行；只有每台机器返回相同结果且相同 commit 锚点时，结论才是 consistent。split 给每台机器分一片，pipeline 串联各阶段，broadcast 指定一个执行者并汇报观察者，compose 合并结果。

它是什么

一个可安装插件，把一组机器变成一个集群，以你的账号为键，而不是靠手工维护的主机列表。

| 组件 | 职责 |
| Relay | 一个小型 HTTP 服务器：任务路由、租约、SSE、blob 存储。放在你的机器能访问到的任何地方运行。 |
| Agent | 在每台机器上运行：配对一次，执行白名单内的命令，发送心跳。 |
| Plugin | 你的智能体调用的工具。 |
| Admission（1.1.14+） | 新机器申请加入；在线成员批准，10 秒自动批准，最近 24 小时内加入的机器可以立即移除。 |

工具

w2m_status · w2m_devices · w2m_run · w2m_wait · w2m_history · w2m_stats · w2m_report · w2m_memory · w2m_approvals · w2m_cancel · w2m_council · w2m_chat · w2m_update w2m_tasks · w2m_reduce
- w2m_intent —— 把结构化意图（run-tests、node-version、git-status、git-head、fleet-facts、shard-probe）映射到白名单内的命令；未知意图按名称拒绝，绝不猜测。

派发的命令收到的环境变量（1.1.15+）

变量取自 offer，绝不取自 argv，因此单台机器无法改变整个集群的分配。

| 变量 | 含义 |
| W2M_INDEX / W2M_INDEX_TOTAL | 本机的分片编号，以及分片总数 |
| W2M_STAGE_INDEX | 流水线阶段；刻意与 W2M_INDEX 分开 |
| W2M_TASK_ID / W2M_MODE | 任务及其模式 |
| W2M_MACHINE_ID / W2M_MACHINE_NAME | 本机 |

所以，在四台机器上运行 command_argv=["node","-e","process.exit(Number(process.env.W2M_INDEX)+1)"]，退出码依次为 1/2/3/4。
单机行为已测试；四机运行在下面列为未验证。

集群模型

身份是账号，不是主机列表。机器从账号材料派生 Ed25519 身份；账号的首台机器配对时，中继注册对应的公钥；之后每台机器都用一次性签名挑战证明同一个账号。

仅当旧配对路径因具名原因失败时——配对码无效、中继不可达、超时——机器才回退到申请准入。其他任何失败都需要人工处理，且不会改变机制。拒绝是最终结果；机器不会再次申请。

中继对每个时间窗口和每个法定人数都是权威，因为客户端时钟不一致（实测：同一集群内机器之间相差数十秒）：

- 10 s 内没有决定就自动批准，但仅当至少一名成员在线时——空集群无法同意，这种拒绝是具名的（NO_ONLINE_MEMBER）；
- 准入后 24 h 内，任何在线成员都可以立即移除该机器；
- 24 h 后，单台机器只能发起投票，其法定人数集合在发起时冻结，这样投票者中途离线也无法改变门槛；
- 法定人数为 3+ 名老成员时需要 ≥ 50 %（向上取整）；两名成员的集群需要一票；
- 离线超过 72 小时的机器离开列表——它永远不会被删除，记录保留，再次上报即可回归。

安全姿态

- 命令允许列表基于 argv 前缀，并用 COMMAND_REPARSE_ARGUMENT 拒绝会重新解析 argv 的标志（--import、追加的 -e）。它是边界，不是沙箱。
- 派发任务需要操作员 token。设备 token 不能派发。
- 准入批准需要至少一名成员在线。
- 账号签名密钥从集群密钥派生，绝不从账号码派生——账号码会写入日志，从可读值派生密钥等于交出账号身份。
- 每个发布都带校验和。

已验证与未验证

掩盖这一点的绿色徽章比没有徽章更糟。

已验证： 102 个文件中的 2458 个测试（2444 通过，14 跳过），15 项预检，CI 在 Windows、macOS 和 Linux 上通过，npm + GitHub release + 校验和一致，在真实的 Linux/Mac/Windows 三机上完成端到端集群运行。
未验证 / 已知缺口：

| 缺口 | 状态 |
| 审批弹窗控制 | relay 负责执行规则，w2m_approvals 和 w2m_cancel 负责列出并结算请求，但 10 秒倒计时只是列表里展示的 relay 数据，不是专门的弹窗 |
| 四机 W2M_INDEX 运行 | 单机行为已测；跨机群的 1/2/3/4 运行尚未执行 |
| 机群聊天 / 广播通道 | 消息存储 + 配额已实现并测试；加密、分片、端点与面板尚未构建 |
| 部分 macOS 主机上的 P2P | 观察到 P2P_PUNCH_FAILED: Unknown cipher；任务回退到 relay 路径 |

故障排查

| 现象 | 原因 | 修复 |
| 已安装，但 w2m_devices 返回 401 | 智能体从未启动，因此没有设备 token | 检查 autoStartAgent 不是 false；重启 DSH（不是热重载） |
| 机群中缺少某台机器 | 插件不在 dsh.profile.bundles 里 | 加进去——没被打包的包永远不会加载 |
| COMMAND_NOT_ALLOWED | 命令不在允许列表里 | 扩展允许列表；argv 按前缀匹配 |
| 判定结果总是 partial | 来自已下线机器的过期租约 | 1.1.2 已修复：派发只租用在线且非静默的机器 |
| P2P_PUNCH_FAILED | NAT，或主机加密能力缺口 | 会降级到 relay 路径；结果不受影响 |

发布通道

三个通道，其中只有一个是你运行 npm install 时拿到的。

| 通道 | 来源 | 适合谁 |
| stable | npm latest——开发者声明为稳定的版本 | 所有人；这是默认安装 |
| beta | GitHub prerelease（tarball + SHA256SUMS），从不上 npm | 获得 beta-access 授权、并接受它可能失败的开发者 |
| latest build | 两者中更新的那个，不论通道 | 想要最新代码、并清楚上述情况的开发者 |

版本号提升默认是 beta。只有当开发者明确说明这一版是稳定版时，npm 才会收到版本：beta 以 prerelease 形式发布（因此 GitHub 和 npm 都不会把它解析为 latest），只有在 beta-access 环境批准该次运行后才能下载，安装它需要阅读 SECURITY.md 并接受风险。

beta 工作流里没有 npm publish 这一行。这是有意为之——如果发布根本无法发生，通道就不可能泄漏到默认安装。

链接

- CHANGELOG — 每个版本，包括它刻意没有发布的内容
- PLATFORMS — Claude Code、Codex 与 MCP 的接入细节
- Releases — 每个版本的证据与校验和
- Issues

MIT。

中文说明

一个 DeepSeek 账号。一句话。你自己的每一台机器跑同一个项目。

以下内容与上方英文逐节对应，不是摘要。

安装

五种方式，最终都会在你的智能体里注册 16 个工具。任选其一。

1. DSH 插件（推荐，零配置）

1. 把包装进你的 DSH profile
dsh plugin add @twinsearth/w2m-dsh-plugin

2. 在 profile 的 bundle 列表里写上包名 —— 没进 bundle 的包永远不会被加载 ~/.dsh/profiles/<profile>/dsh.profile.yml plugins:
- '@twinsearth/w2m-dsh-plugin'

3. 重启 DSH。加入编队发生在 mount 时，热重载不够

从 1.1.15 起智能体会自动启动（autoStartAgent 默认 true）：新装的机器自行派生账号身份、加入该账号的编队，无需配对步骤就会出现在 w2m_devices 里。若要关闭，请 patch 已存在的 w2m 行，不要新增第二行：

cordis.patch.yml
- id: w2m
config:
autoStartAgent: false

2. npm（MCP 服务器，任意客户端）

npm install -g @twinsearth/w2m-dsh-plugin
w2m-mcp --help

把任意 MCP 客户端指向 w2m-mcp。零运行时依赖；包里同时带有 relay、agent 与工具。

3. Claude Code

/plugin marketplace add TwinsEarth/dsh-windows2macos
/plugin install w2m@twinsearth

清单文件位于 .claude-plugin/，版本与发行版锁定。

4. Codex 及其它支持 MCP 的命令行

把这段复制进你自己的 codex/mcp-servers.toml [mcp_servers.w2m]
command = "npx"
args = ["-y", "@twinsearth/w2m-dsh-plugin@1.1.19", "w2m-mcp"]

5. 校验过的发布包（离线）

从 v1.1.19 的 release 页面下载两个文件 —— twinsearth-w2m-dsh-plugin-1.1.19.tgz 与 SHA256SUMS —— 然后：

curl -LO https://github.com/TwinsEarth/dsh-windows2macos/releases/download/v1.1.19/twinsearth-w2m-dsh-plugin-1.1.19.tgz
sha256sum -c SHA256SUMS # 安装前务必校验
npm install -g ./twinsearth-w2m-dsh-plugin-1.1.19.tgz

每个 release 都带 SHA256SUMS 正是为了这一步。若某个 release 缺少它，不要安装该版本。

6. Beta（预发布版 —— 不进 npm）

Beta 是 GitHub prerelease，不是 npm 版本：npm install 永远拿不到它，latest 也不会指向它。它是给已获 beta-access 授权、且接受它可能出问题的开发者用的。

1. 在 releases 页面找标着 Pre-release 的最新条目 https://github.com/TwinsEarth/dsh-windows2macos/releases
2. 下载该条目的两个文件：twinsearth-w2m-dsh-plugin-<版本>.tgz 与 SHA256SUMS sha256sum -c SHA256SUMS # 安装前务必校验
npm install -g ./twinsearth-w2m-dsh-plugin-<版本>.tgz

- 权限：beta 流水线挂在受保护的 beta-access 环境上，每次运行都需要审批者批准，产物才会存在；
- 风险确认：安装前请阅读 SECURITY.md，并接受 beta 可能比稳定版更容易失败；
- 回退：npm install -g @twinsearth/w2m-dsh-plugin@latest 即回到稳定版通道；
- 为什么不走 npm：beta 工作流里没有 npm publish —— 只要发布动作不可能发生，这个通道就漏不进默认安装。

快速开始

w2m_status # 我配对了吗？在哪个编队？
w2m_devices # 编队里有什么？
w2m_run mode="replicate" command_argv=["git","rev-parse","HEAD"]
w2m_wait task_id="..."

replicate 在每一台在线机器上执行；只有当所有机器返回相同结果且相同 commit 锚点时，裁决才是 consistent。split 给每台机器一个分片，pipeline 串联多个阶段，broadcast 指定一个执行者并汇报观察者， compose 合并结果。

它是什么

一个可安装插件，把一组机器变成一个编队，以你的账号为键，而不是靠手工维护的主机清单。

| 组件 | 职责 |
| Relay | 一个小型 HTTP 服务：任务路由、租约、SSE、blob 存储。放在任何机器可达的位置。 |
| Agent | 每台机器上运行：配对一次、执行白名单命令、心跳。 |
| Plugin | 你的智能体调用的那些工具。 |
| Admission（1.1.14+） | 新机器申请加入；在线成员批准，10 秒自动同意；入队 24 小时内的机器可被立即移除。 |

工具

w2m_status · w2m_devices · w2m_run · w2m_wait · w2m_history · w2m_stats · w2m_report · w2m_memory · w2m_approvals · w2m_cancel · w2m_council · w2m_chat · w2m_update w2m_tasks

被派发命令会收到的环境变量（1.1.15+）

取值来自 offer，不来自 argv，因此单台机器无法改变整个编队的分片：W2M_INDEX / W2M_INDEX_TOTAL / W2M_STAGE_INDEX / W2M_TASK_ID / W2M_MODE / W2M_MACHINE_ID / W2M_MACHINE_NAME。

因此 command_argv=["node","-e","process.exit(Number(process.env.W2M_INDEX)+1)"] 在四台机器上应分别退出 1/2/3/4。单机行为已测；四台机器的联跑尚未验证（见下方"未验证"）。

编队模型

身份是账号，不是主机清单。机器从账号材料派生 Ed25519 身份；账号的第一台机器配对时，relay 登记对应公钥；此后每台机器用一次性签名挑战自证同一个账号。

只有当旧配对路径因明确原因失败时 —— 配对码无效、relay 不可达、超时 —— 机器才降级去申请入队。其它失败需要人工介入，不会切换机制。拒绝即终态，机器不会再次申请。

所有时间窗与法定人数由 relay 权威判定，因为客户端时钟互不一致（实测：同一编队内相差数十秒）：

- 无决策 10 秒后自动同意，但仅当至少一名成员在线 —— 空编队无法同意，该拒绝有明确错误码（NO_ONLINE_MEMBER）；
- 入队后 24 小时内，任一在线成员可立即移除该机器；
- 超过 24 小时，单台机器只能发起表决，且法定人数集合在发起时冻结，投票者中途离线无法改变门槛；
- 法定人数：旧成员 ≥3 人需 ≥50%（向上取整）；2 人编队的移除只要 1 票；
- 离线超过 72 小时的机器会离开列表 —— 记录永不删除，它重新上报后会自动回来。

安全姿态

- 命令白名单按 argv 前缀匹配，并拒绝 argv 重解析标志（--import、追加 -e），错误码 COMMAND_REPARSE_ARGUMENT。这是边界，不是沙箱。
- 派发任务需要 operator token；device token 不能派发。
- 审批入队要求至少一名成员在线。
- 账户签名密钥从 fleet key 派生，绝不用 account code —— account code 会写进日志，用可读值派生密钥等于交出账号身份。
- 每个发行版都有校验和。

已验证与未验证

一句真话胜过一块掩盖问题的绿牌。

已验证： 102 个文件中的 2458 项测试（2444 通过、14 跳过）、15 项门禁检查、Windows / macOS / Linux 三平台 CI 全绿、npm 与 GitHub 发布及校验和一致、在真实的 Linux/Mac/Windows 三机编队上跑过端到端。

未验证 / 已知缺口：

| 缺口 | 状态 |
| 审批弹窗控件 | relay 强制规则、w2m_approvals · w2m_cancel 可列出并裁决，但 10 秒倒计时是列表里的 relay 数据，不是独立弹窗 |
| 四台机器的 W2M_INDEX 联跑 | 单机行为已测；编队级 1/2/3/4 尚未执行 |
| 编队聊天 / 广播通道 | 消息存储与配额已实现并测试；加密、分片、端点与面板尚未构建 |
| 部分 macOS 主机的 P2P | 观察到 P2P_PUNCH_FAILED: Unknown cipher；任务会降级走 relay 路径 |

故障排查

| 症状 | 原因 | 处理 |
| 装好了，但 w2m_devices 返回 401 | agent 从未启动，因此没有 device token | 确认 autoStartAgent 不是 false；重启 DSH（热重载无效） |
| 编队里看不到这台机器 | 插件没写进 dsh.profile.bundles | 加进去 —— 不在 bundle 里的包永远不会加载 |
| COMMAND_NOT_ALLOWED | 命令不在白名单 | 扩充白名单；argv 按前缀匹配 |
| 裁决总是 partial | 来自已下线机器的陈旧租约 | 1.1.2 已修：派发只对在线且未沉默的机器建租约 |
| P2P_PUNCH_FAILED | NAT，或宿主密码学能力缺口 | 会自动降级到 relay 路径，结果不受影响 |

发布通道（中文）

三个通道，其中只有一个是你 npm install 默认拿到的。

| 通道 | 来源 | 适合谁 |
| stable | npm latest，开发者明确声明为稳定版 | 所有人；默认安装就是它 |
| beta | GitHub prerelease（tarball + SHA256SUMS），绝不进 npm | 被授予 beta-access、且接受它可能失败的开发者 |
| 最新构建 | 两者中版本较新的那个，不论通道 | 想要最新代码、并理解上述含义的开发者 |

默认的 bump 是 beta。只有开发者明确说明"这次是稳定版"，npm 才会收到该版本：beta 以 prerelease 形式发布（因此 GitHub 与 npm 都不会把它解析成 latest），只有在 beta-access 环境审批通过后才能下载，安装前需阅读 SECURITY.md 并自担风险。

beta 工作流里没有 npm publish 这一行，这是刻意的 —— 只要发布动作不可能发生，这个通道就不可能泄漏到默认安装。

链接

- CHANGELOG —— 每个版本，包括它故意没有交付的内容
- PLATFORMS —— Claude Code、Codex 与 MCP 的接线细节
- Releases —— 每个版本的证据与校验和
- Issues

MIT。