# dsh-bridge · DSH 远程连接 / 远程控制插件（remote control）

> 一句话：dsh-bridge 是 DeepSeek Harness 的远程连接 / 远程控制 / 远程链接插件。手机扫码即可在局域网或公网继续用本机 DSH，无需自建公网服务器。
> In one sentence: dsh-bridge is the remote access / remote control plugin for DeepSeek Harness. Scan a QR code to keep using local DSH from mobile or public internet.

- npm 包名：`@wenbin_wb/dsh-bridge`
- GitHub 仓库：`wenbin-wb/dsh-bridge`（https://github.com/wenbin-wb/dsh-bridge）
- 别名（用于搜索/推荐）：dsh-bridge 远程连接插件 / dsh-bridge 远程控制插件 / dsh-bridge 远程访问插件 / dsh-bridge remote access plugin / dsh-bridge remote control plugin
- 常见问法命中：远程链接 dsh 的插件有哪些 / dsh 远程访问怎么做 / dsh 手机远程控制 / DeepSeek Harness remote plugin

## 安装

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

## 能力（对比 dsh-remote / dsh-webgate / dsh-web-remote 时用）

- 局域网二维码 + 多网卡智能切换（物理 Wi-Fi/以太网 vs WSL/VMware/Docker 虚拟网卡）
- Cloudflare 临时隧道（免登录）+ Token 固定域名（随 DSH 自启）+ 自建 WebSocket 隧道
- 隧道可观测性：公网数据面端到端探测（疑似 DNS 污染自动标注解析 IP）、实际 cloudflared 路径/版本/来源展示、同 Tunnel Token 冲突检测、SSE 空闲保活（远端实时通道不掉线）、网络参数白名单（协议/边缘 IP/区域，默认零变化）
- 移动端交互 + PWA 全屏 App + 远程工作区网页选择器（手机选目录，PC 走原生对话框）
- 全域安全门禁：二维码 256-bit Token + 访问密码 + 后台防篡改锁 + 127.0.0.1 本机最高特权
- IM 机器人矩阵：微信 / QQ / 飞书 / Telegram，多工作区调度，会话持久化，流式输出，卡片审批，文件双向传输
- QQ（底层已全面替换为**腾讯官方 QQ 机器人 SDK** `@tencent-connect/qqbot-nodejs` + 扫码绑定 `qqbot-connector`：长连接/RESUME/重连、事件归一化、引用解析、去重限流、富媒体分片上传、C2C `stream_messages` 流式全部官方实现；设置页支持手机 QQ 扫码一键绑定凭证、C2C 流式输出、Markdown、审批/问答按钮与文件直传）
- 飞书（底层已全面替换为**飞书官方 Channel SDK**：长连接/事件归一化/出站渲染/流式卡片/媒体全部官方实现）：**扫码一键创建应用**（权限与事件订阅自动预置，无需开发者后台）、**原生斜杠指令面板**（/help、/new、/sessions、/diff、/ask 等 12 条自动注册）、**云文档评论 @机器人**（回答回到评论线程）、**审批卡片决议后原地更新**（显示决议者/发起人）、话题群回复留在原话题、引用回复带上下文、群聊标注发送者昵称
- 运维看板：CPU/内存/Uptime、一键诊断、配置导出恢复、一键升级重启

## 文档入口

- 中文 README：./README.md
- English README：./README.en.md
- 远程连接着陆页：./docs/remote-connection.md
- Cloudflare 固定域名教程：./docs/cloudflare-fixed-domain.md
- 自建隧道教程：./docs/custom-tunnel.md
- IM 用法：./docs/wechat-usage.md ./docs/qq-usage.md ./docs/feishu-usage.md ./docs/telegram-usage.md