MIT 许可的 TypeScript 插件,给一个完全不用改动的回环 DeepSeek Harness 套上 HTTPS、密码登录与二维码 / 8 位配对码设备配对,并提供 mDNS 发现、按设备吊销和两台电脑之间的一键关联。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-16
许可证
MIT
01它能帮你完成什么?
不用把 Harness 暴露给整个 Wi-Fi,也能用手机或另一台电脑访问它
中继端口上的 TLS、密码校验与设备配对,而 Harness 始终留在 127.0.0.1 上——中继挂掉时 Harness 只是不可达,而不是被暴露
在笔记本或台式机上跑 Harness Web 配置、希望手机或平板能用上(或经端口转发从外网访问)、又不想把 Harness 绑到 0.0.0.0 的人
一台一台地配对设备,之后随时单独掐断其中任意一台
`/relay/devices` 里带名字、持有独立 token 的设备,可单独吊销的能力,以及会轮换签名密钥的「全部退出登录」按钮
把同一个中继分给手机、平板和第二台电脑使用、希望每台都能单独吊销的人
把两台电脑关联起来,任意一台都能一键打开另一台的 Harness
两侧 Computers 页面都会列出这条关联,**Open** 会给当前浏览器签发一次性登录,直接落到另一台电脑的 Harness 而无需重输密码
同时有台式机和笔记本、两台都装了 dsh-relay,并且用浏览器而不是桌面应用的人
02如何接入 DeepSeek Harness?
前置条件
- 带 Web 配置的 DeepSeek Harness —— 中继是该配置的插件,桌面应用运行的是同一个配置
- Harness 仍留在回环地址:删掉 `~/.dsh/profiles/web/cordis.patch.yml` 里把它绑到 `0.0.0.0` 的那一行,因为中继不会在一个已经开放到网络上的 Harness 前面启动
- `dsh` 在 PATH 上,否则每条命令都改用 `npx @deepseek-ai/dsh ...`
- 与 Harness 匹配的中继版本 —— Harness 0.1.7-rc.2 到 0.2.x 用 0.3
安装步骤
- 01
在 Harness 里:侧边栏 **Plugins** → **Add plugin** → 粘贴 `https://github.com/sorsama/deepseek-harness-relay` → **Install**
- 02
pnpm 询问 git 包的构建脚本时选择 **Allow these scripts and retry**;构建完成后选择 **Enable now**
- 03
终端方式:`dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay`;桌面应用改为 `dsh plugin --profile desktop add https://github.com/sorsama/deepseek-harness-relay`
$ dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay
- 04
也可以装已构建好的包:`dsh plugin --profile web add dsh-relay` —— 同一份代码并带 `lib/`,不执行任何构建脚本
$ dsh plugin --profile web add dsh-relay
- 05
在运行 Harness 的那台机器上打开 `https://127.0.0.1:3443/relay/password` 设置第一个密码,再到 `https://127.0.0.1:3443/relay/pair` 用二维码或 8 位配对码配对手机
验证接入成功
- `https://127.0.0.1:3443/relay/health` 在中继启动后会有响应
- Harness 启动时会打印中继地址;桌面应用在启用插件后需要退出重开
- 配对的手机会带着你给的名字出现在 `/relay/devices` 下
03DSH 适配与能力边界
Harness Web 配置的原生 DSH 插件 —— 用 `dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay` 安装后,它在 :3443 上自建监听,并往 Harness 界面加入 **Relay** 操作、一组 `/relay/*` 页面和 **Plugins → dsh-relay → Configure** 设置页
TLS 终止与密码登录
来自网络上手机或浏览器的 HTTPS 请求→只有密码(或已配对设备的凭据)通过后才建立会话;错误次数过多会临时锁定该地址
Harness 留在回环地址上,中继作为它旁边的第二个监听端口运行二维码 / 8 位配对码设备配对
扫码,或在手机上输入 8 位配对码,再给设备起个名字→`/relay/devices` 下带名字、持有独立 token 的设备
配对后的设备会记录在 `/relay/devices`,可以单独吊销mDNS 发现(`_dsh._tcp`)
中继在 `_dsh._tcp` 上广播,App 不必扫描网段就能找到它
Harness 界面内的 Relay 页面
原样的 Harness 界面,外加角落的 **Relay** 链接与侧边栏底部的 **Relay** 操作
按 **Relay** 会让当前应用原地切换到中继的配对、设备与密码页面,仍在同一个窗口里Computers:两台电脑之间的一键关联
另一台电脑的地址、配对码与证书指纹→两侧 Computers 页面都列出这条关联,**Open** 用一次性登录把当前浏览器送到另一台 Harness
关联会同时记录在两台电脑上,任意一侧 **Unlink** 都能结束它
04适合谁?何时不该用?
适合
- 在笔记本或台式机上跑 Harness Web 配置、希望手机或平板能用上(或经端口转发从外网访问)、又不想把 Harness 绑到 0.0.0.0 的人
- 把同一个中继分给手机、平板和第二台电脑使用、希望每台都能单独吊销的人
- 同时有台式机和笔记本、两台都装了 dsh-relay,并且用浏览器而不是桌面应用的人
不适合
- 中继只在 Harness 留在回环地址时成立:如果发现 Harness 已经在网络地址上监听,它会拒绝启动;同时它把回环当作你本人,所以在 `127.0.0.1:3443` 前面再套一层回环代理(Tailscale Funnel / Serve、nginx、Caddy)就完全不会要求密码。
- 桌面应用里绝不要从 Harness 自己的端口加一条指向中继源的跳转:应用窗口无法完成到中继自签名证书的跳转,而这个失败对应用是致命的。桌面应用也完全无法加载远程 Harness。
- Harness 与中继的版本必须匹配:README 把 Harness 0.1.7-rc.2 到 0.2.x 对应到 dsh-relay 0.3,版本范围不符时 Harness 会拒绝加载该插件。
- 0.8.0 之前的 DSH Mobile 完全不发送凭据,中继只能靠记住手机的网络地址放行——README 明确说这不是真正的认证。另外那条纯 HTTP 监听(`DSH_RELAY_PLAIN_PORT`)没有登录与配对页面,也永远访问不到 Harness 的设置与凭据。
05兼容性、维护与安全提示
- 中继只在 Harness 留在回环地址时成立:如果发现 Harness 已经在网络地址上监听,它会拒绝启动;同时它把回环当作你本人,所以在 `127.0.0.1:3443` 前面再套一层回环代理(Tailscale Funnel / Serve、nginx、Caddy)就完全不会要求密码。
- 桌面应用里绝不要从 Harness 自己的端口加一条指向中继源的跳转:应用窗口无法完成到中继自签名证书的跳转,而这个失败对应用是致命的。桌面应用也完全无法加载远程 Harness。
- Harness 与中继的版本必须匹配:README 把 Harness 0.1.7-rc.2 到 0.2.x 对应到 dsh-relay 0.3,版本范围不符时 Harness 会拒绝加载该插件。
- 0.8.0 之前的 DSH Mobile 完全不发送凭据,中继只能靠记住手机的网络地址放行——README 明确说这不是真正的认证。另外那条纯 HTTP 监听(`DSH_RELAY_PLAIN_PORT`)没有登录与配对页面,也永远访问不到 Harness 的设置与凭据。
MIT · 最新发布 v0.4.0(2026-11-09)· 活跃维护,README 在 Harness 0.1.7-rc.2 到 0.2.x 上实测
06常见问题
怎么把 dsh-relay 装进 DeepSeek Harness?
在侧边栏打开 **Plugins**,选 **Add plugin**,粘贴 `https://github.com/sorsama/deepseek-harness-relay` 后点 **Install**。首次安装会在临时副本里构建插件,所以 pnpm 询问时要选 **Allow these scripts and retry**,完成后选 **Enable now**。终端里同一个地址也能用:`dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay`(桌面应用换成 `--profile desktop`);想要已构建好的包则用 `dsh plugin --profile web add dsh-relay`,它不执行构建脚本。
它对应哪个 Harness 版本?
README 的表格把 Harness 0.1.7-rc.2 到 0.2.x 对应到 dsh-relay 0.3(在 0.2.1-rc.3、0.2.0-rc.2 与 0.1.7-rc.2 上实测过)。版本不匹配时 Harness 会拒绝加载,并告诉你它需要哪个范围:0.3 依赖 Harness 0.1.7 才有的设置系统,而 0.2 会让 0.1.7 及以后的 Web 应用卡住。
还没设密码时,网络里的人会不会先占用中继?
不会。密码还不存在时,这个页面只能从运行 Harness 的那台机器打开。而那台机器本身也不需要密码:中继把回环当作你本人,因为能坐到那个键盘前的人本来就有 shell。
配对后的设备能做什么,怎么切断?
每台配对设备有自己的 token,会出现在 `/relay/devices` 里,可以单独吊销。配对码一次性使用、五分钟后失效,而且只能在运行 Harness 的那台机器上生成。**全部退出登录** 按钮会轮换签名密钥,一次性把所有浏览器与设备踢下线。
能放在 Tailscale、nginx 或 Caddy 后面吗?
不要。这些代理都从回环连进来,而中继把回环当作你本人,因此不会向任何人索要密码。要暴露到公网,README 的建议是:只转发中继的端口、绝不转发 Harness 的端口;用真实证书;设置 `compat.addressGrants: false` 与 `privilegedMethods: loopback-only`。也不要在 Harness 自己的端口上加指向中继源的跳转:桌面应用窗口无法完成到中继自签名证书的跳转,而这个失败对应用是致命的。
07相关的 DSH 工作流
dsh-im
作者 xmanrui
通过扫码或机器人凭据把IM机器人接入DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord和WhatsApp)。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
dsh-aurabot-qq
作者 aureth-labs
让 DeepSeek Harness 里的 AI 以「大肥鱼」住进 QQ:会聊天、发表情、发语音、记事、发空间、刷 B 站、唱歌。功能都是模块,能开关、能自己写,还能从模块市场装更多(SnowLuma / OneBot v11)。
dsh-qqbot
作者 tencent-connect
让 QQ Bot 接入 DeepSeek Harness(dsh)的官方插件
dsh-wechat
作者 xcisxc29
DeepSeek Harness 微信频道
08数据与来源
dsh-relay is a plugin for the harness's web profile.
dsh plugin --profile web add https://github.com/sorsama/deepseek-harness-relay
A settings page at **Plugins → dsh-relay → Configure** on the machine running the harness. Changes apply when you press…
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
