dsh-bridge

dsh-bridge · DSH 远程连接 / 远程控制插件

简体中文 | English DeepSeek Harness 多通道远程访问与全域安全门禁插件（DSH 远程连接 / 远程控制 / 远程链接插件，remote control）

手机扫个码，人不在电脑前也能继续用 DeepSeek Harness。无论躺在沙发上、出差通勤、还是跨网协作——都不用守着电脑，也不用自己搭公网服务器，扫码即可在手机、平板或任意设备上接着干。

将您本地运行的 DeepSeek Harness 无缝延伸至手机网页、PWA 原生全屏应用、公网安全隧道、以及 微信 / QQ / 飞书 / Telegram 机器人矩阵。随时随地调度 AI 编写代码、执行任务、审批操作与管理工作区。 📖 远程连接着陆页：docs/remote-connection.md ｜ 🤖 给 AI 看的摘要：llms.txt 目录 ✨ 功能特性 📦 环境要求与安装 🚀 核心功能与使用指南 1. 🛜 局域网访问与多网卡智能切换 2. 🌐 公网隧道（Cloudflare 临时/固定域名 & 自建隧道） 3. 📱 移动端交互与 PWA 独立全屏 App 4. 🗂️ 远程工作区网页选择器 5. 🔐 全域安全认证与防篡改门禁 6. 🤖 全能 IM 机器人矩阵（微信 / QQ / 飞书 / Telegram） 7. 📊 运维监控看板与一键平滑重启 💬 常见问题 (FAQ) 🛠️ 开发与贡献 ⭐ Star History 📄 开源协议 ✨ 功能特性 🛜 局域网多网卡智能识别与切换：自动探测物理 Wi-Fi、以太网与虚拟网卡（WSL/VMware/Docker），支持在控制台可视化一键切换并记忆持久化，彻底解决多网卡 IP 不互通问题； 🌐 双模 Cloudflare 公网隧道：免登录一键获取随机临时域名，或填入 Cloudflare Token 绑定固定域名并随 DSH 开机自启；支持 macOS 下 Gatekeeper 隔离自愈与全局探测；代理层为事件流（SSE）内置空闲保活，远端实时通道不再被链路掐断； 📡 隧道可观测性：每 60s 实测公网入口端到端可达性（DNS / TLS / 边缘 / 回源，/ready 假绿一眼识别，疑似 DNS 污染自动标注解析 IP）；面板展示实际 cloudflared 路径 · 版本 · 来源；检测到与你使用同一 Tunnel Token 的其他 cloudflared 时黄条告警； 📱 原生级移动端交互与 PWA 全屏应用：动态居中会话标题、复用 DSH 原生侧边栏抽屉与 | 收起图标、防重叠自适应工具栏，支持手机浏览器「添加到主屏幕」作为独立原生 App 运行； 🌏 界面跟随 DSH 主体语言（中文 / English）：设置面板五大分类、全部卡片、锁屏与解锁、远程目录选择弹窗、命令与升级提示等文案均随 自动切换中英；访客登录页（认证发生在 DSH 语言之前）按浏览器 Accept-Language 选择中英；无需单独的语言开关； 🗂️ 远程工作区网页选择器：手机端点击添加工作区唤出树形目录抽屉浏览器，电脑本机点击自动分流调用系统原生选择窗口；支持 IM 指令 /addworkspace 远程注册； 🔐 全域安全认证与双防线门禁：专属二维码

1. Node.js ≥ 22（DSH 要求 ^22.19.0 或 ≥ 24.0.0） 2. dsh CLI 可用（能在终端直接运行 dsh 命令）

DSH 版本兼容性

本插件同时兼容新旧 DSH，无需按 DSH 版本挑选插件版本： 关于 DSH 原生鉴权：DSH 从 0.1.2 起为 dsh web 内置了浏览器鉴权——启动时会打印带一次性 token 的地址（http://127.0.0.1:3080/?token=…），换取一枚绑定回环地址的会话 cookie，此后 /、/api 及各插件 RPC 通道都要求该 cookie。 这与本插件的访问密码门禁是两层互补的防护，不冲突也不重复：原生鉴权保护的是"本机回环上的 DSH 进程"，本插件的门禁保护的是"经局域网 / 公网隧道进入的远程访问"。本插件的反向代理会在转发时自动注入合法的回环会话 cookie，因此手机 / 隧道访问无需手动处理 DSH 的 ?token=，按本页说明正常使用即可。 安装插件

升级至最新版 💡 提示（pnpm 11 用户）：如果升级后仍显示旧版，是由于 pnpm 11 的 minimumReleaseAge 机制限制。在 Web 控制台点击「一键升级」即可自动跳过限制安装最新版。 DSH Desktop 桌面版安装

桌面版（Electron 应用）运行在独立的 desktop profile 上，与 Web 端是两套插件安装，需单独安装： 方式一 · 图形界面（推荐）：打开 设置 → 插件 → 「+ 添加插件」 → 输入包名 @wenbin_wb/dsh-bridge → 国内网络可在「安装源」切换 中国大陆镜像源 → 点击 「安装」 → 完成后在左侧「已安装」列表确认插件已启用 → 通过应用菜单重启 DeepSeek Harness 后生效。 方式二 · 命令行： 🚀 核心功能与使用指南

启动 DeepSeek Harness 后，在设置面板找到 「远程访问」 即可开启全部功能： 1. 🛜 局域网访问与多网卡智能切换

插件启动后自动随服务开启局域网代理，无需手动配置。 零配置极速扫码：同一 Wi-Fi 下打开手机相机扫码即可直达移动端 Web 界面； 多网卡智能切换：当主机存在多张网卡（如物理 Wi-Fi、以太网、WSL 虚拟网卡、VMware、Docker 等）时，控制台自动展示 「🛜 局域网网卡 / IP 选择」 下拉框；智能评分高亮推荐物理网卡，点选后二维码与访问 URL 秒级重新生成并自动持久化保存。 2. 🌐 公网隧道（Cloudflare 临时/固定域名 & 自建隧道）