dsh-remote-link

把 DeepSeek Harness（DSH）的官方 Web UI 安全地暴露到局域网——手机扫码即遥控电脑上的 agent——并给模型增加 fork_session 会话分叉工具。零核心改动、零运行时依赖。

v1.6：链路保活 + 状态页——DSH 事件下行流（/api/events.mux）没有任何心跳，空闲连接会被隧道边缘/运营商 NAT 静默收割，手机端触发全量 resync。网关现按需向浏览器注入 WS ping（仅在帧边界、仅空闲时），从根源避免断连；/status 状态页实时展示每条连接的 RTT 与保活计数（调研与设计见 docs/LINK-KEEPALIVE-DESIGN.md）。

v1.6.1：死腿清理 + 连接身份 + 全链路健康——连续 3 个 ping 无 pong 的半开连接被主动关闭（客户端立刻重连，不再干等 TCP 超时）；/status 的每条连接标注设备身份（配对 cookie → 设备名 + 来源 IP）、上游健康（最近成功 + 最近 10 条代理错误）、隧道连接器心跳年龄（cf-tunnel.sh 每 30s 落盘，配置 tunnelHeartbeatFile 读取）。

v1.6.2：也适用于 MiMo Code——网关本质是"认证 + 反代"，上游不挑食。mimo/ 目录提供恢复移动端 Web UI 的 2 文件补丁，独立运行器 runner-gateway.mjs 一条命令把 MiMo Code 变成手机可遥控的 agent（见下文"也适用于 MiMo Code"）。

v1.6.3：宿主遥测——/status 的"上游健康"从"HTTP 服务器活着"升级到"DSH 全栈活着"：网关以官方客户端同款信封调用 /api/host.describe（必须穿过 webserver → ApiProxy → 宿主才能返回，顺带量出 RPC 延迟、取回 model/版本/会话数），并订阅 /api/events.host 事件流实时跟踪 agent 忙闲。非 DSH 上游（如 MiMo，其兜底 UI 路由对一切路径回 200 HTML）会被形状判定自动识别并静默，不产生噪音。

v1.7 候选已实现（待审核）：审批离线推送 + 长期恢复码——① notify 配置 Bark/ntfy/webhook：agent 等待审批/回答且无任何已连接浏览器时推一条"该去处理了"的门铃（仅通知不含任何秘密，按 ID 去重 + 60s 冷却；有浏览器在线则静默）；② pairing.recoveryCode：所有设备丢失时用长期恢复码在 /pair 页自助恢复接入（SHA-256 摘要常时比较，每次恢复注册为可吊销设备，≥16 字符熵下限）。

v1.5：QR 一次性配对 + HMAC 挑战-响应 + HttpOnly Cookie 会话 + 设备注册表（v1 的 ?token= 明文折衷已删除，设计见 docs/PAIRING-DESIGN.md）。

