dsh-bridge README

The project's README from github.com/wenbin-wb/dsh-bridge. As one markdown file: README.md.

dsh-bridge

dsh-bridge banner

npm version npm downloads GitHub release GitHub stars Node.js version license

Security WeChat QQ Feishu Telegram Cloudflare

简体中文 | English

DeepSeek Harness 多通道远程访问与全域安全门禁插件

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

将您本地运行的 DeepSeek Harness 无缝延伸至手机网页、PWA 原生全屏应用、公网安全隧道、以及 微信 / QQ / 飞书 / Telegram 机器人矩阵。随时随地调度 AI 编写代码、执行任务、审批操作与管理工作区。


目录


✨ 功能特性


📦 环境要求与安装

环境要求

  1. Node.js ≥ 22(DSH 要求 ^22.19.0 或 ≥ 24.0.0)
  2. dsh CLI 可用(能在终端直接运行 dsh 命令)
# 检查 Node 版本
node -v   # 应显示 v22.19+ 或 v24+

# 检查 dsh 是否可用
dsh --version

安装插件

# 方式一:从 npm 安装最新版(推荐)
dsh plugin --profile web add @wenbin_wb/dsh-bridge

# 方式二:免全局权限的 npx 方式
npx --yes @deepseek-ai/dsh plugin --profile web add @wenbin_wb/dsh-bridge

# 方式三:从源码安装
git clone https://github.com/wenbin-wb/dsh-bridge.git
dsh plugin --profile web add ./dsh-bridge

升级至最新版

# 方式一:在设置页「远程访问」底部点击「🚀 一键升级到最新版并重启」(推荐,全自动)

# 方式二:终端强制覆盖安装最新版
dsh plugin --profile web add @wenbin_wb/dsh-bridge@latest

💡 提示(pnpm 11 用户):如果升级后仍显示旧版,是由于 pnpm 11 的 minimumReleaseAge 机制限制。在 Web 控制台点击「一键升级」即可自动跳过限制安装最新版。


🚀 核心功能与使用指南

启动 DeepSeek Harness 后,在设置面板找到 「远程访问」 即可开启全部功能:


1. 🛜 局域网访问与多网卡智能切换

插件启动后自动随服务开启局域网代理,无需手动配置。

局域网扫码访问控制台


2. 🌐 公网隧道(Cloudflare 临时/固定域名 & 自建隧道)

无需公网 IP 与路由器端口映射,随时随地从外网访问电脑上的 DeepSeek Harness:

公网隧道配置控制台

自建隧道安全须知:隧道服务端(scripts/install-tunnel-server.sh)只对「隧道客户端控制通道」校验 TOKEN;公网访客对隧道域名的 HTTP/WebSocket 转发不再做独立认证,安全完全依赖插件本地的「访问认证」(x-dsh-internal-tunnel 标识使隧道流量无法享受本机回环保留)。请务必在插件设置中开启「安全认证」并设置访问密码/二维码 Token(尤其 scope=all 或公网使用时);未设置任何密码时,任何知道隧道地址的访客都能直接访问您的 DSH。


3. 📱 移动端交互与 PWA 独立全屏 App

针对手机屏幕与触控操作进行深度优化,无需额外配置即可获得原生 App 级流畅体验:

移动端对话与工作区管理体验

移动端新会话主页   移动端已有对话交互   移动端原生抽屉侧边栏   移动端远程工作区选择器

远程访问与移动端设置中心

局域网访问控制台   公网隧道配置   IM 机器人矩阵   全局访问安全认证


4. 🗂️ 远程工作区网页选择器

针对手机端或远程浏览器无法唤起本地电脑文件弹窗的痛点,内置响应式网页树形目录浏览器:

移动端远程工作区网页选择器


5. 🔐 全域安全认证与防篡改门禁

打开设置页「远程访问」→「安全认证」Tab 即可一键启用全方位安全守护:

安全认证配置面板

1. 🛡️ 第一道防线:外部访问门禁(保护谁能进 Web 界面)

📱 点击展开外部访问安全认证登录页截图

外部访问安全认证登录页

2. 🔒 第二道防线:管理后台防篡改(保护谁能改插件设置)

🖥️ 点击展开远程设备管理控制台防篡改锁定截图

管理控制台防篡改锁定

3. 🛟 三重容灾保命体系(永不自锁)


6. 🤖 全能 IM 机器人矩阵(微信 / QQ / 飞书 / Telegram)

无需打开浏览器,直接在常用聊天软件中与本地 Agent 对话、下达任务、接收进度与审批操作:


