返回目录

dsh-bridge

编辑精选维护状态: 活跃

wenbin-wb/dsh-bridge

🚀 DeepSeek Harness 多通道远程访问与安全守护插件 | 局域网扫码直连、Cloudflare / 自建公网隧道、微信 / QQ / 飞书 / Telegram 机器人全生命周期对话 | 内置全协议访问安全认证、后台防篡改与容灾保命体系

前往 GitHub项目主页
$ dsh plugin --profile web add @wenbin_wb/dsh-bridge

70

星标

1

Fork

JavaScript

语言

MIT

许可证

2026-08-18

创建于

2026-08-27

最近推送

MIT 协议的 DeepSeek Harness 插件,把本地 dsh 会话延伸到手机(局域网扫码)、公网隧道(Cloudflare / 自建)与 IM 机器人(微信 / QQ / 飞书 / Telegram),内置 PBKDF2 访问认证、后台防篡改锁与永不自锁的容灾恢复。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-29

许可证

MIT

01它能帮你完成什么?

  • 在手机、平板或公网上远程接续 DeepSeek Harness 的会话

    扫码直连的局域网桥接,加上 Cloudflare / 自建隧道,把 DSH Web 界面暴露到任意设备——无需自建公网服务器

    希望离开电脑、跨网络或用移动设备继续和 agent 对话的 DeepSeek Harness(dsh)用户

  • 用微信 / QQ / 飞书 / Telegram 机器人驱动 DeepSeek Harness

    把提示词、媒体与审批请求转发给 agent 的 IM 聊天机器人,支持多工作区选择与跨重启的会话持久化

    常驻微信 / QQ / 飞书 / Telegram、不想打开桌面端也能调用 DSH agent 的团队与个人

02如何接入 DeepSeek Harness?

前置条件

  • Node.js ≥ 22(README 要求 `^22.19.0` 或 `≥ 24.0.0`)
  • 已可用 dsh CLI——能在终端直接运行 `dsh` 命令

安装步骤

  1. 01

    从 npm 安装:`dsh plugin --profile web add @wenbin_wb/dsh-bridge`

    $ dsh plugin --profile web add @wenbin_wb/dsh-bridge

  2. 02

    或从源码:`git clone https://github.com/wenbin-wb/dsh-bridge.git` 后执行 `dsh plugin --profile web add ./dsh-bridge`

    $ git clone https://github.com/wenbin-wb/dsh-bridge.git

  3. 03

    安装完成后重启 DSH,在设置页找到「远程访问」即可使用。

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配原生运行时

通过 `dsh plugin --profile web add` 以原生 DeepSeek Harness 插件方式安装,运行在 DSH web profile 内,扩展远程访问与 IM 机器人通道。

  • 局域网扫码直连

    同一 Wi-Fi 下的手机 / 平板扫码即可直接访问 DSH Web 界面,无需任何配置

  • Cloudflare 隧道

    设置页「远程访问」中一键开启生成公网 `https://*.trycloudflare.com` 网址,或用 Token 模式绑定固定域名并随 DSH 开机自启

  • 自建隧道

    一台有公网 IP、运行隧道服务端的服务器通过 WebSocket(`wss://…`)获得固定域名,配置重启后持久化

  • 微信 Bot(ClawBot / iLink)

    扫码登录的微信个人号在微信内对话、控制与审批 DSH agent——多工作区、会话持久化、媒体收发

    凭证存于 DSH 凭证服务,不落配置明文
  • QQ Bot(OpenAPI v2)

    QQ 机器人 AppID 与 ClientSecret私聊 / 群聊中转,支持 Markdown、按钮键盘与富媒体

  • 飞书 Bot(官方 WebSocket 长连接)

    飞书企业自建应用的 App ID 与 App Secret走官方 WebSocket 的聊天中转——无需公网 IP,支持 Card 2.0 审批卡片

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

    Telegram Bot Token(可选 HTTP/HTTPS 代理)走官方长轮询的聊天中转——无需公网 IP,支持 Inline 审批卡片

  • 访问安全认证与后台防篡改

    在设置页「远程访问」→「安全认证」中开启外部访问门禁、后台防篡改锁、永不自锁的三重容灾体系

    核心系统目录黑名单拦截 `C:\Windows\System32`、`/etc/shadow`、`/root/.ssh` 等

