dsh-team

把「团队 · 作业板」接进 DSH 的单包插件。一个包装齐四件事：

12 个 board_* 工具 —— agent 能查板、建单、认领、续租、交付、打回、播报、派工、上报能力。
4 个 sh_* 工具 —— sh_run / sh_read / sh_write / sh_list。副机 worker 会话默认没有 pwsh / read / write，这四个把能力补上（这是从 dsh-shell 合并进来的部分）。
GUI 面板 —— 侧栏「作业板」：任务表（筛选/搜索/展开详情/认领/交付/打回）、机器能力卡、一行派工、桌宠状态卡（可拖动、可拿捏尺寸）。
Host 路由 + Host 调度器 —— /api/board/ui/*（浏览器不直接跨网访问板子服务），以及 v1.1 起搬进 Host 后台的派发/终态回写（不再依赖浏览器开着）。

架构（v1.1）

派发权在 Host 一侧，浏览器只负责建单：

面板「派工」 ──POST /api/board/ui/create {dispatch:'auto'}──▶ 板子（queued）
                                                             │
Host 后台每 4 秒 dispatchOnce()：                             │
  1) POST /api/take   {task_id, machine:本机}   ← 原子占位，别的 Host 抢不到
  2) POST /api/remote-agent/ui/dispatch {goal,node,mode,workspace}
  3a) 成功 → POST /api/attach {task_id, remote_id, machine:执行机}
  3b) 失败 → POST /api/untake ← 放回队列，等下一轮或换机

Host 后台每 6 秒 syncRemote()：
  GET /api/remote-agent/ui/tasks → completed→done；failed/aborted/interrupted/rejected→failed
  POST /api/mark {task_id, status, note, remote_id}

这样做的原因：浏览器多开会重复派工、关页面就停，而 remote-agent 的 /dispatch 既不幂等也不等副机受理，所以必须由 Host 串行地做「原子占位 → 派发 → 回绑」，才能保证一件任务只有一台 Host 派出、且板上记录与远程任务对得上。

v1.1.1 的鉴权细节：/api/remote-agent/ui/* 跑在 DSH 的浏览器鉴权围栏后面（每请求问 connection.requestRejection），后台进程直接 fetch 一定 401 —— v1.1.0 就卡在这里。现在 Host 调度器先用 connection.authenticatedUrl() 把自己进程的 launch token 拼进一次 / 请求，换到会话 cookie（10 分钟缓存；遇到 401 自动重换一次），之后带着它调 remote-agent。不需要手工登录，也没有改动别人的插件。

副机的 nodeId 通常是 Windows 计算机名（desktop2gh05s7），而任务上写的是板子的别名（MB14）。调度器用插件里同一张 MACHINE_BY_HOSTNAME 表把两者对齐（忽略大小写与连字符），第一次取到节点列表时会把 nodeId→机器名 的对应关系写进 _runtime.log。

装

$dsh = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"

# 本地开发版
& $dsh plugin --profile desktop add 'file:D:\gp_video\dsh-team'

# 从 GitHub（装别人的/你自己的这份）
& $dsh plugin --profile desktop add 'github:shaot92-del/dsh-team'

装完确认 profile 的 package.json 里 dsh.profile.bundles 有 dsh-team 这一行，然后重启 DSH（Host 半边改动只有重启才生效；只改 lib/client.js 的话刷新页面即可）。

它需要一个板子服务。 本插件是客户端，数据来自一个 HTTP 任务板。仓库不含该服务；默认地址 http://127.0.0.1:8965，可用 boardUrl 指向你自己的实现。

v1.1 需要板子支持两个额外端点（/api/take 原子占位、/api/untake 放回），否则 Host 调度器会一直拿不到派发权、任务停在 queued（日志里会写 take failed）。只想要 v1.0 的行为，把 autoDispatch 关掉即可。

工具

工具	干什么
`board_status`	总览：待办/进行/完成/打回计数、机器在线、最近事件
`board_list`	列任务，可按 `status` / `machine` 过滤；默认取全量（v1.1 起不再只给 200 条）
`board_claim`	认领（挂到配置的 `machine` 名下）
`board_beat`	续租 + 写进度备注
`board_done`	交付（可带 `artifact`）
`board_fail`	打回（`blocked`）/ 失败（`failed`），必须写原因
`board_say`	往事件流播报一句
`board_dispatch`	选机 + 建单（`dryRun` 只预览）；v1.1 起建的单带 `dispatch:'auto'`，由 Host 自己派
`board_attach`	把远程任务号绑到板子任务，状态转 running
`board_caps`	看某台机器上报的配置清单
`board_assess`	本机工作能力评估（写 `~/.dsh-board/identity.json` 并上报板子）
`board_metrics`	各机器实时指标（内存/CPU/磁盘/运行时长）
`sh_run`	执行命令（Windows 用 pwsh，失败回退 powershell）；输出按 `maxOutputBytes` 流式限流
`sh_read`	读文本文件
`sh_write`	写文本文件（UTF-8 无 BOM，自动建父目录）
`sh_list`	列目录

面板

侧栏「作业板」→ 主面板。数据走 Host 半边的 /api/board/ui/*。

8 秒自动刷新；A+ 调字号（16/18/20px，存 localStorage）
行可展开：状态/机器/更新时间/进度/产物；展开后可填产物路径与备注，直接「交付」或「打回」
机器卡：在线状态、能力徽章、内存/CPU/磁盘、最近上报时间
桌宠：可拖、双击换尺寸、右键折叠成小条；立绘由 /api/board/ui/pet.png 提供

配置

写在 profile 的 cordis.patch.yml 里按 id 覆盖：

- id: team
  config:
    boardUrl: 'http://127.0.0.1:8965'
    machine: 'host'          # 副机改成 gt14 / mb14 / pc2
    token: ''                # 板子开了 GP_BOARD_TOKEN 时填同一个值
    petImage: ''             # 留空=用随包立绘 assets/pet.png
    allowedRoots: []         # sh_* 只允许访问这些目录（realpath 比较）；空=不限制。
                             # 注意这是路径白名单，不是沙箱：命令内容本身不受限
    shellTimeoutMs: 120000
    maxOutputBytes: 200000   # sh_run 流式保留的上限，超出只保留前 N 字节并标 truncated
    autoDispatch: true       # v1.1：Host 后台自动派发 + 终态回写；设 false 退回纯手动

自检

改完代码、装进 DSH 之前先跑：

node scripts/plugcheck.mjs

断言 11 项：apply() 不抛异常、16 个工具齐备、每个 output.render 返回 [{type:'text',text}]（裸字符串会毒化会话历史 —— 2026-10-27 这么崩过两次）、四条 GUI 路由存在（含面板派工用的 /api/board/ui/create）、任务标题取 t.title 且 goal 不被裁剪、agent 层工具与主工具共享同一份 allowedRoots、板子不可达时 board_caps 返回 ok:false；以及 v1.1 的 board_dispatch 带 dispatch:'auto'、Host 调度器真的走 take → dispatch → attach、 aborted 折成 failed、board_list 能看到 230 条、dispose() 清掉 4 个定时器。全程 stubFetch，不连真板子。

真板子相关的验收（真派发、多机、桌宠）走 scripts/acceptance.mjs，需要板子服务和本机媒体素材。

许可

MIT。

dsh-team

把「团队 · 作业板」接进 DSH 的单包插件。一个包装齐四件事：

12 个 board_* 工具 —— agent 能查板、建单、认领、续租、交付、打回、播报、派工、上报能力。
4 个 sh_* 工具 —— sh_run / sh_read / sh_write / sh_list。副机 worker 会话默认没有 pwsh / read / write，这四个把能力补上（这是从 dsh-shell 合并进来的部分）。
GUI 面板 —— 侧栏「作业板」：任务表（筛选/搜索/展开详情/认领/交付/打回）、机器能力卡、一行派工、桌宠状态卡（可拖动、可拿捏尺寸）。
Host 路由 + Host 调度器 —— /api/board/ui/*（浏览器不直接跨网访问板子服务），以及 v1.1 起搬进 Host 后台的派发/终态回写（不再依赖浏览器开着）。

架构（v1.1）

派发权在 Host 一侧，浏览器只负责建单：

面板「派工」 ──POST /api/board/ui/create {dispatch:'auto'}──▶ 板子（queued）
                                                             │
Host 后台每 4 秒 dispatchOnce()：                             │
  1) POST /api/take   {task_id, machine:本机}   ← 原子占位，别的 Host 抢不到
  2) POST /api/remote-agent/ui/dispatch {goal,node,mode,workspace}
  3a) 成功 → POST /api/attach {task_id, remote_id, machine:执行机}
  3b) 失败 → POST /api/untake ← 放回队列，等下一轮或换机

Host 后台每 6 秒 syncRemote()：
  GET /api/remote-agent/ui/tasks → completed→done；failed/aborted/interrupted/rejected→failed
  POST /api/mark {task_id, status, note, remote_id}

v1.1.1 的鉴权细节：/api/remote-agent/ui/* 跑在 DSH 的浏览器鉴权围栏后面（每请求问 connection.requestRejection），后台进程直接 fetch 一定 401 —— v1.1.0 就卡在这里。现在 Host 调度器先用 connection.authenticatedUrl() 把自己进程的 launch token 拼进一次 / 请求，换到会话 cookie（10 分钟缓存；遇到 401 自动重换一次），之后带着它调 remote-agent。不需要手工登录，也没有改动别人的插件。

副机的 nodeId 通常是 Windows 计算机名（desktop2gh05s7），而任务上写的是板子的别名（MB14）。调度器用插件里同一张 MACHINE_BY_HOSTNAME 表把两者对齐（忽略大小写与连字符），第一次取到节点列表时会把 nodeId→机器名 的对应关系写进 _runtime.log。

装

$dsh = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"

# 本地开发版
& $dsh plugin --profile desktop add 'file:D:\gp_video\dsh-team'

# 从 GitHub（装别人的/你自己的这份）
& $dsh plugin --profile desktop add 'github:shaot92-del/dsh-team'

它需要一个板子服务。 本插件是客户端，数据来自一个 HTTP 任务板。仓库不含该服务；默认地址 http://127.0.0.1:8965，可用 boardUrl 指向你自己的实现。

v1.1 需要板子支持两个额外端点（/api/take 原子占位、/api/untake 放回），否则 Host 调度器会一直拿不到派发权、任务停在 queued（日志里会写 take failed）。只想要 v1.0 的行为，把 autoDispatch 关掉即可。

工具

工具	干什么
`board_status`	总览：待办/进行/完成/打回计数、机器在线、最近事件
`board_list`	列任务，可按 `status` / `machine` 过滤；默认取全量（v1.1 起不再只给 200 条）
`board_claim`	认领（挂到配置的 `machine` 名下）
`board_beat`	续租 + 写进度备注
`board_done`	交付（可带 `artifact`）
`board_fail`	打回（`blocked`）/ 失败（`failed`），必须写原因
`board_say`	往事件流播报一句
`board_dispatch`	选机 + 建单（`dryRun` 只预览）；v1.1 起建的单带 `dispatch:'auto'`，由 Host 自己派
`board_attach`	把远程任务号绑到板子任务，状态转 running
`board_caps`	看某台机器上报的配置清单
`board_assess`	本机工作能力评估（写 `~/.dsh-board/identity.json` 并上报板子）
`board_metrics`	各机器实时指标（内存/CPU/磁盘/运行时长）
`sh_run`	执行命令（Windows 用 pwsh，失败回退 powershell）；输出按 `maxOutputBytes` 流式限流
`sh_read`	读文本文件
`sh_write`	写文本文件（UTF-8 无 BOM，自动建父目录）
`sh_list`	列目录

面板

侧栏「作业板」→ 主面板。数据走 Host 半边的 /api/board/ui/*。

8 秒自动刷新；A+ 调字号（16/18/20px，存 localStorage）
行可展开：状态/机器/更新时间/进度/产物；展开后可填产物路径与备注，直接「交付」或「打回」
机器卡：在线状态、能力徽章、内存/CPU/磁盘、最近上报时间
桌宠：可拖、双击换尺寸、右键折叠成小条；立绘由 /api/board/ui/pet.png 提供

配置

写在 profile 的 cordis.patch.yml 里按 id 覆盖：

- id: team
  config:
    boardUrl: 'http://127.0.0.1:8965'
    machine: 'host'          # 副机改成 gt14 / mb14 / pc2
    token: ''                # 板子开了 GP_BOARD_TOKEN 时填同一个值
    petImage: ''             # 留空=用随包立绘 assets/pet.png
    allowedRoots: []         # sh_* 只允许访问这些目录（realpath 比较）；空=不限制。
                             # 注意这是路径白名单，不是沙箱：命令内容本身不受限
    shellTimeoutMs: 120000
    maxOutputBytes: 200000   # sh_run 流式保留的上限，超出只保留前 N 字节并标 truncated
    autoDispatch: true       # v1.1：Host 后台自动派发 + 终态回写；设 false 退回纯手动

自检

改完代码、装进 DSH 之前先跑：

node scripts/plugcheck.mjs

真板子相关的验收（真派发、多机、桌宠）走 scripts/acceptance.mjs，需要板子服务和本机媒体素材。

许可

MIT。

shaot92-del/dsh-team

dsh-team

架构（v1.1）

装

工具

面板

配置

自检

许可

Community comments

shaot92-del/dsh-team

dsh-team

架构（v1.1）

装

工具

面板

配置

自检

许可

Community comments