dsh-bridge
wenbin-wb/dsh-bridge
DeepSeek Harness 远程与移动端接入插件:提供局域网扫码直连、Cloudflare 与自建公网隧道,以及微信、QQ、飞书、Telegram 机器人交互,内置安全认证与访问控制。
安装
把 dsh-bridge 装进 DeepSeek Harness
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
桌面版有自己的 profile,叫 desktop,只认它自带的 dsh 命令——npm 装的 dsh 会直接拒掉这个 profile。先在应用菜单里点 Manage dsh Command… 装上这个命令,打开一次桌面版再彻底退出,跑下面这条,然后重新打开桌面版。
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们的实装是在 npm 版 dsh 的 web profile 里跑的,没在桌面版上跑过。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前,DeepSeek Harness 0.2.2-rc.1.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 dsh-bridge 之前,先看这几条
- 源码在这里: wenbin-wb/dsh-bridge——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
安全
装 dsh-bridge 会执行什么
- 构建脚本
我们这次实装里没有构建脚本被拦。
来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.1,11 天前。
- 安装钩子
package.json 里没有 preinstall / install / postinstall 脚本。
来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。
- README 里提到
shell 命令(bash、exec、spawn 之类);API key、token 或密码
来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。
这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。
AI 锐评
是什么 — dsh-bridge 为 DeepSeek Harness 提供远程连接和移动访问。
谁该装 — 当需要在手机上通过扫码远程使用 DeepSeek Harness 时,可安装 dsh-bridge。 如果用户主要在本地运行而不涉及远程或移动端支持,则可以不安装。
注意 — 沙箱实测通过:在全新 profile 里装上并被 harness 注册进 profile。 需要提供 API key 或 token,并会执行 shell 命令。 没发现明显的坑。
锐评 — 我会安装它,因为它支持 LAN QR code 连接和 Cloudflare/custom tunnels。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
dsh-bridge 是做什么的

dsh-bridge 是一个用于远程访问和控制 DeepSeek Harness 的 DeepSeek Harness 插件,支持局域网扫码、手机网页与 PWA,以及 Cloudflare 或自建公网隧道,还能通过微信、QQ、飞书和 Telegram 机器人继续处理会话。
DeepSeek Harness 插件启动后会建立局域网反向代理,探测 Wi-Fi、以太网及虚拟网卡,并把远程请求转发到本机服务。代理会自动注入绑定 127.0.0.1 的会话 cookie,因此手机端不必手动处理 DSH 启动地址中的 ?token=。远程访问页提供工作区选择;机器人支持多工作区会话、审批、文件双向传输和跨重启持久化。访问控制包括二维码 token、外部访问密码和独立的管理员锁,终端可用 reset-auth 紧急重置。
这个插件适合需要离开电脑后继续调度 agent、执行任务或管理工作区的场景。若服务必须只在本机使用,或不应把终端、工作区和任务执行权限交给远程入口,则不应安装。Cloudflare 固定域名和各 IM 通道需要相应凭据;运行还要求 Node.js 22.19+ 或 24+ 以及可用的 dsh CLI。DeepSeek Harness 插件本身会触及本地服务及其工作区,远程客户端的权限范围应先行评估。
dsh-bridge 的文档
dsh-bridge 的行为说明
DeepSeek Harness 在 web profile 中加载 dsh-bridge。服务启动时,dsh-bridge 自动开启局域网代理,识别物理与虚拟网卡并生成二维码入口。反向代理把请求转发给本机 DeepSeek Harness 服务,同时注入回环会话 cookie;远程端不需要使用带 ?token= 的启动地址。Cloudflare 可使用临时域名、带 Cloudflare Token 的固定域名或自建公网隧道,通道使用 SSE 并带空闲保活。插件还通过 /ready 检查 DNS、TLS、边缘和回源连通性。
dsh-bridge 的配置
在 DeepSeek Harness 设置中的「远程访问」面板配置局域网、隧道、认证、IM 通道和工作区。全局配置支持 JSON 导出与恢复。README 未列出具体配置 key 或存储路径。认证包含二维码 token、外部访问密码和独立管理员锁;127.0.0.1 具有最高权限。
dsh-bridge 的命令
终端命令 reset-auth 用于恢复认证。远程 IM 可用 /addworkspace 注册工作区,用 /diff 导出本轮文件改动的 .patch 文件。机器人支持跨重启会话、审批和文件双向传输。
dsh-bridge 的环境要求与限制
DeepSeek Harness 要求 Node.js 22.19.0 以上的 22.x,或 24.0.0 以上,并且 dsh CLI 可用。web 与 desktop profile 需要分别安装插件。固定 Cloudflare 域名和各机器人通道需要对应凭据;远程入口也会触及 agent 的任务执行、终端和工作区权限。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
dsh-bridge 的同类插件
dsh-remote-web-ui
zhu1090093659
手机/PC 远程操控 dsh web 工作区:扫码配对、令牌门控通道、SSE 实时同步,提供移动端与完整桌面 GUI 两种远程形态。
我们跑过,装得上
ds-harness-remote
liguobao
通过端到端加密通道远程访问 DeepSeek Harness 及兼容的编码工作区,支持自适应 Relay/WebRTC 传输、设备授权、工作区文件、只读预览、终端和可选的 Codex Remote。
我们跑过,装得上
deepseek-harness-remote
liguobao
DeepSeek Harness 多端远程访问:从手机、平板、浏览器或另一台电脑继续进行中的会话,端到端加密通道(Noise IK + 自适应 Relay/WebRTC 传输),设备授权管理;远程端仅开放 ApiProxy 能力,支持 dsh-file-viewer 只读文件预览,不提供 Shell、远程桌面或写入权限。
我们跑过,装得上
dsh-mobile
saya-ch
通过 Android App 或手机浏览器访问 DeepSeek Harness,支持安全局域网连接、远程访问、持久设备配对和可自定义移动界面。
我们跑过,装得上