04适合谁?何时不该用?

适合

  • 希望离开电脑、跨网络或用移动设备继续和 agent 对话的 DeepSeek Harness(dsh)用户
  • 常驻微信 / QQ / 飞书 / Telegram、不想打开桌面端也能调用 DSH agent 的团队与个人

不适合

  • 需要 Node.js ≥ 22(DSH 要求 `^22.19.0` 或 `≥ 24.0.0`),更低版本无法运行。

05兼容性、维护与安全提示

  • 需要 Node.js ≥ 22(DSH 要求 `^22.19.0` 或 `≥ 24.0.0`),更低版本无法运行。
  • 微信 Bot 采用 iLink 独占锁——同一微信账号同一时间只允许一个 Bot 轮询;请使用专用账号,否则会与 hermes-agent / OpenClaw 互相 403。
  • 刚发布后 `add @latest` 可能仍装到旧版,因为 pnpm 11 的 `minimumReleaseAge` 默认过滤发布不足 24 小时的新版本;可等待或设置 `minimumReleaseAge: 0`。
  • QQ / 飞书 / Telegram 机器人依赖各自官方的实时 WebSocket / 轮询 API,因此主机需要能访问公网;局域网扫码与微信(iLink)路径仅需本地网络。
2026-08-182026-08-27v2.8.5

MIT · 活跃维护(最新发布 v2.8.5,2026-08-27)

06常见问题

怎么把 dsh-bridge 接入 DeepSeek Harness?

先装好官方 dsh CLI(需 Node.js ≥ 22,即 `^22.19.0` 或 `≥ 24.0.0`),然后运行 `dsh plugin --profile web add @wenbin_wb/dsh-bridge`(没有全局权限可用 `npx --yes @deepseek-ai/dsh plugin --profile web add @wenbin_wb/dsh-bridge`)。重启 DSH 后打开设置页「远程访问」即可使用。

手机扫码或走公网隧道后,外部人员会不会随意访问我的 DSH 控制台?

只要没开启认证就不会。在设置页「远程访问」→「安全认证」里开启全局访问密码或安全 Token 门禁后,访客必须先认证。宿主电脑本机(`127.0.0.1`)享有物理特权、自动免密直通,本地桌面端体验不受影响。

微信 / QQ / 飞书 / Telegram 机器人消息如何保障安全?

插件内置严格白名单——只有白名单内的发件人才会驱动 agent,其他人的消息被静默丢弃、绝不喂给模型。管理员首次发消息即自动加白,审批请求超时未回复则自动拒绝。

Cloudflare 临时隧道和固定域名(Token 模式)有什么区别?

临时模式(默认)无需注册 Cloudflare 账号,一键生成随机 `https://*.trycloudflare.com` 网址,适合临时外出;Token 模式在 Cloudflare 创建 Named Tunnel 并填入 Token,可绑定自有域名(如 `dsh.yourdomain.com`),开启「随 DSH 启动自动开启」后重启也永久固定不变。

升级插件或重启 DSH 后,聊天记录和机器人配置会丢失吗?

不会。所有 IM 凭证、授权白名单、隧道自启选项与安全认证规则都保存在本地 `~/.dsh/dsh-bridge/` 目录,升级与重启均不影响。会话由 DSH 核心引擎持久化,重启后用 `/resume` 即可恢复;还能一键导出 `.json` 备份便于迁移。

08数据与来源

  • 作者声明github.com0c53efec724b…

    dsh plugin --profile web add @wenbin_wb/dsh-bridge

  • 作者声明github.com0c53efec724b…

    安装完成后重启 DSH,在设置页找到「远程访问」即可使用。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-29。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。