dsh-mobile-link:把本机 DSH Web 推送到手机

前言

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 推送通知。
  • 提供 startsendsetuptunneldoctorstatus 等 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