前言¶
DeepSeek Harness (dsh) 采用“一切皆插件”的设计理念。本地安装和更新插件通常需要执行命令行操作。dsh-link-plugin 允许本地运行的 dsh 实例通过 WebSocket 网关主动连接到 dsh 社区网站。这使得浏览器可以作为控制端，远程管理本地插件、查看商店注册表，并支持在断网环境下浏览可安装条目。
核心功能¶
- 安全连接本机运行的 DeepSeek Harness (dsh) 到 dsh 社区网站。
- 从浏览器远程安装插件。
- 查看商店注册表。
- 支持离线浏览可安装条目。
安装与启用¶
在 dsh 的 profile 中执行以下命令安装插件：
dsh plugin --profile web add "github:qwert702/dsh-link-plugin#main"
安装后，插件会出现在 dsh Web UI 的插件设置中。
配置¶
在 dsh Web UI 的插件设置里，需要填写以下字段：
| 字段 | 说明 |
|---|---|
serverUrl |
WebSocket 服务器地址，默认为 wss://dsh.cbnac.com/ws/harness |
pairingCode |
一次性配对码，用于首次连接验证 |
profile |
要管理的 profile，默认为 web |
requireConfirm |
收到安装指令时是否确认（当前无交互确认 UI，默认自动接受） |
autoStart |
启动 dsh 时是否自动连接 |
首次连接成功后，插件会将 token 与 deviceId 持久化到 ~/.dsh/src-state-link.json，断线重连时会自动恢复。
配对流程¶
- 在 dsh.cbnac.com/console 登录并点击「生成配对码」。
- 在 dsh-link-plugin 设置里填入
serverUrl、pairingCode和profile，保存配置。 - 插件会自动尝试连接并完成握手。此时返回控制台，即可看到设备上线及已安装插件列表。
- 在插件详情页点击「远程安装」，选择设备，本机会执行安装指令，控制台显示进度。
安全模型¶
该插件通过严格的校验机制保障本地环境安全：
- 白名单安装：安装源
spec必须是商店注册表中approved/manual的行，本地会进行二次校验。 - 拒绝危险输入：
./、../、file:、link:以及含&&;|空格/引号等字符的指令一律被拦截。 - 令牌安全：设备令牌在服务器只存 SHA256 哈希；指令仅设备所有者可下发；链路经 TLS (wss) 加密。
- 了解风险：安装一个插件会运行其构建脚本 (prepare)。安装前请检查源码与许可证。
离线浏览¶
插件连接服务器时会缓存一份注册表。如果 5 秒内重复拉取，服务器会跳过请求并沿用旧缓存。即使断网，在 dsh Web UI 中也能看到可安装条目。
结尾¶
dsh-link-plugin 为 DSH 提供了远程管理能力，适合需要在 Web 端批量管理插件或通过浏览器控制本机 dsh 实例的场景。该插件遵循 MIT 许可证，由社区开发者维护。