手机扫码(→ /pair#p=sid.secret, secret 留在 fragment)
   → GET /pair/challenge?sid  → {nonce, ts}
   → proof = HMAC(secret, sid|nonce|ts)
   → POST /pair/verify        → Set-Cookie rls=<token> (HttpOnly, SameSite=Strict, 30d)
   → 官方 UI / /api RPC / WS 事件流全部走 cookie，无密码无弹窗

为什么这样设计

• 主 webserver 保持 loopback：DSH 官方 CLI 明确拒绝 --host 0.0.0.0（"would expose remote code execution to the network"）。本插件是"被认可的远程暴露方式"：网关在独立端口做认证，反代到 loopback。
• 官方前端直接复用：不做自己的 UI（dsh-desktop 也是 Electron 壳 loadURL 官方 UI），聊天框就是遥控器。
• ?token= 查询参数认证：浏览器 WebSocket/EventSource API 无法携带 Authorization 头，官方 UI 的事件流（/api/events.mux）在手机上必须有这条通路（与 MiMo 移动端方案一致）。

安装

dsh plugin --profile web add ./dsh-remote-link     # 本地目录
# 或 dsh plugin --profile web add github:<you>/dsh-remote-link

在 $DSH_HOME/profiles/web/cordis.patch.yml 的 remote-link 行配置：

启动日志直接打印一次性配对二维码（ASCII）+ 6 位短码。手机扫码 → 官方 UI 无弹窗打开；扫不了码就在任意设备打开 http://<IP>:3081/pair 输短码。

桌面浏览器打开 http://127.0.0.1:<port>/status 可看链路状态页：网关运行时长、WS 连接代数、每条连接的设备身份（配对设备名 + 来源 IP）、keepalive ping RTT/收发计数、上游健康（目标 + 最近成功 + 最近错误）、隧道连接器心跳年龄、配对倒计时（/status.json 供脚本取数；与 /qr 相同的仅回环可见策略）。

管理工具（聊天框即面板）

• remote_qr：铸新的一次性配对（QR URL + ASCII 图 + 短码 + 剩余有效期）——"给我配对码"。
• remote_devices：list / revoke <名称或ID> / revoke-all——"看看谁连过我 / 踢掉我的旧 iPad"；吊销后会话立即失效。

fork_session 工具

模型可调用：以最近一个已完成回合为边界创建子会话（继承全部上下文，当前会话不受影响），并自动挂回同一工作区。复刻官方 UI "分叉" 按钮的完整配方（边界计算 → agents.create 带 seed/meta → workspace.attachSession）。对用户说"分个叉试试别的方向"即可触发。

也适用于 MiMo Code

网关对上游只做"认证 + 反代"，不限于 DSH。独立运行器可以把任何本地 HTTP 上游变成手机扫码可遥控的服务，已实测 MiMo Code（源码版）：

# MiMo 侧（回环、无密码，认证由网关承担；需先安装 mimo/ 目录的 2 文件补丁恢复 Web UI）
bun run packages/opencode/src/index.ts serve --hostname 127.0.0.1 --port 3000

# 网关侧（局域网模式；流量模式把第一个参数换成公网地址并另起 scripts/cf-tunnel.sh）
node runner-gateway.mjs '' 3081 3000 >| /tmp/rl-gw.log 2>&1 &

手机扫码即得 MiMo 移动端 UI（会话列表 / 消息流 / SSE 流式输出）。安装补丁、 注意事项（预编译二进制 Web UI 被构建期禁用；MiMo 的 SSE 自带心跳、无需 WS 保活） 与出处许可见 mimo/README.md。此模式下聊天框工具 （remote_qr / fork_session 等）不可用——配对由 /qr 页面承担，功能等价。

安全边界

• 非 loopback 绑定且既无密码又关闭配对 → 拒绝加载。
• 配对秘密 5 分钟一次性；QR 里的 secret 只存在于 URL fragment，永不发给服务器；proof 是 HMAC，nonce 单次有效（每次尝试即作废）+ ±300s 时间窗 + 常时比较。
• 会话 cookie：HttpOnly + SameSite=Strict，服务端只存 SHA-256 摘要；吊销设备即刻断线。
• 短码路径以 6 位码为弱共享秘密（20 bit），由独立 10/min 限速桶 + v1 封禁窗 + 5 分钟一次性 TTL 约束，单次配对窗口内猜中概率 ~10⁻⁵。设计稿原定"sid 数字投影"会随 sid 泄漏而可推导，已改为 HMAC 派生（安全修正）。
• 已知未解决（HTTP 天花板）：LAN 嗅探者可复制 cookie 接管会话；devices.json 内含 deviceKey 明文（0600，与进程同权限）。v2 TLS relay 落地后自动收紧。
• Host 头重写为 loopback 以通过 DSH 信任围栏——settings.*、credentials.* 等特权 RPC 在通过网关认证后可达：网关认证是唯一信任边界。
• 认证失败独立计数，超限封禁（429 + Retry-After）。

开发

node --test test/*.test.js            # 107 项（单元 + 真实 socket 集成 + 配对协议正反路径 + WS 保活/清理/健康 + 宿主遥测）
dsh web --patch overlay.yml --port 0  # 真机冒烟：/pair 页 → challenge → verify → cookie → UI/RPC
node scripts/vision-decode.mjs "..."  # 可选：macOS Vision 真扫一遍自产的 QR（需 swift）

零依赖。mDNS 响应器（src/dns-codec.js）为手写实现；QR 编码器使用 vendored 的 qrcode-terminal 核心（Kazuhiko Arase QRCode，MIT，src/vendor/QRCode/，含 UTF-8 补丁），替代早期手写编码器（曾产出结构自洽但扫码器无法识别的码）。内嵌配对页的纯 JS HMAC-SHA256 与 node:crypto 全量交叉验证一致。

sentinel 发布自扫：tarball 判定 review（6 分）——三个 JS-IMPORT-NET medium 即插件本职（认证网关），无 critical/high、无运行时依赖、无生命周期脚本。

windtunnel：remote-link-pairing-happy 用例绿（3/3 断言 + 17/17 L1 契约）；另三例（坏输入/新配对/headless 挂载）卡在 windtunnel headless 权限流语义（permission/preset 后无 tool/result），非插件侧问题，留待风洞侧跟进。

路线图（v2）

• TLS relay 模式（tailscale serve / relay 域名）+ Secure cookie + AEAD
• 官方前端 client module 注入（dsh.client 声明 + window.__ModuleLoader__.load()）
• approval 推送、成本面板、按设备能力分级