前言¶
在 DeepSeek Harness (DSH) 的使用场景中，本地多项目并行开发或远程集群管理往往伴随着标签页混乱与状态盲区。手动频繁切换网页不仅影响效率，也难以实时掌握各实例 Agent 的运行进度。
dsh-server-hub 是一个为 DSH Web 设计的持久化多实例切换插件。它通过零配置的本地端口扫描自动发现实例，将所有本地及通过 SSH 隧道映射的 DSH 端点聚合进同一个工作台，支持后台热切、全矩阵状态雷达与全局桌面通知。
核心能力¶
Zero-Config Auto Discovery (智能本地扫描)
插件原生探测本机 TCP 监听端口，自动识别本地启动的其他 DSH 实例，或通过 SSH 隧道映射到本机的远程实例，无需繁琐配置。
Seamless Hot Switching (常驻 Iframe 后台热载)
所有实例在后台保持挂载，切换标签时不会重新加载页面，保留上下文、聊天记录与输入框草稿。
Status Radar (全矩阵 Agent 状态雷达)
提供全局 Agent 状态视图，直观展示各实例的工作进度、等待确认及完成状态。
Smart Browser Tab (浏览器标签页智能同步)
浏览器标签页标题会根据 Agent 状态动态变化（如显示旋转字符或等待标记），无需切回页面即可感知后台状态。
Desktop Notifications (全局桌面被动唤醒)
在需要人工授权或任务完成时，向系统推送通知，减少手动巡检频率。
Remote Agents (远程 Agent 跨实例协作)
主控与远程均安装插件后，选择允许执行的工作区并连接，即可在主控聊天中向其他实例派出任务，接收结果回传。
安装与使用¶
安装插件
在主控或被监控实例上执行以下命令：
dsh plugin --profile web add github:ginkgonine/dsh-server-hub
安装后重启 dsh web。
启用 Hub 面板
在主控 DSH 实例上安装插件以启用 Hub 面板与智能发现。插件会自动扫描本地端口。
配置远程实例
若需管理远程服务器，通过 SSH 隧道将远程 DSH 端口映射到本地（例如 ssh -N -L 3101:127.0.0.1:3080 user@server），Hub 即可自动发现并聚合该远程实例。
命名与授权
在 Hub 标签中为实例命名（如 本地-电商重构、A100-训练机），并在工具栏授权桌面通知权限。
注意事项¶
隐私
状态总览 API 仅返回轻量聚合数据（如工作任务数、等待确认数等），不传输聊天记录、提示词或输出日志。
安全
状态总览 API 仅接受 Loopback GET/HEAD 请求。
兼容性
需要 DSH 0.2.x+ 和 Node.js ^22.19.0 || >=24.0.0。
反向代理
不要将状态桥接端点放在会将外部请求转换成 Loopback 的代理后面。
