233fxr-collab/dsh-mobile-push-notify

dsh task/mobile completion notifications: desktop native alerts + PWA/Web Push phone pairing (zero-config)

Project Overview项目介绍

This is a task completion notification plugin for DeepSeek Harness (DSH). It supports native desktop notifications and mobile Web Push via PWA after QR pairing, with one-click Cloudflare tunnel for remote access. Use it when running long DSH tasks away from your computer. Note: the public tunnel exposes DSH to the internet, close it after use.

这是DeepSeek Harness的任务完成通知插件,支持电脑端原生系统通知,手机端扫码配对后通过PWA接收Web Push锁屏通知,可一键开启Cloudflare公网隧道远程查看。适合运行长任务时外出接收通知,注意:公网隧道会将DSH暴露到互联网,用完请及时关闭。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-mobile-push-notify

把 233fxr-collab/dsh-mobile-push-notify 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-mobile-push-notify

DeepSeek Harness (dsh) 任务完成通知插件:一个包、零账号、零手写配置。

  • 电脑端:macOS / Windows / Linux 原生系统通知 + 提示音 + 任务摘要与用时
  • 手机端:扫码配对后,iPhone / Android 以 PWA 形式打开同一个 dsh Web 界面,任务完成时收到 Web Push 锁屏通知,点击直接回到 dsh 查看结果
  • 公网:一键启动 Cloudflare 快速隧道(自动下载 cloudflared,无需账号/域名),人在外面也能收通知和远程查看

与现有方案的关系

目前 dsh 生态里最主流的手机远程监控是“远程同屏 Web 壳 + QR 配对 + 隧道 + PWA/Web Push”(代表:dsh-pocket、@linxin666/dsh-remote-web-ui、dsh-zen-remote)。本插件复用同一套成熟模式,但只聚焦一件事:任务完成时让你第一时间知道,远程界面复用官方 dsh Web,不做第二套 UI。

工作原理(Plugin 层)

一个 npm 包,cordis.patch.yml 自动挂三行宿主插件:

Row 模块 职责
task-notify dsh-mobile-push-notify 监听 session/event 的 turn/end / goal/change,发桌面系统通知
task-notify-gateway dsh-mobile-push-notify/gateway spawn 独立网关:扫码配对、反向代理 dsh Web、PWA/Web Push、cloudflared 隧道
task-notify-push dsh-mobile-push-notify/push 同一套会话事件决策,把完成通知 POST 给网关,网关用 VAPID + aes128gcm 推送到手机

事件语义(与桌面通知完全一致):

  • 普通轮次 turn/end + reason.kind === 'completed' → 通知
  • error / aborted → 通知;max-tokens / blocked 可选
  • 目标模式:goal/change 的 phase === 'complete' 才通知一次,中间轮次不打扰
  • 子代理会话(session.header.parentSession / delegationDepth)默认跳过
  • 手机推送对成功类通知做 3s 去抖;错误/取消不去抖

安装

dsh plugin --profile web add dsh-mobile-push-notify

然后重启:

dsh web

无需任何配置,桌面通知立即生效;网关管理页会打印在启动日志里:

[dsh-mobile-push-notify-gateway] 已启动 · 管理页 http://127.0.0.1:3188/admin · 反代目标 http://127.0.0.1:3080

从 git 仓库安装(开发):dsh plugin --profile web add link:/path/to/dsh-mobile-push-notify

使用

1. 电脑端通知(零配置)

什么都不用做。任务完成时:

  • macOS:通知中心横幅 + Glass 提示音(osascript)
  • Windows:系统 Toast(PowerShell WinRT)
  • Linux:notify-send
  • 系统通知失败时自动响终端铃兜底

2. 手机配对(一次扫码)

  1. 电脑浏览器打开 http://127.0.0.1:3188/admin
  2. 局域网:手机和电脑同一 WiFi,扫「局域网配对」二维码即可
  3. 公网:点「开启公网隧道」,首次会自动下载 cloudflared,稍等出现公网二维码后扫码
  4. 手机自动进入同一个官方 dsh Web 界面,实时同步

3. 开启手机推送(iOS / Android)

  1. 配对进入 dsh 后,页面右下角有「🔔 开启任务通知」按钮,点一下并允许通知
  2. iOS:用 Safari 打开 → 分享 → 添加到主屏幕 → 从主屏幕图标打开 PWA,再点「开启任务通知」(iOS 16.4+;Web Push 必须 HTTPS,请走公网隧道)
  3. Android Chrome/Edge:可直接安装 PWA 或允许通知

之后任务完成,手机锁屏会收到:

✅ dsh 任务完成 修复 CI 构建失败 用时 3min 12s

点击通知会打开 dsh 界面查看结果。

配置

三行插件的默认值已经够用。需要调整时,在 ~/.dsh/profiles/web/cordis.patch.yml 给对应 id 加 config(见仓库根目录 cordis.patch.yml 的注释),或用环境变量。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-skin-claude-code 下一个 Next dsh-remote-acces →