dsh-link-plugin
把本机运行的 DeepSeek Harness (dsh) 安全地连接到 dsh 社区网站(dsh.cbnac.com),从浏览器远程安装插件、看看商店注册表,离线也能浏览可安装条目。
> 它是 dsh 的社区远程连接插件:由本机插件主动连出到服务器的 WebSocket 网关,网站下发指令后由本机自己执行 dsh plugin add,因此安装动作始终发生在你的机器上。
安装
在你的 dsh profile 中安装:
dsh plugin --profile web add "github:qwert702/dsh-link-plugin#main"配置
在 dsh Web UI 的插件设置里填写:
| 字段 | 说明 |
|---|---|
serverUrl | WebSocket 服务器地址,默认 wss://dsh.cbnac.com/ws/harness |
pairingCode | 一次性配对码(在网站「远程控制台」生成,15 分钟有效) |
profile | 要管理的 profile,默认 web |
requireConfirm | 收到安装指令时确认(当前无交互确认 UI,默认自动接受) |
autoStart | 启动 dsh 时自动连接 |
首次连接成功后,插件会把 token 与 deviceId 持久化到 ~/.dsh/src-state-link.json,之后断线重连自动恢复。
配对流程
1. 在 dsh.cbnac.com/console 登录并点击「生成配对码」。 2. 在 dsh-link-plugin 设置里填入 serverUrl + 配对码 + profile。 3. 保存后插件自动连接并握手;回到控制台即可看到设备上线、已装插件列表。 4. 在插件详情页点「远程安装」,选择设备,本机执行安装,控制台显示进度。
安全模型
- 白名单安装:安装源
spec必须是商店注册表中approved/manual的行(GET /api/plugins/registry.json),本地二次校验。 - 拒绝危险输入:
./、../、file:、link:以及含&&;|空格/引号等字符的指令一律拦截。 - 令牌安全:设备令牌在服务器只存 sha256 哈希;指令仅设备所有者可下发;链路经 TLS(wss)。
- 了解风险:安装一个插件会运行其构建脚本(prepare)。只从你信任的来源安装。
离线商店
插件连接服务器时会缓存一份注册表(5 秒内重复拉取会被跳过,离线沿用旧缓存)。即使断网,你在 dsh Web UI 中也能看到可安装条目。
开发
cd packages/dsh-link-plugin
pnpm install
node --test test/许可证
MIT