YiYan129600/dsh-mobile-access ↗★ 1
dsh-mobile-access
DeepSeek Harness plugin: one-page mobile access setup — Tailscale/LAN detection, scan-to-pair QR, direct/HTTP-2 connection modes (Tailscale Serve toggle), API trust-fence guidance, persistent device credentials, PWA home-screen, and a live SSE notification channel. 适合需要通过局域网或 Tailscale 在手机上便捷访问 DSH 的用户。
同名パッケージの別リポジトリ
インストール
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:YiYan129600/dsh-mobile-accessドキュメント
README 全文を読む ↗使用 / Use
- 打开设置页
http://127.0.0.1:3080/mobile-access,按清单逐项点亮:- 绑定全部网卡:重启时加
--host 0.0.0.0,或把页面里给出的 patch 片段写进 profile 的cordis.patch.yml(推荐,一劳永逸) - Tailscale:电脑与手机各装 Tailscale,用同一账号登录;页面会自动显示
100.xtailnet 地址 - 防火墙:管理员 PowerShell 跑一次页面里给出的 netsh 命令(只放行 Tailscale 网段,公网不暴露)
- 绑定全部网卡:重启时加
- 选连接方式:
- 直连:选地址 → 「生成配对二维码」→ 手机扫码
- HTTP/2:填 HTTPS 域名(如
yiyan.tail172eda.ts.net,从 Tailscale 面板复制)→ 「开启 HTTP/2」(会弹 UAC,点「是」)→ 等清单里「API 信任围栏」变绿(若红:复制页面给出的connection/trustedHosts片段进 profile 的cordis.patch.yml并重启)→ 回到上方生成二维码
- 手机(同一 tailnet)扫码 → 落到配对欢迎页(已配对 ✓ + 设备名 + 凭证有效期)→ 按引导「添加到主屏幕」→ 从主屏幕图标全屏进入 DSH;桌面 UI 无需配对直接可用,
/m移动端需配对
HTTP/2 说明:
tailscale serve监听 tailnet 内网 443,仅同账号设备可达,TLS 证书自动签发。手机上所有请求走一条多路复用连接,高延迟蜂窝网下加载显著更快。注意:HTTP/2 模式手机以*.ts.net域名访问,必须把该域名 concat 进 connection 行的trustedHosts(harness 没有web-app行,patch 该 id 会静默无效),否则/api被 DSH 的信任围栏挡成 403(页面能开、数据全空)——本插件已做探测与 patch 片段引导,杜绝"空壳二维码"。
配置 / Config
在 profile 的 cordis.patch.yml 里可覆盖插件行配置(均为可选项):
- id: mobile-access
config:
pagePath: /mobile-access # 设置页路径
polyfill: auto # auto(默认)=注入带守卫的 randomUUID 脚本(新 harness 零影响); false=彻底关闭; true=强制注入
pairTtlMs: 900000 # 配对令牌有效期(毫秒)
push:
contact: 'mailto:you@example.com' # VAPID 订阅标识(推荐真实邮箱)
# push: false # 完全关闭 Web Push(SSE 不受影响)
http2:
tailscaleBin: 'C:\\Program Files\\Tailscale\\tailscale.exe' # tailscale CLI 路径
HTTP/2 模式还需把 ts.net 域名加入 client-connection 的信任围栏(否则
/api403)。设置页「API 信任围栏」清单项会给出一键复制片段,形如:- id: connection config: trustedHosts: !!js ctx.webRuntime.trustedHosts.concat('yiyan.tail172eda.ts.net')