dsh-phone-remote

Phone Remote · 手机远程操控 DSH 界面

让安卓/iPhone 手机在外面也能用浏览器原生页面打开本机的 DeepSeek Harness（DSH）， 收「任务跑完」提醒，并在手机上给电脑发一句话就能召唤远程入口。

一套由插件 + 三个配套小服务组成的最小可用方案。不需要买域名、不需要改路由器、不租服务器。

语言：中文 · English

---

它解决什么问题

DSH 的 Web 界面默认只监听 127.0.0.1，手机碰不到。本方案做四件事：

通知里的链接一律走公网（v0.3.0 起）：发通知前，插件先看有没有还活着的临时门 （doorMinRemainingMs 默认 0：只要没到期就复用，不重开门；复用时通知里只说明"门没关"、不重复给链接）； 没有才自动开一扇（doorMinutes 默认 480 = 8 小时）再把公网地址放进通知；门到点自动关、链接随即失效。 进门要带门钥匙（?gate=<gateKey>，32 字符随机串，跟门同生共死）：只拿到域名打不开（401）， 但拿到完整链接的人在门关之前都能进——这条边界详见 docs/SECURITY.md 第 2 节。 门没开成时宁可不带链接（附一句说明），也绝不推一条点不开的死链接。 为什么改：以前通知里放的是"手机可达地址前缀"（mobileBaseUrl，家里局域网 IP）， 一出门在公网上根本不存在这个地址，点开必然打不开——这是 10-19 boss反馈的根因。

目录结构

plugin/            # DSH 的 Cordis 插件（Host 半 + Client 半），本目录
├─ index.js        #   Host 半：生成手机入口链接、写 upstream、任务完成/出错推送
├─ client.js       #   Client 半：「手机远程」窄屏面板（工作区分区 + 忙闲 + 派活）
├─ cordis.patch.yml#   插件行配置（上传前请替换为 config.example.yml 的占位符写法）
├─ config.example.yml  # 脱敏配置模板
├─ bot.example.json    # 机器人凭据模板（脱敏）
├─ docs/           # 文档：踩坑 / 引导 / 架构 / 安全
└─ .gitignore      # 排除真实凭据、日志、二进制

../phone-proxy.mjs        # 传达室：51130 → 127.0.0.1:<DSH端口>（改写 Host/Origin）
../temp-door.mjs          # 临时限时门：cloudflared 快速隧道，到点自动关
../bot/wecom-bot.mjs      # 机器人长连接（示例实现：企业微信智能机器人）

三个配套服务各自独立、可单独使用。只用插件也能跑通第 1、3 条； 第 2 条要 temp-door.mjs，第 4 条要 bot/。

---

快速开始（最短路径）

1. 装插件：把 plugin/ 目录用 DSH 的插件管理器装载（install_bundle，目标指向本目录）。
2. 配两项（见 config.example.yml）：
   • pushWebhook：任意接受 POST JSON 的推送地址（企微群机器人 / 飞书自定义机器人 / 钉钉 / ntfy…）；
   • linkFile / mobileBaseUrl：入口链接落盘位置、手机可达的地址前缀。
3. 起传达室（同 WiFi 直接用）：node phone-proxy.mjs，建议用系统计划任务托管（见 docs/GUIDE.md）。
4. （可选）起机器人长连接：填 botId/secret 后 node bot/wecom-bot.mjs，手机发「开门」即召唤。

细节步骤、分平台适配、验证清单见 docs/GUIDE.md。

---

文档索引

打包分享清单（要带走哪些文件）

仓库里只放：

plugin/
├─ index.js  client.js  package.json  icon.svg
├─ locale/{en,zh}.json
├─ config.example.yml      # 配置模板（占位符）
├─ bot.example.json        # 机器人凭据模板（占位符）
├─ README.md  docs/*.md  .gitignore
└─ companion/               # ← 上传前从上一级目录移入并脱敏（见下）
   ├─ phone-proxy.mjs  phone-proxy-supervisor.mjs
   ├─ temp-door.mjs
   └─ wecom-bot.mjs

上传前必须处理的三件事：

1. 不要提交 cordis.patch.yml（含真实工作路径 / 内网 IP / 推送频道）→ 用 config.example.yml 代替；
2. 不要提交 任何 *.json 真实配置（机器人 botId/secret、推送通道表）→ 用 bot.example.json 代替；
3. companion/ 里的三个配套脚本已经是脱敏副本（推送出口改读 push.json 或环境变量 PUSH_WEBHOOK；机器人脚本的相对路径已按同目录改好），直接带上即可。

更省事的做法：跑一键打包脚本，它自动剔除全部敏感文件与产物：

pwsh -File .\publish.ps1 -Target ..\..\dsh-phone-remote-publish

生成目录即为可直接 git push 的仓库内容。 提交前请逐条跑 docs/SECURITY.md 第 5.3 节的自检命令，全部应为"无匹配"。

平台无关性

本方案刻意不绑定某个 IM 平台，只要满足下面两条就能适配：

• 出口（发通知）：给一个 Webhook 协议地址，能 POST 一段 JSON。 企微群机器人、飞书自定义机器人、钉钉机器人、ntfy、Slack…均可。
• 入口（收消息）：给一个 Bot ID + Secret，且该平台支持长连接（客户端主动连出去收消息）。 企业微信「智能机器人」、飞书自建应用、QQ 机器人均属此类。

关键取舍：收消息一定要走长连接，不要走"平台把消息推到一个公网回调地址"。 后者要求一个固定不变的公网 HTTPS 地址——家庭宽带几乎做不到（详见 docs/PITFALLS.md 第 1、3 条）。

演示视频

手机远程实机演示（开门 → 手机浏览器原生页面进入 → 远程派活）：media/phone-remote-demo.mp4

版本

当前 v0.3.0（2026-10-19）。改了什么、每个版本修了哪些坑，见 CHANGELOG.md。

许可与出处

示例实现以企业微信为基准（官方 SDK @wecom/aibot-node-sdk）。 欢迎按 docs/ARCHITECTURE.md 的适配接口补其他平台。