前言¶
如果你需要在电脑上运行 DSH，同时希望手机或外网也能继续查看会话、切换模型、控制运行，常见做法是自备公网 IP、注册隧道服务、配置证书、修改端口。
dsh-web-remote 把这几件事合并为一个 DSH 插件：它提供免配置的 Cloudflare Quick Tunnel、局域网 HTTPS 直连、自定义公网链接/端口，以及微信和飞书机器人。
这是什么¶
dsh-web-remote 是 godchen520 维护的 DeepSeek Harness（DSH）插件，许可证为 MIT。
它解决的核心问题是：让本地运行的 DSH Web 可以被手机、外网、微信或飞书访问和控制。
核心能力¶
- 公网访问：使用 Cloudflare Quick Tunnel，无需公网 IP、无需注册；
cloudflared缺失时自动下载。 - 局域网直连：支持 HTTP + HTTPS 直连；HTTPS 自动生成自签名证书，零配置。
- 安全认证：每次启动生成随机令牌；使用 HttpOnly Cookie；局域网可免 token。
- 性能加速：反向代理自动 gzip 压缩，大历史会话加载更快。
- 侧边栏图标：手机快捷按钮常驻左下角，刷新不消失。
- 自定义公网链接：支持填写自定义公网 URL，例如 ngrok；可在面板编辑或清除，重启后生效。
- 自定义端口：局域网模式下可修改 HTTPS 端口号，带端口占用检测。
- 微信机器人：通过 iLink 协议直连微信，支持 AI 对话、会话控制、模型切换。
- 飞书机器人：通过 WebSocket 长连接，支持命令控制、会话监听通知。
- 会话监听：使用
/监听命令，Agent 思考完毕后自动通过微信或飞书通知。
安装与启用¶
资料中列出了多种安装与启用方式，可按本地 DSH 环境选用。
通过 DSH 对话安装¶
可把下面这句话发给 DSH：
请帮我安装 dsh-web-remote 远程访问插件（https://github.com/godchen520/dsh-web-remote），装完告诉我如何重启 DSH Web。
命令行安装¶
执行：
dsh plugin --profile web add github:godchen520/dsh-web-remote && dsh web
GitHub 包安装¶
先进入 web profile 目录：
cd $DSH_HOME/profiles/web
pnpm add github:godchen520/dsh-web-remote
再在 package.json 的 dsh.profile.bundles 数组中添加 "dsh-web-remote"，然后重启 DSH。
手动 patch¶
把包放入 profile 的 node_modules，在 cordis.patch.yml 追加 web-remote 条目。
bundle 方式需要重启；cordis.patch.yml 方式会被 HMR 热加载。
启动后如何访问¶
- 启动后，在 DSH 页面左下角查看手机图标。
- 点击图标，打开远程面板。
- 在手机上打开面板给出的公网或局域网链接。
公网访问使用 Cloudflare Quick Tunnel，无需自备公网 IP，也无需注册。若本机缺少 cloudflared，首次启动需要联网下载约 10MB，之后复用缓存。
局域网访问使用 HTTP/HTTPS 直连；HTTPS 自动生成自签名证书。局域网来源默认可免 token。
微信与飞书¶
微信机器人¶
dsh-web-remote 支持通过 iLink 协议直连微信，用于 AI 对话、会话控制和模型切换。
资料列出以下命令：
/链接
/停止远程
/监听
/会话列表
/选择 N
/切换模型
/选强度 N
/监听 用于开启或关闭会话监听；Agent 思考完毕后会自动向微信或飞书发送通知。
微信绑定的 token 会自动持久化恢复。
飞书机器人¶
飞书机器人支持 WebSocket 长连接，用于命令控制和会话监听通知。
绑定步骤：
- 打开 DSH Web 面板。
- 进入“机器人”标签页，选择“飞书”。
- 填写
App ID和App Secret。 - 点击绑定。
注意¶
- 配置全部可选，不配置即可使用。
- 每次启动会生成随机令牌；远程访问依赖 HttpOnly Cookie。
- 局域网模式允许私网来源免 token。
- HTTPS 为自签名证书，浏览器可能提示不安全；按提示继续访问。Edge 需要关闭“增强安全性”。
- 公网隧道每次重启会生成新地址；微信绑定的 token 会自动持久化恢复。
- 自定义公网链接，例如 ngrok，可在面板编辑或清除，重启后生效。
- 局域网 HTTPS 端口可修改，并带端口占用检测。
- 插件以当前
dsh进程权限运行；安装前应检查源码与许可证。
链接¶
- GitHub: https://github.com/godchen520/dsh-web-remote
- 许可证：MIT
