dsh-bridge

🚀 DeepSeek Harness 多通道远程访问插件 —— 让 AI 无处不达

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

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

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

功能

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

Roadmap（路线图）

本项目致力于把 DSH 打造成随时随地可用的 AI 基础设施。除了现有的三种访问方式，正在规划：

目标	说明	状态
💬 微信 / 公众号	在微信里直接与你的 Agent 对话	规划中
🐧 QQ Bot	接入手Q QQ 机器人，群聊/私聊唤起 Agent	规划中
✈️ 飞书	飞书消息/机器人集成，办公场景直接调用	规划中
🤖 OpenClaw	与 OpenClaw 生态打通	规划中
📨 Telegram	高度可定制、适合自托管的 IM 渠道	规划中

为什么关注这个项目：DSH 的能力全在插件里，而 dsh-bridge 正是那个"把 DSH 从本机解放出来"的关键插件。未来的 IM 集成会让你的 AI 助手真正做到"随叫随到"。

兼容性

• 插件版本：当前发布 @wenbin_wb/dsh-bridge@1.0.3（见顶部 npm 徽章，最新版本会自动同步）
• 基于 DeepSeek Harness v0.1.0-rc.6 开发测试。
• DSH 是开发者预览版，插件契约可能随版本变化，请关注 CHANGELOG。

环境要求

安装插件前，请先确保：

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@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 隧道」卡片中的「开启」按钮：

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

自建隧道

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

配置自动持久化到 ~/.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 .

License

MIT © wenbin-wb