前言¶
DSH 经常在本机运行,Web 界面适合桌面操作。如果手机上也要访问同一个 DSH,就需要临时暴露本机端口、拿到公网 URL,再确认手机访问 /api 不被信任栅栏拦下,最后把链接发到手机上。dsh-mobile-link 把这些步骤收敛到一个 DSH 插件里:启动本地 DSH Web,创建或复用 Cloudflare quick tunnel,并把手机链接推送到你选择的渠道。
这是什么¶
dsh-mobile-link 是由 Cheng-xiu 维护的 DSH 插件,许可证为 MIT。它让手机通过互联网连接本机 DeepSeek Harness(DSH),并把手机链接自动推送到你的微信,或你选择的其它渠道。
核心功能¶
- 一键启动本地 DSH Web,并创建或复用 Cloudflare quick tunnel,默认转发 3080 端口。
- 自动检测或下载 cloudflared,不要求注册 Cloudflare 账号。
- 启动 DSH Web 时添加
--trusted-host,或动态加入信任栅栏,避免手机访问/api返回 403。 - 支持 Server酱、PushPlus、Bark、ntfy 和自定义 webhook 推送。
- 配置
autoSend后,dsh web启动约 8 秒后自动完成隧道和推送。 - 不依赖 PC 微信客户端,通过 HTTP 推送通知。
- 提供
start、send、setup、tunnel、doctor、status等 CLI 命令。
安装与启用¶
前置要求:已安装 dsh CLI、Node.js >= 18.17,且 pnpm 在 PATH 中。
本插件尚未发布到 npm,需要从本地路径或 GitHub 安装。从 GitHub 安装:
dsh plugin --profile web add github:Cheng-xiu/dsh-mobile-link
安装完成后,重启 dsh web。插件在下次 dsh 启动时进入启动树并生效。
插件以当前 dsh 进程权限运行,安装前建议先检查源码。已核实资料中许可证为 MIT。
配置推送渠道¶
先做一次性渠道配置,再做启动和推送。交互式配置:
node bin/cli.js setup
如果确定使用 Server酱,也可以直接传参数:
node bin/cli.js setup --channel serverchan --key SCTxxxxxxxxxxxxxxxx --port 3080
Server酱 SendKey、PushPlus token 等凭证仅保存在本机 ~/.dsh/mobile-link/config.json,权限为 0600,不会写进仓库或日志。
配置 autoSend 后,每次 dsh web 启动约 8 秒后会自动完成隧道和推送。延迟可在 dsh 配置的 autoSendDelayMs 调整,默认 8000 毫秒。
典型用法¶
下面的命令用于本地调试和正式推送:
node bin/cli.js start
node bin/cli.js start --dry-run
node bin/cli.js start --test
node bin/cli.js send --port 3099
node bin/cli.js tunnel --stop
node bin/cli.js status
node bin/cli.js doctor
start 启动隧道并推送手机链接;start --dry-run 只打印将发送的内容,不真正推送;start --test 发送测试消息而非真实链接。send --port 3099 用于指定端口只推送。tunnel --stop 停止本插件管理的隧道,status 查看隧道与配置状态,doctor 做环境诊断。
干跑调试也可以设置环境变量:
DSH_MOBILE_LINK_DRY_RUN=1
DSH_MOBILE_LINK_TEST=1
CLI 的 --dry-run 和 --test 优先于这两个环境变量。
适用场景与注意¶
适合经常在本机运行 DSH、又需要在外网手机上打开 DSH Web 的使用者。也适合希望避免手动复制临时 URL,并通过微信或自选渠道接收链接的场景。
使用 quick tunnel 时,quick tunnel URL 是公开的,任何知道该 URL 的人都能访问你暴露的 DSH Web。请勿把推送消息中的链接公开分享。
Server酱免费额度有限,以其官网当前说明为准。凭证只保存在本机 ~/.dsh/mobile-link/config.json,不要把 SendKey、token 等外传。
结尾¶
dsh-mobile-link 的价值在于把本机 DSH Web 暴露、手机访问和链接推送放到同一条流程里。已核实资料未提供目录页 URL;GitHub 仓库地址为:
https://github.com/Cheng-xiu/dsh-mobile-link