dsh-bridge

<b>简体中文</b> | <a href="README.en.md">English</a>

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

手机扫个码，人不在电脑前也能继续用 DeepSeek Harness。躺在沙发上、出差在外、跨网访问——都不用守着电脑，也不用自己搭公网服务器，扫码就能在手机/平板或任意设备上接着干。

把你本地的 DeepSeek Harness 无缝延伸到手机、平板、公网、甚至微信 / QQ / 飞书 / Telegram。无论你在哪，都能通过扫码、网页或 IM 机器人，随时调用你的 AI 助手。

---

功能特性

• 🔐 全套访问安全认证与后台防篡改（v2.5.0 重磅）：
  • 第一道防线（外部访问门禁）：二维码自带专属 Token 扫码一秒免密直入；手动输入 IP 或公网域名强制验证密码；支持「全部防护 / 仅公网 / 仅局域网」精准通道分流；
  • 第二道防线（管理控制台防篡改）：独立管理员密码，远程设备进入控制台全局锁定网络配置与 IM 机器人密钥，支持「需密码解锁 / 仅电脑本机管理 / 宽松直管」；
  • 三重容灾保命体系：电脑本机（127.0.0.1）永久最高物理特权（永不自锁） + 终端 touch ~/.dsh/dsh-bridge/reset-auth 一秒救急重置 + 全界面忘记密码求助引导；
  • 金融级安全引擎：PBKDF2 + SHA-256 加盐哈希安全存储、30 天 HttpOnly SameSite 会话、单 IP 连续 5 次错误封禁 60 秒防暴力破解。
• 局域网访问：手机/平板扫码，同一 Wi-Fi 直接访问，躺着也能在手机上接着聊
• Cloudflare 隧道：一键暴露公网地址，随时随地连接，出差在外、不在家也能接着干，无需自建公网服务器
• 自建隧道：连接自己的隧道服务器，获得固定域名（搭建教程）
• 微信 Bot（ClawBot / iLink）：扫码登录微信个人号后，直接在微信里对话、控制 DeepSeek Harness 的 agent。支持多工作区选择、会话跨重启持久化、按工作区分组查看、媒体（图片/文件/语音）收发、权限审批——走腾讯官方 iLink Bot API，无需公网（使用说明）
• QQ Bot（OpenAPI v2）：接入 QQ 机器人，私聊/群聊接收消息，发送 Markdown、按钮键盘和富媒体。完整事件覆盖（C2C / GROUP_AT_MESSAGE_CREATE）、Token 自动刷新、断线重连、消息去重——走腾讯官方 QQ Bot OpenAPI v2（使用说明）
• 飞书 Bot（官方 WebSocket 长连接）：接入飞书开放平台企业自建应用，私聊/群聊实时交互。无需公网 IP / 无需 Webhook、支持飞书 Markdown 表格排版、原生交互卡片权限审批一键点击确认——走飞书官方最新 WebSocket 长连接协议（使用说明）
• Telegram Bot（官方 Bot API + 代理支持）：接入官方 Telegram 机器人，单聊/群聊实时交互。无需公网 IP（长轮询 getUpdates）、内置零依赖 HTTP/HTTPS 代理隧道、打字机平滑流式输出、原生快捷指令菜单（Menu 按钮）与 Inline 交互卡片审批（使用说明）
• IM 官方品牌矢量图标：微信、QQ、飞书、Telegram 官方矢量图标与状态展示，直接在聊天软件里呼唤你的 Agent
• 极速版本检查与一键升级：国内高速镜像（npmmirror）优先 + 官方源毫秒级双通道检查，检测到新版本支持界面一键直接升级，无需手动打开终端
• 深色模式深度适配：完美适配 DeepSeek Harness 设计系统明暗主题切换，二维码自带白底安全垫，暗光下手机扫码 100% 极速识别

---

开发路线图

目标	说明	状态
访问安全认证	外部访问门禁拦截 + 管理后台防篡改锁 + 三重容灾保命体系	✅ 已完成（v2.5.0）
Telegram	适合自托管与海外的 IM 渠道（免公网长轮询 / 代理支持 / 原生菜单 / Inline 卡片 / 流式打字机）	✅ 已完成（v2.4.0）
飞书	飞书开放平台长连接机器人，办公场景直接调用（免公网 WS / 卡片审批）	✅ 已完成（v2.3.0）
QQ Bot	接入 QQ 机器人，群聊/私聊唤起 Agent（Markdown / 按钮 / 富媒体）	✅ 已完成（v2.1.0）
微信	在微信里直接与你的 Agent 对话（多工作区 / 会话持久化 / 媒体 / 审批）	✅ 已完成（v1.0.0）
平台抽象层	平台无关的核心（会话/审批/命令/digest）跨 IM 渠道复用	✅ 已完成（v2.0.0）

---

环境要求

安装插件前，请先确保：

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

# 检查 Node 版本
node -v   # 应显示 v22.19+ 或 v24+

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

如果 dsh 命令提示"无法识别/找不到"，先安装 DSH：

npm install -g @deepseek-ai/dsh

若没有全局安装的权限，也可以用 npx 方式：

npx --yes @deepseek-ai/dsh plugin --profile web add @wenbin_wb/dsh-bridge

---

安装

从 npm 安装（推荐）

# 安装最新版
dsh plugin --profile web add @wenbin_wb/dsh-bridge

# 或指定版本（如 2.5.0）
dsh plugin --profile web add @wenbin_wb/[email protected]

💡 没有全局安装权限？ 使用 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，在设置页找到「远程访问」即可使用。

升级到最新版

# 方式一：在设置页「远程访问」中点击「🚀 一键升级到 vX.X.X」（推荐，全自动）

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

注意：update --latest 可能因已安装依赖的版本约束而无法升级到最新版。用上面的 add @latest 命令即可强制安装最新版（无需知道具体版本号）。

…