多机器管理
仅 Cloud
多机器管理仅在 Cloud 版本中可用。自托管版本支持单台机器。
ADHDev Cloud 让一个账户从单个仪表板中跟踪多台开发机器。
它为你提供什么
- 面向你的笔记本、台式机、工作机或远程服务器的单一仪表板
- 跨 IDE、CLI 和 ACP 工作流的机器感知会话可见性
- 一个带有启动控件、提供方设置、日志和 session-host 恢复的机器详情页
- 本地网络之外的云端访问
这是云端与自托管之间最清晰的差异之一。云端是账户关联的控制平面。自托管是每台机器一个本地仪表板。
工作原理
每台机器都运行自己的 ADHDev 守护进程，认证到同一个云账户：
npm install -g adhdev
adhdev setup
adhdev daemon一旦机器在同一账户下连接，它们会一起显示在仪表板中。
Repo Mesh（守护进程间编排）
Repo Mesh 协调同一账户的多个守护进程，使一个协调者会话可以跨多台机器或 git 工作树驱动工作。它运行在直接的守护进程到守护进程 P2P DataChannel（通过 node-datachannel）之上；云服务器 WebSocket 仅中继 SDP offer/answer/ICE 信令，并授权两个守护进程属于同一账户。这是守护进程协调 —— 它不是仪表板命令的回退。仪表板命令/数据流量仍然只使用仪表板↔守护进程 P2P 通道。
云端仪表板在 Repo Mesh 页面（/mesh）中呈现 mesh。
核心概念：
- Node —— 参与 mesh 的工作区：一个代理可以在其中运行的仓库检出或隔离的 git 工作树。
- Mission —— 一个目标，把为其工作的任务分组在一起，并作为持久记录保留。
- Task —— 节点上的代理执行的一个工作单元，经历
pending → assigned → completed/failed。 - Queue —— 守护进程本地的等待任务列表，空闲节点自主认领。队列以本地为先且具有权威性；Cloud/D1 只保存轻量的成员/信令元数据。
- Ledger —— 跨节点已发生事件的仅追加 mesh 审计日志（历史，而非待办列表）。通过有界的 P2P 账本切片在守护进程之间对齐。
- Refinery —— 把工作树分支收敛回其基线的过程：验证 → 合并 → 推送 → 清理。
协调者守护进程持有聚合的 mesh_status 快照。工作会话由协调者分派，默认自动批准。完成是基于证据的（git 状态/检查点、账本事件），而非 LLM 自我报告。Repo Mesh 工具在 mesh 模式下通过 MCP 服务器暴露给协调者会话 —— 参见 MCP 服务器。
要了解完整图景 —— 基于拉取的编排、工作树隔离的仓库协作、Refinery 收敛，以及 MAGI 交叉验证 —— 请参见专门的 Repo Mesh 指南。
Burrows
Burrows 页面是机器级概览。它是你快速查看以下内容的地方：
- 哪些机器在线
- 某个会话属于哪台机器
- 连接和运行时状态
- 你想要打开详情的机器
机器详情
打开一台机器会给你一个比主仪表板更具操作性的视图：
- 面向当前 IDE、CLI 和 ACP 会话的 Workspace
- 面向托管 CLI 运行时诊断与恢复的 Hosted Runtimes
- 面向机器/提供方设置的 Providers
- 面向机器健康的 System
- 面向运行时和守护进程日志的 Logs
当高层仪表板告诉你出了问题，但你需要机器专属上下文时，就使用这个页面。
典型用途
多机器云配置在你有以下需求时尤其有用：
- 让一台机器专注于后台代理工作
- 分开个人设备和工作设备
- 想要对在其他地方运行的会话进行移动端批准
- 需要在你未实际使用的机器上恢复某个 CLI 运行时
套餐限制
| 套餐 | 最大机器数 |
|---|---|
| Free | 1 |
| Pro | 3 |
| Enterprise | 无限 |
当你达到机器上限时，额外的机器注册会被拒绝，直到你移除一台或升级。
自托管差异
自托管不会把多台机器合并到一个托管仪表板中。
当你想要面向一台机器的仅本地仪表板时，请使用自托管。当你想要跨设备的账户关联机器可见性时，请使用云端。
命名机器
一旦你连接了不止一台机器，友好的机器名称就变得重要。
机器昵称贯穿整个仪表板，有助于消歧某个会话实际运行在哪里。