能力	说明
🪪 机器身份	每台机安装后自动生成 `machineId` + 永久 SK，零配置
🃏 机器名片	一行可复制字符串（ID/名称/IP:端口/CPU/内存/NAT/SK），一键组队
🧑‍🤝‍🧑 多团队	每台机可同时属于多个团队，每个团队独立名录互不干扰
🔐 信任握手	challenge-response + HMAC-SHA256 证明 SK 持有，SK 永不明文过网
💓 心跳监控	长连接 + RTT/内存上报，断线自动重连，在线状态实时可见
🚀 任务派发	`fleet_dispatch` 把任务发给任意在线成员，worker 自动跑 agent 并回流结果
📦 会话保留	worker 任务会话自动挂载到工作区，GUI 可见、记录完整、可回溯
🧰 零运行时依赖	仅用 Node 内置模块，无第三方依赖
🖥️ 一键安装器	Windows / Linux 离线安装 harness + 插件，无需 pnpm/GitHub

🏗️ 核心模型（四层）

层次	内容	实现
身份层	每台机生成 `machineId` + 永久 SK，监听端口	`src/identity.js`、`src/listener.js`
信任层	人工添加（粘贴名片 / IP+SK），双向可移除	`src/card.js`、`src/roster.js`
授权层	任务执行凭临时 taskToken（HMAC 验签防伪造），worker 拥有最终否决权	`src/protocol.js`
控制面	会话/工作区指令、心跳资源上报、名片/端点上报	`src/peer.js`

信任基础：知道对方永久 SK = 被授权调用。SK 永不通过线路明文传输，握手用 challenge-response 证明持有。

📦 安装

作为 DSH 插件（推荐）

# 方式一：本地路径安装（无需 GitHub）
dsh plugin --profile web add "E:\DeepSeekHarness\dsh-fleet"

# 方式二：从 GitHub 安装（发布后）
dsh plugin --profile web add https://github.com/scriptsnet/dsh-fleet

重启 harness 后生效。 插件启动时：

自动生成机器身份（data\fleet\identity.json，随便携版目录带走）
监听端口 47900（被调用方 / worker 角色）
注册 12 个模型工具（见下表）
注册 /fleet/api/* 路由（仅回环可访问）供面板使用
侧边栏出现「算力舰队」面板：名片一键复制、多团队列表、新建团队、粘贴名片添加成员、联通测试、移除成员

一键安装器（目标机没有 harness 时）

installer/ 提供三种形态（任选其一，复制到目标机运行）：

文件	用法
`install.ps1`	`powershell -ExecutionPolicy Bypass -File install.ps1 -HarnessZip "D:\DeepSeek-Harness-便携版.zip"`
`install.bat`	双击，或带同样参数
`dsh-fleet-agent-installer.exe`	双击（ps2exe 封装）
`install.sh`	`bash install.sh [<插件目录>]`（Linux，含 systemd 自启）

🛠️ 工具一览（12 个）

工具	作用
`fleet_card`	展示本机名片（可复制字符串）
`fleet_teams`	查看所有团队：成员 / 在线 / 算力 / 内存 / RTT
`fleet_team_create`	创建团队
`fleet_team_delete`	删除团队（连同名录）
`fleet_add`	把一台机器加入团队（名片或 IP+SK，自动握手）
`fleet_remove`	从团队移除成员
`fleet_test`	联通性测试 + SK 挑战握手
`fleet_memberships`	查看本机加入了哪些团队（worker 视角）
`fleet_leave`	主动退出某个 master 的团队
`fleet_refuse` / `fleet_resume`	拒绝 / 恢复被调用（DND）
`fleet_dispatch`	派发任务到指定成员，worker 自动执行并回流结果

🚀 快速上手

组队

"查看我的机器名片"                    → fleet_card
"把这张名片加入 XX 团队"               → fleet_add
"有哪些团队？成员在线吗？"             → fleet_teams

也可以在侧边栏「算力舰队」面板点点点。

派发任务

用 fleet_dispatch 把任务发给「XX舰队」的成员：
- 任务提示语："用 bash 执行 echo hello 并输出结果"
- provider / model：deepseek-official / deepseek-v4-flash
- keyHint：inherit（worker 无 key 时用总机 key）或 self（worker 用自己的 key）

任务完成后返回：成员 / 任务 ID / 工作区 / 会话 ID / 完整回答 / 执行日志。worker 侧会话自动挂载到工作区，GUI 里可查看完整对话记录。

插件配置（`cordis.patch.yml`）

- id: dsh-fleet
  name: dsh-fleet
  config:
    port: 47900        # 监听端口
    # home: <路径>     # 身份/名录目录，默认 $DSH_HOME/fleet
    # listen: true     # false = 仅当 master，不对外监听

环境变量

变量	默认	说明
`DSH_FLEET_HOME`	`$DSH_HOME/fleet` 或 `~/.dsh/fleet`	身份与名录目录；本地多机模拟时分别为每台机指定
`DSH_FLEET_DISPOSE_AFTER_TASK`	`0`	`1` = 任务完成后立即 dispose 会话（从实时列表移除，刷新后恢复）；默认保留会话供 GUI 查看

🔌 协议

JSON-lines over TCP，握手：

server → challenge { nonce, machineId, name }     服务器自证身份 + 发挑战
client → auth     { machineId, name, proof }      proof = HMAC(服务器SK, nonce)
server → welcome | error(AUTH_FAILED)             服务器本地验签，SK 永不出本机
之后周期 ping / pong（pong 携带内存空闲等资源统计）

任务派发：submit_task { taskId, token, prompt, provider, model } → worker 验签 → 新建工作区 → 建 agent 会话 → 执行 → task_result 回流。token = HMAC(workerSK, taskId)，防伪造/重放。