基于腾讯官方开放的微信 ClawBot 插件功能(底层 iLink Bot API),扫码登录微信个人号后即可对话与审批,全程走腾讯官方服务器,无需公网与隧道。

微信 Bot 配置

📱 点击展开手机微信对话与审批截图

微信对话示例


🐧 QQ Bot(OpenAPI v2)

接入 QQ 官方机器人,支持单聊与群聊(群聊需 @机器人),支持 Markdown 渲染、快捷按钮键盘与富媒体文件直传。

QQ Bot 配置

📱 点击展开手机 QQ 单聊与群聊对话截图

QQ 单聊对话 QQ 群聊对话


🐦 飞书 Bot(官方 WebSocket 2.0)

接入飞书开放平台企业自建应用,采用官方 WebSocket 全双工长连接,100% 免公网 IP / 免域名 / 免配置 Webhook。

飞书 Bot 配置

📱 点击展开手机飞书对话与卡片审批截图

飞书对话与卡片审批示例


✈️ Telegram Bot(官方 Bot API + 代理支持)

接入 Telegram 官方 Bot API,单聊/群聊实时交互。采用官方 Long Polling(长轮询)机制,内置零依赖 HTTP/HTTPS CONNECT 代理隧道。

Telegram Bot 配置


统一 IM 交互指令表

指令 说明
(普通文本) 驱动当前活动 Agent 思考与编码
/sessions(或 /list) 列出所有历史会话(按工作区分组排版)
/use N(或 /resume N) 切换到指定序号的会话
/rename <新标题> 重命名当前活动会话
/workspaces 列出已在 DSH 注册的所有工作区目录
/addworkspace <路径> 远程向电脑注册添加新的项目文件夹
/new <提示词> 在当前工作区创建并开始新会话
/new <提示词> @N 在指定工作区序号下直接新建会话
/stop 立即中断当前正在运行的任务
/end 结束并挂起当前会话上下文
/yes / /no (或 1/2) 响应敏感操作权限审批(或直接点击卡片按钮)
/status 查看 Agent 状态与系统摘要看板
/help 查看完整的指令与快捷帮助

7. 📊 运维监控看板与一键平滑重启

打开控制台 「运维监控」 Tab,实时掌控系统状态与一键维护:

运维监控看板与系统状态

dsh-bridge (wenbin-wb/dsh-bridge)

Searching Database…

What is this?dsh-bridge lets you keep using DeepSeek Harness (DSH) from your phone or any device by scanning a QR code, even when you are away from the computer running it. It adds LAN access, public tunnels, and IM bot control on top of your local DSH instance.
Is this a standalone app or does it plug into something else?It is a plugin that extends DeepSeek Harness with multi-channel remote access and a security gate; it has no independent use without a running DSH instance.
How do I get it running?Install dsh-bridge as a DSH plugin, then start DeepSeek Harness and open its settings panel to the 'Remote Access' section to turn on LAN access, tunnels, and bots.
What do I need installed before this works?You need Node.js ^22.19.0 or >=24.0.0 and a working 'dsh' CLI command, since the plugin only runs inside an existing DeepSeek Harness setup.
Is the self-hosted tunnel mode secure by default?No. The self-hosted WebSocket tunnel does not independently authenticate public HTTP/WebSocket traffic, so anyone who knows the tunnel URL can reach your DSH unless you manually enable the plugin's access password or token.
Does it work on Windows and macOS, not just Linux?Yes, it handles Windows drive letters (C:, D:) and common folders for the workspace picker, and auto-manages macOS Gatekeeper quarantine for the Cloudflare binary, alongside Linux support.
How is remote access protected from strangers?A QR-embedded 256-bit token lets your own devices in password-free, an access password gates everyone else, and a separate admin password protects the settings panel so visitors can never change your config.
Can I get a permanent public URL instead of a random temporary one?Yes, binding a Cloudflare Token with your own domain gives a fixed URL that never changes and can auto-restart with DSH, for free.
Does it automatically pick the right network interface?Yes, it detects physical Wi-Fi, Ethernet, and virtual adapters like WSL, VMware, and Docker, lets you pick one from a dropdown, and remembers your choice.
What happens if I lock myself out of the admin settings?The host machine (127.0.0.1) always has top-level privilege and can never be locked out, and there's a one-line terminal command (reset-auth) that instantly clears passwords in an emergency.
What can I do from the IM bots besides chatting?Slash commands let you list and switch sessions, register new workspaces, approve or deny sensitive actions, stop running tasks, and check system status directly from WeChat, QQ, Feishu, or Telegram.
Creator
wenbin-wb
Size
13.9 MB
Stars
204
Age
2mo
Commits · 90 Days