Name: dsh-bridge
Author: wenbin-wb

Installer

dsh plugin --profile web add github:wenbin-wb/dsh-bridge

README

dsh-bridge

DeepSeek Harness 多通道远程访问插件

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

在 DSH 设置页新增「远程访问」面板，开箱即用地获得：

局域网访问：手机扫码，同一 Wi-Fi 直接访问
Cloudflare 隧道：一键暴露公网地址，随时随地连接
自建隧道：连接自己的隧道服务器，获得固定域名
IM 集成（规划中）：微信 / QQ / 飞书 / OpenClaw，直接在聊天软件里呼唤你的 Agent

npm npm downloads npm license

功能

局域网访问：自动检测本机 IP，生成二维码，同一 Wi-Fi 下的设备直接扫码访问
Cloudflare 隧道：一键获取公网地址，自动下载 cloudflared（无需手动安装），重启后 URL 会变化
自建隧道：WebSocket 反向隧道，连接自己部署的隧道服务器，可获得固定域名
安全提示：URL 和二维码带访问警告，防止误分享
版本检查：进入面板自动检测是否有新版本

Roadmap

除了现有的三种访问方式，正在规划：

目标	说明	状态
微信	在微信里直接与你的 Agent 对话	规划中
QQ Bot	接入 QQ 机器人，群聊/私聊唤起 Agent	规划中
飞书	飞书消息/机器人集成，办公场景直接调用	规划中
OpenClaw	与 OpenClaw 生态打通	规划中
Telegram	适合自托管的 IM 渠道	规划中

兼容性

插件版本：当前发布 @wenbin_wb/dsh-bridge@1.0.3（见顶部 npm 徽章，最新版本会自动同步）

基于 DeepSeek Harness v0.1.0-rc.6 开发测试。

DSH 是开发者预览版，插件契约可能随版本变化，请关注 CHANGELOG。

环境要求

安装插件前，请先确保：

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

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

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

如果 dsh 命令提示"无法识别/找不到"，说明它没有全局安装，先安装 DSH：

npm install -g @deepseek-ai/dsh@0.1.0-rc.6

与 DSH 版本保持一致：本插件基于 0.1.0-rc.6 测试，建议安装相同版本以免契约不匹配。
若没有全局安装的权限，也可以用 npx 方式（无需全局安装）：
npx --yes @deepseek-ai/dsh plugin --profile web add @wenbin_wb/dsh-bridge

安装

从 npm 安装：

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，在设置页找到「远程访问」即可使用。

使用

局域网访问

插件启动后自动开启，无需任何配置。打开设置页「远程访问」，用手机扫描二维码即可访问。

Cloudflare 隧道

点击「Cloudflare 隧道」卡片中的「开启」按钮：

首次使用会自动从 GitHub 下载 cloudflared（约 30MB），需要能访问 GitHub
下载完成后自动启动，几秒内显示公网 URL 和二维码
每次重启后 URL 会变化；点「重置链接」可主动获取新 URL

自建隧道

展开「如何搭建自建隧道服务器？」查看搭建步骤
填写 WebSocket 服务器地址（wss://...）和访问令牌
点「保存配置」后点「开启」

配置自动持久化到 ~/.dsh/dsh-bridge/config.json，重启后无需重新填写。

可选配置

插件开箱即用，无需配置。如需修改代理端口，在 cordis.yml 中添加：

- name: dsh-bridge
  config:
    port: 3082  # 默认 3082

开发

git clone https://github.com/wenbin-wb/dsh-bridge.git
cd dsh-bridge
npm install

# 修改 client/index.js 后重新构建
npm run build:client

# 安装到 web profile 并重启 DSH
dsh plugin --profile web add .