DeepSeek Harness 跑在电脑上,人却经常不在电脑前。dsh-bridge 这个插件的定位很直白:把本机 DSH 延伸出去,让你在手机、平板,甚至在微信、QQ、飞书、Telegram 里继续用它干活。它不要求你自建公网服务器,装完之后在设置面板找到「远程访问」,剩下的基本就是扫码与点选。
这篇只讲落地形态:配好之后你的工作台会长成什么样,日常怎么用。
一次配置,三个入口
插件启动后会自动随服务开启局域网代理,控制台给出二维码与访问 URL。同一 Wi-Fi 下用手机相机扫一下,就能打开移动端界面。控制台里还有一个「🛜 局域网网卡 / IP 选择」下拉框——当主机上同时存在物理 Wi-Fi、以太网和 WSL、VMware、Docker 这类虚拟网卡时,它会自动探测、评分并高亮推荐物理网卡;切换之后二维码与 URL 秒级重新生成,并且持久化保存。
于是同一台 DSH,实际有三类入口:
- 局域网网页:同一 Wi-Fi 下直接访问,适合家里与办公室。
- 公网隧道:外出、跨网段时使用,无需公网 IP 与路由器端口映射。
- IM 机器人:把指令发进聊天软件,不必打开浏览器。
三种入口共用同一套会话与工作区,切换入口不需要重新开始。
PWA:把网页变成没有地址栏的 App
移动端界面做的是「手机优先」的排版:极简顶栏、复用 DSH 原生侧边栏抽屉与 [| 收起图标、底部工具栏按屏幕宽度自适应,避免权限预设与模型选择器互相重叠。
真正的分水岭是 PWA。在手机浏览器菜单里点「添加到主屏幕」,之后从图标进入的是一个无地址栏、无底栏的独立全屏应用,观感接近原生 App。对于「随手看一眼 Agent 跑到哪了」这种高频动作,这点差别很实在。
远程工作区:本机弹窗,远程抽屉
在手机上点「添加工作区」时,浏览器无法唤起电脑本机的文件弹窗。插件对此做了智能分流:
- 电脑本机访问(
127.0.0.1)时,点击仍然走系统原生文件选择窗口,习惯不变; - 手机或远程浏览器访问时,自动弹出响应式的树形目录抽屉。
树形抽屉支持 Windows 盘符(C 盘、D 盘)与桌面、文稿、下载、Projects 等常用目录一键直达,也能逐层深入浏览或手动输入路径校验。
IM 指令表:不开浏览器也能干活
IM 机器人的价值在于,很多操作不需要打开任何界面。统一指令表覆盖了日常高频动作:
/sessions(或/list):列出所有历史会话,按工作区分组;/use N(或/resume N):切到指定序号的会话;/workspaces:列出已在 DSH 注册的工作区目录;/addworkspace <路径>:远程注册新的项目文件夹;/new <提示词>:在当前工作区新建会话,/new <提示词> @N则指定工作区;/stop:立即中断正在运行的任务;/status:查看 Agent 状态与系统摘要;/yes//no(或1/2):响应敏感操作审批,也可以直接点卡片按钮。
普通文本消息则直接驱动当前活动 Agent。通勤路上发一条 /sessions 找到昨天的会话、/use N 接上,再发一段需求,全程不用打开电脑界面。
两层鉴权为什么不用你手工管
很多人第一次配远程访问时会卡在一个疑问上:DSH 从 0.1.2 起给 dsh web 内置了浏览器鉴权,启动时打印的地址带着一次性 token,换来的是一枚绑定回环地址的会话 cookie,此后 /、/api 与各插件 RPC 通道都要求它。那手机访问是不是还得自己处理这个 token?
不需要。这正是插件里那个容易混淆的点。
以为还要手工处理 DSH 的 ?token=
现象。 看到启动日志里的 http://127.0.0.1:3080/?token=…,担心手机或隧道访问时也要手动拼这个参数。
原因。 把两层鉴权混为一谈了:DSH 原生鉴权保护的是「本机回环上的 DSH 进程」,插件的访问密码门禁保护的是「经局域网 / 公网隧道进入的远程访问」。两者互补,不冲突也不重复。
解决。 不用管。插件的反向代理在转发时会自动注入合法的回环会话 cookie,手机 / 隧道访问按页面说明正常使用即可,你只需要关注插件自己的门禁设置。
插件门禁本身也是分层的:门禁分流可以选「全部通道开启防护」「仅公网隧道开启防护(推荐)」或「仅局域网开启防护」;验证模式有扫码免密 + 密码认证、仅密码 / PIN、仅专属 Token 免密三档。第二道防线是管理后台防篡改,访客密码与管理密码分离。想换凭据时点「🔄 重置安全 Token」,之前分享出去的旧二维码与链接会立即全部失效。
机器人授权要自己抢第一条
IM 机器人用的是基于发件人 ID 的严格白名单:只有授权用户的消息才会驱动 Agent,非白名单人员或群内非授权成员的消息会被底层直接丢弃,不消耗 Token 也不触发本地指令。但这个授权机制有个需要留意的时机。
机器人被别人抢先接管
现象。 配置好机器人后放着不管,回头发现有陌生人的消息进入了处理流程。
原因。 白名单是「首条消息自动授权」——谁先发出第一条消息,谁就被绑定为授权用户。从配置完成到你本人发消息之间,存在一个空窗。
解决。 配置完成后立刻自己发第一条消息,把绑定关系抢先占住。如果怀疑已经异常,用「🔄 重置安全 Token」并检查白名单列表。
这一点在 IM 场景里尤其重要,因为机器人一旦被他人触达,每条消息都是一次尝试。四条通道(微信 / QQ / 飞书 / Telegram)接入方式与网络前提各不相同,但白名单逻辑一致。
环境门槛与安装
两个硬门槛:Node 要求 ^22.19.0 || >=24.0.0,以及 dsh CLI 可用。安装命令是:
dsh plugin --profile web add @wenbin_wb/dsh-bridge
装完确认三件事:二维码能在手机扫开(扫不开先查路由器 AP 隔离、多网卡是否选到物理网卡、3082 端口是否被防火墙拦下);安全认证已开启并设好密码或扫码免密;每个启用的 IM 通道都已由你本人发过第一条消息。站点侧的实装验证等级是 L4 · 真实安装(dsh 0.2.0-rc.2),GitHub Star 185,分类 token 为 platform,许可 MIT,最近提交在 0 天前。
总结
dsh-bridge 的落地形态是用三类入口承接「人不在电脑前」这件事:局域网扫码、公网隧道、IM 指令表,配好之后本机 DSH 就变成了随身的移动工作台。想对照同类插件的中文清单与安装形态见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合:经常需要在离开电脑时查看或推进 Agent 任务的人;习惯在微信 / QQ / 飞书 / Telegram 里下指令的人;希望在手机上以全屏 App 形式使用 DSH 的人;需要给远程同事临时开放一个受门禁保护的访问入口的人。
不适合:只在固定电脑前使用、从不需要远程访问的人;不愿意为远程入口额外维护密码与 Token 的人;对「自建隧道默认没有独立认证、安全全靠自己开」这类配置责任无法接受的人。
标签:dsh-bridge、DeepSeek Harness、远程访问、移动端
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。