dsh-duck-fleet
DuckFleet：一群机器，一条命令。添加一台机器后，其 ACP 委派工具会自动出现——用自然语言驱动一台、几台或全部机器。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:new-sailfish/duck-fleet#93e6cad4d000adf3f0a847bd69a8057b8f06a67dDuck Fleet 以 dsh-duck-fleet 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 | English
一群机器，一声令下。
DuckFleet 是一个 DSH 插件：往主控机上装一次，把多台机器接进同一群， 每台机器自动获得一个派活工具，然后你就可以用自然语言让「某个 / 某几个 / 全部」机器干活。
你：让所有机器汇报当前的 CPU 和内存占用
DuckFleet：→ 并发派给 3 台机器 → 逐台汇总结果回来
$DSH_HOME/fleet.json，或设置页里的可视化编辑。host 一个字段即可换地址，运行时当场重注册。dsh、一个 acp profile。插件只装在主控机上。
dsh plugin --profile desktop add dsh-duck-fleet
git clone git@github.com:new-sailfish/duck-fleet.git
dsh plugin --profile desktop add /path/to/duck-fleet
dsh plugin add 会把包装进 profile 并同步到 dsh.profile.bundles。
装完要重启一次 DSH。
面板属于客户端半，而客户端插件的 bundle 是应用启动时建立并缓存的， 所以刷新页面没用 —— 正在跑的进程不会重读磁盘上的新 bundle。
服务端那一半（
fleet_*工具、派活）在插件行重新加载后即时生效，重启只是为了面板。判断标准：工具能用 = 服务端已更新；面板还是旧的 = 需要重启。
profile 的 package.json：
{
"dependencies": { "dsh-duck-fleet": "link:/path/to/duck-fleet" },
"dsh": { "profile": { "bundles": ["…", "dsh-duck-fleet"] } }
}
装好之后，插件会在主控机上：
fleet_list / fleet_add / fleet_test / fleet_setup / …）。打开设置 → 鸭群。
| 需要 | 说明 |
|---|---|
| sshd 在跑 | 主控机要能 ssh 进去 |
dsh 已安装 | 这是唯一的前提 |
一个 acp profile | 由提示词创建 |
| 主控机的公钥 | 由提示词写入 |
这四件事都交给提示词里的被控机 agent 自己去查、去装，不需要手工配。
「自动获取配置」生成的那段提示词，可以这样送到被控机：
| 方式 | 怎么做 | 适用 |
|---|---|---|
| 复制粘贴 | 点**「复制提示词」**，粘到被控机的 DSH 或终端里执行 | 你能直接操作那台机器 |
| 局域网链接 | 点**「改用局域网链接」，得到一个形如 http://192.168.1.10:<port>/abcd 的地址，在被控机上打开**它取提示词 | 被控机不在手边 |
也可以在任意会话里说：「用 fleet_setup 生成被控端配置提示词，用户 dev、主机 192.168.1.10」。
局域网链接是临时的：只在取提示词之前有效，取到即止，最多 1 分钟； 路径是 4 位小写字母，只有取走它的那一台机器能访问（其他 host 一律 403）。 它只在本机监听，不经过任何外部服务。
提示词自己是自包含的：让被控机的 agent 先查现状再动手，只装缺的东西， 所以对新机器和配了一半的机器都适用。它只带公钥，私钥永远留在主控机。
profile 那一步不能省。
acpprofile 默认带沙箱，而在由 ssh 拉起的无人值守会话里， 受限沙箱会让子进程创建失败。症状是「能连上、能对话，但什么命令都执行不了」， 看起来像机器坏了，其实只差配置文件里的两行。
设置 → 鸭群 →「添加机器」 有两条路，选一条即可：
| 路径 | 适合 | |
|---|---|---|
| 推荐 | 「自动获取配置」 | 把提示词交给被控机执行，它查完自己回报，主控机自动写入并验证 |
| 备选 | 「手动填写配置」 | 你已经知道主机名、账号、端口，或想直接编辑 JSON |
label / host / user / port（其余字段有默认值）；名称的 ASCII 字母决定工具名（Home Server → pc_home_server），随时可改。
用
fleet_add加一台机器：名称laptop-01，主机192.168.1.10，用户dev
或直接改 $DSH_HOME/fleet.json，改完不用重启。
| 你要的 | 你说 |
|---|---|
| 某个 | 让 desktop-01 汇报一下磁盘占用 |
| 某几个 | 让 laptop-01 和 desktop-01 都检查一下 Node 版本 |
| 全部 | 所有机器都把日志目录打包发我 |
多台机器并发执行，不会等一倍的时间。长任务加 run_in_background: true，之后用 job_output 收结果。
每次派活都会在任务前面自动附加一段「环境与工作规范」——那台机器的环境事实、由事实推出的硬约束、以及跨平台的工作通则。写任务时不要重复这些内容。哪台机器带哪一版由它的 platform 字段决定。
机器清单在 $DSH_HOME/fleet.json。共享设置设一次所有机器继承；单台字段每台独立，新建时继承共享设置。
defaults）| 字段 | 默认 | 说明 |
|---|---|---|
keyFile | 空 | SSH 私钥路径。必须对，否则 ssh 会静默用别的身份 |
sshCommand | ssh | ssh 可执行文件 |
profile | acp | 远端 profile 名 |
autoArchive | 关闭 | 实验性。会话清理规则，见下 |
| 字段 | 默认 | 说明 |
|---|---|---|
label | 必填 | 显示名，也是工具名的来源 |
host / user / port | 必填 / 必填 / 22 | SSH 目标 |
toolName | 由 label 派生 | 模型调用的工具名，可随时改 |
remoteCommand | dsh | 怎么在那台机器上启动 agent。非交互式 SSH 的 PATH 里通常没有 dsh，所以实际要填绝对路径，如 C:/Users/dev/AppData/Local/Programs/DeepSeek Harness/resources/runtime/cli/bin/dsh.cmd |
cwd | 空 | 那台机器上的工作区。空 = 让远端用自己的默认工作区 |
permission | allow | 那台机器上授权提示怎么答 |
description | 空 | 一句话说明这台的用途，会附到工具描述里 |
platform | windows | 那台机器跑什么系统，决定派活前置词带哪一版：windows 全带、posix 只带工作通则、none 不带。不是 Windows 的机器要显式设置 —— 默认值是假设 |
extraArgs | [] | 额外的 ssh 参数 |
remoteCommand 不在共享设置里，因为它的可用值是被控机上 dsh 的绝对路径，
而那个路径带着那台机器的用户名 —— 共享出去等于让别的机器去跑另一台机器的程序。
| 工具 | 用途 |
|---|---|
fleet_list | 列出机器：toolName user@host label + 工作区 + 权限 + 注册状态 |
fleet_add | 加机器或改机器（按 id 或 label 匹配） |
fleet_remove | 删机器，并注销它的 provider 和工具 |
fleet_test | 只做 SSH + ACP 握手，不花 token |
fleet_setup | 生成给被控机的配置提示词（附公钥） |
fleet_defaults | 读/改共享设置 |
fleet_version | 报告当前加载的是哪个版本的实现 |
插件往系统提示里注册了一段用法说明，告诉模型：先调 fleet_list 拿「机器名 → 工具名」的映射，
然后在同一条消息里并发调用。工具 schema 只描述「怎么调」，从不描述「什么时候调」。
DuckFleet 是给自己用的、内网的工具。下面是设计上就没做的事 —— 不是 bug，是边界。 越过它们，安全性由你自己负责。
127.0.0.1）。
改了 harness 的监听范围，面板也跟着变 —— 插件不额外做访问控制。被控机的 ACP profile 默认关掉审批。那条会话对面没有人可以回答提示，问了只会白等一轮；
授权判断由主控机这边承担（记录的 permission 字段）。
后果：派过去的任务在被控机上以那个 SSH 账号的全部权限运行，不会中途停下来问你。 派活之前，你要对那条命令本身负责。
$DSH_HOME/fleet.json，明文，含主机名、用户名、私钥路径。每次派活都会在被控机上开一个新的 ACP 会话，而 ACP 那条路径不把会话归入任何 workspace ——
它只带一个 cwd。结果是这些会话全部落进侧边栏的**「未分组」**里，用一次多一个。
主控机这边没有办法事后补救：能完成挂载的操作既没有 ACP 等价物，也没有 HTTP 路由。 能动的只有归档。
# 预演：只探测平台，不改动任何东西
fleet_prune --inspect
# 清理全部机器，保留最近 5 个
fleet_prune
# 只清理一台，保留最近 2 个
fleet_prune --id huawei-vm --keep 2
面板里也有对应入口（共享设置下方的虚线框），可以逐台点「清理」。
| 项目 | 行为 |
|---|---|
| 候选范围 | 只处理「裸 UUID」目录名的会话 |
| 保留数量 | 最近 N 个（默认 5，可配 autoArchive.keepLast） |
| 备份 | 首次运行写 workspace.json.bak-before-archive，不覆盖已有备份 |
| 可逆 | 归档可在侧边栏「已归档」里取消 |
判据是「裸 UUID」：ACP 建的会话 ID 是裸 UUID，而 DSH 界面里建的是 session- 前缀。
只按目录名筛选不够 —— 被控机的 cwd 往往就是你自己也在用的目录。
清理需要停掉被控机的 DSH，归档后再自动启动。 整个过程约 30 秒，期间那台机器上的派活会中断。
| 平台 | 状态 |
|---|---|
| Windows | ✅ 已在真机上反复验证 |
| macOS / Linux | ❌ 未实现也未测试，遇到会直接拒绝，不会尝试 |
拒绝而不是「试一试」，是因为两个环节都是平台相关的：注册表路径不同， 而且停掉之后如何把 GUI 应用放回交互式桌面，POSIX 的等价做法还没有写过。
已知的误判风险：如果 DSH 将来改了会话命名规则，或者你在同一目录里手工建了裸 UUID 会话， 它们会被当作派活会话归档。备份和可逆性是为这个准备的。
cwd 分两侧：本机 ssh 进程的工作目录永远是本机会话目录；
被控机的工作区走 ACP 的 session/new 参数。fleet_test 只验证到握手，实际执行一次才算验证。fleet_list 报告出来的每一台，
由模型在同一轮里逐个调用。MIT