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…

Что это?dsh-bridge позволяет продолжать пользоваться DeepSeek Harness (DSH) с телефона или любого устройства, отсканировав QR-код, даже когда вы далеко от компьютера, где он запущен. Поверх локального экземпляра DSH он добавляет доступ по локальной сети, публичные туннели и управление через IM-ботов.
Это отдельное приложение или плагин к чему-то?Это плагин, расширяющий DeepSeek Harness многоканальным удалённым доступом и защитным шлюзом; без запущенного экземпляра DSH сам по себе он бесполезен.
Как его запустить?Установите dsh-bridge как плагин DSH, затем запустите DeepSeek Harness и откройте в панели настроек раздел «Remote Access», чтобы включить доступ по локальной сети, туннели и ботов.
Что должно быть установлено, чтобы всё заработало?Нужны Node.js ^22.19.0 или >=24.0.0 и работающая команда dsh, поскольку плагин работает только внутри уже развёрнутого DeepSeek Harness.
Безопасен ли режим туннеля на собственном сервере по умолчанию?Нет. WebSocket-туннель на собственном сервере не аутентифицирует сам по себе публичный HTTP/WebSocket-трафик, поэтому любой, кто узнает URL туннеля, может достучаться до вашего DSH, если вы вручную не включите пароль доступа или токен плагина.
Он работает на Windows и macOS, а не только на Linux?Да, помимо Linux он корректно обрабатывает буквы дисков Windows (C:, D:) и типичные папки в выборе рабочего пространства, а также автоматически разбирается с карантином Gatekeeper в macOS для бинарника Cloudflare.
Как удалённый доступ защищён от посторонних?256-битный токен, зашитый в QR-код, впускает ваши собственные устройства без пароля, всех остальных пускает только пароль доступа, а отдельный пароль администратора защищает панель настроек, так что посетители не смогут менять вашу конфигурацию.
Можно ли получить постоянный публичный URL вместо случайного временного?Да, привязка Cloudflare Token к собственному домену даёт фиксированный URL, который никогда не меняется, может автоматически перезапускаться вместе с DSH и при этом бесплатен.
Он сам выбирает нужный сетевой интерфейс?Да, он определяет физические Wi-Fi и Ethernet, а также виртуальные адаптеры вроде WSL, VMware и Docker, позволяет выбрать нужный из выпадающего списка и запоминает выбор.
Что делать, если я заблокировал сам себя в настройках администратора?Хост-машина (127.0.0.1) всегда имеет высшие права и никогда не может оказаться заблокированной, а на крайний случай есть однострочная команда терминала (reset-auth), которая мгновенно сбрасывает пароли.
Что можно делать через IM-ботов, кроме переписки?Слэш-команды позволяют просматривать и переключать сессии, регистрировать новые рабочие пространства, подтверждать или отклонять чувствительные действия, останавливать запущенные задачи и проверять состояние системы прямо из WeChat, QQ, Feishu или Telegram.
Creator
wenbin-wb
Size
13.9 MB
Stars
199
Age
2mo
Commits · 90 Days