前言¶

DeepSeek Harness（DSH）可以在本机桌面或 dsh web 里管理智能体工作区与会话。若你在局域网或云上还有几台正在跑的 dsh，常见做法是每台单独开浏览器标签，或在 SSH 隧道里切地址。切换成本高，侧栏也无法一眼看到「哪台机器上还有哪些会话」。dsh-peerbar 由社区维护者 observer130 发布，目标是把本机与各远端的 dsh 收进同一个官方前端：工作区与会话混排在官方侧栏，点哪条就在官方中栏跟哪台交互，实际执行仍发生在对应远端进程上。

这是什么¶

dsh-peerbar 是 DSH 社区插件（仓库 observer130/dsh-peerbar），当前 package 版本为 1.2.0，许可证 MIT。它通过 HTTP/TLS 直连各远端 dsh，不需要 SSH 隧道；远端实例不必安装本插件，只要地址可直达且持有访问令牌即可。

核心功能¶

下面介绍 README 中已说明、且与实现描述一致的能力。

统一侧栏与按主机分组¶

本机与各远端的工作区、会话出现在官方侧栏同一列表里。侧栏顶层是多行可折叠分组（本机用显示器图标、远端用云图标），展开后是该主机下的工作区条目。选中远端会话时，由官方中栏渲染界面，消息下发、停止、改名等写操作在远端 dsh 上执行。

「远程主机」设置¶

在设置里提供「远程工作区 / 远程主机」相关界面：每台主机一张卡片，展示在线状态、延迟、凭据是否有效，并支持刷新、更新令牌、删除；卡片下方有「添加」，弹窗填写名称、地址与令牌。

状态与缓存¶

设置页可集中查看各 Host 的在线、延迟与凭据状态。远端工作区信息读取失败时，侧栏仍可能保留此前缓存的标题，避免列表瞬间空白。

适配版本¶

安装与启用¶

安装方式以仓库 README 为准，不要凭插件名自行拼接 CLI 安装命令。

从 GitHub 安装（推荐）¶

1. 打开 DSH Desktop → 侧栏 插件 → 右上 添加插件
2. 输入仓库地址，点 安装：

https://github.com/observer130/dsh-peerbar

3. 安装完成后点 立即启用（或打开插件卡片上的开关）。侧栏出现「本机 / 远端主机」一类分组即表示已生效。

从本地目录安装（开发用）¶

1. 侧栏 插件 → 右上 添加插件
2. 填写本仓库在本地的绝对路径
3. 安装后同样 立即启用

仓库根目录即为安装器使用的组合包，按 commit 打包；发布说明见 README「发布说明」一节。

典型用法¶

经过上面的安装与启用，按下面步骤添加第一台远端 Host。

1. 打开 设置 → 远程工作区（或 README 中的等价入口），添加 Host：名称、地址（示例格式如 https://10.0.0.10:3080）、访问令牌。
2. 令牌即远端 dsh 启动后浏览器 URL 里 ?token= 后面的字符串。
3. 若远端使用自签证书，可在该 Host 上勾选「跳过证书校验」——README 明确建议仅在内网使用；更稳妥的做法是给系统信任根证书，或在配置中使用 caFile 指定 CA（详见 README「注意事项」）。

凭据与换来的 cookie 保存在本机 ~/.dsh/dsh-peerbar.json（权限 0600），不会向界面回传明文令牌。

适用场景与注意事项¶

适合谁：需要在同一 DSH 桌面或 Web 前端里切换多台 dsh（本机 + 局域网/可达云主机），且各远端已独立运行、网络可直连的场景。

权限与安全：插件随当前 DSH 进程运行，对远端发起的操作具备该令牌对应权限；安装前请自行审阅源码与 MIT 许可证。README 强调：会在远端执行写操作（发消息、停止、改名、归档/置顶、分叉、新建/删除工作区等）。

能力与边界（均来自 README）：

• 不搬运文件内容：远端会话里的文件引用只做提示，不会在本机打开同名文件；查看内容请用右侧「文件」面板（只读，直接读远端）。
• 不做中转与 NAT 穿透：只支持可直达地址。
• 远端 localhost 链接：从聊天区经「侧边栏打开」时会被拦截并复制地址，避免误开本机同名端口；本机浏览器仍无法直接打开远端服务，端口转发不在本项目范围内。

社区插件目录页：skillhub.cn/plugins/observer130/dsh-peerbar。该站点为社区生态索引，与 DeepSeek / 幻方无官方从属关系；问题与更新以 GitHub 仓库为准：https://github.com/observer130/dsh-peerbar。