机器

机器（控制台上叫「服务节点」）是真正跑会话的电脑：Mac 或 Linux。会话会在机器之间搬，成员不用挑哪台。

托管客户：机器由我们加、维护、下线，这一页你不用动手。你能在「服务节点与客户端」页上看到每台机器的状态；看到「维护中」「失联」时会发生什么，读本页后半的「状态」一节就够了。机器不够用、要多开几个人，告诉我们。

状态：在线 · 维护中 · 失联

状态	是什么	入口怎么对待它
在线	正常报到	一切照常
维护中	管理员标了「要下线」	不往它派新会话；上面已有的会话照跑
失联	大约 15 秒没报到	只标记：它上面的会话在列表里变灰；它们手上的任务认领 30 分钟后释放，不会自动在别处重开

「失联」压过「维护中」：标了维护又断了的机器就是失联。

在哪里看：控制台「服务节点与客户端」页的卡片徽章；成员客户端侧栏顶行 ● mac-a 22 · ◐ mac-b 3 维护中 · ○ linux-a 0（● 在线 · ◐ 维护中 · ○ 失联）；命令行 fleet hub machines，每台机器的状态、会话数、负载、账号数（备用 · 已用 / 上限）。

省下多少内存

打开一台机器的详情，在「负载与内存」里看会话总数、在算、已停放、省下的内存、空闲常驻和可停空闲。没有停放会话时隐藏「已停放」；旧节点尚未上报时整行隐藏。统计汇总这台机器上已上报的托管登录，任何登录缺少计量时不显示部分合计。

「已停放」沿用 HHV0：同时带 @parked 和 @park_held 才计入。「省」优先累加这些会话停放前由 C1 写入的 @park_saved_mb（含外壳的进程树 RSS，MB）；接回后不再计入。缺快照时，按同一会话身份读取账本最后一次 park 动作的 rss_mb 后备；快照无效或后备也缺失时，保留停放数、隐藏节省项。未报告这对停放标记时停放数为 0。

「空闲常驻」与「可停空闲」同为本批验收口径：本轮已结束（done / looping / 等你）、至少 60 秒 CPU 采样少于每分钟 0.5 秒、无人观看且无后台命令，内存为这些会话含外壳的进程树 RSS。有人看着或跑着后台命令的会话不计空闲，仍在原因行显示；即使空闲为 0 也保留这两类原因。其余会话计入在算，三类计数合起来是会话总数。采样不足时空闲数、在算数和空闲 RSS 保持未知，机器页暂不显示计量行；可停空闲未采到时显示待采样。

节点上 fleet doctor --park 可单独读同一份计数。按 UTC 日查看停放账本汇总：python3 ~/.claude/fleet/bin/fleet_park_metrics.py daily --day YYYY-MM-DD，包含停放、接回、失败、顺延次数，以及成功接回的 p50 / p95；定时接回有约定与开始时刻时才计算 30 秒内准时率，无样本显示未知。

只让一个人用某几台机器

每台机器上的登录都还在，只是暂时不让某个人用其中几台：管理员给这个人设一张机器白名单。

fleet-machine-policy.sh set gh:2987262 linux-a   # 只许用 linux-a
fleet-machine-policy.sh show gh:2987262                # 每台机器：开放 / 停用 + 原因
fleet-machine-policy.sh clear gh:2987262               # 撤掉名单：恢复全部机器

名单外的机器上：他连不进去（fleet <机器> 会说「这台机器暂未对你开放，可用：…」），新会话不会派过去（自动选机和点名都不行），已经开着的会话在半分钟内停用，列表里显示「已停用（管理员限制）」。他在那台机器上的登录、家目录、记录都不删，撤掉名单后原样恢复。不设名单 = 全部机器都能用。

加一台机器（自托管）

控制台「服务节点与客户端」→ 加服务节点。弹窗给出一个加入码和一行命令，1 小时内有效、只能用一次。
在那台机器上执行那一行命令（要 sudo）。Mac 上它形如：
```
 curl -fsSL https://hub.example.com/install/bin/fleet-node-install.sh | sudo bash -s -- --hub https://hub.example.com --join <加入码>
```
已经装了 fleet 的 Mac 也可以 sudo fleet node install --join <加入码>。Linux 照弹窗给的命令执行。
等它出现在页面上、徽章「在线」，就加好了。

同一条命令再执行一遍就是修复：已经做好的步骤会跳过，坏了的重新做。加入码不要贴进聊天、工单或提交记录里。

每台机器能开几个人的账号默认是 10 个：fleet hub set fleet.node_user_cap.mac-a 20 改。设置页「每台电脑备好空账号」打开后，每台机器预先备几个空账号，新人登录即用。

计划下线：升级、搬机、换硬件（自托管）

每一步都是人做的，没有哪一步会自动关机。

标维护中：卡片上维护 → 填原因（比如「升级系统，预计 40 分钟」）。或命令行 fleet hub set fleet.node_maintenance.mac-a "升级系统"。从这一刻起不往它派新会话。
把空闲的会话搬走：在这台机器上，每个账号各执行一次
```
 ~/.claude/fleet/bin/fleet-evacuate.sh --dry-run   # 先看会搬哪些、去哪
 ~/.claude/fleet/bin/fleet-evacuate.sh             # 真搬
```
只搬空闲、没有未提交改动的会话，正在干活的一个都不碰；搬过去的会话在另一台机器上原样接着。输出的 left N 是还留着的，等它们做完再执行一次。
确认：卡片上会话数降到 0（或只剩你决定让它随机器一起断的）。
关机、升级。
回来以后：开机，机器自己连回入口，徽章回到「维护中」。在它上面执行 fleet doctor 看没有红项，然后卡片上 结束维护（或 fleet hub unset fleet.node_maintenance.mac-a）。

意外下线：断电、死机、断网

成员：什么都不用做。fleet 会自动落到别的在线机器；失联机器上的会话暂时动不了，要紧的事在别的机器上重新开（任务认领 30 分钟后自动释放）。
自托管的管理员：先判断是断网还是真停了。断网时会话其实还在跑，网回来一切自动复原。真停了：机器回来后先标维护中（不然入口立刻往它派活），执行 fleet doctor 检查；同一个任务若已经在别的机器上重开，留新的、关掉旧的，再结束维护。
托管：我们处理，并在恢复后告诉你。

永久移除一台机器（自托管）

先按「计划下线」把会话搬空。
机器上的每个人的账号先收回（开号与删号）。
卡片上移除：这台机器的入场证立刻作废，卡片消失。以后要再接回来，得用新的加入码。