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暴露到互联网,用完请及时关闭。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-mobile-push-notify(233fxr-collab/dsh-mobile-push-notify)
仓库:https://github.com/233fxr-collab/dsh-mobile-push-notify
本站详情页:https://www.yhbd.top/plugins/233fxr-collab-dsh-mobile-push-notify/
本站登记:类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 2 · 最近提交 2026-09-06 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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. 手机配对(一次扫码)
- 电脑浏览器打开
http://127.0.0.1:3188/admin - 局域网:手机和电脑同一 WiFi,扫「局域网配对」二维码即可
- 公网:点「开启公网隧道」,首次会自动下载 cloudflared,稍等出现公网二维码后扫码
- 手机自动进入同一个官方 dsh Web 界面,实时同步
3. 开启手机推送(iOS / Android)
- 配对进入 dsh 后,页面右下角有「🔔 开启任务通知」按钮,点一下并允许通知
- iOS:用 Safari 打开 → 分享 → 添加到主屏幕 → 从主屏幕图标打开 PWA,再点「开启任务通知」(iOS 16.4+;Web Push 必须 HTTPS,请走公网隧道)
- 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 →
shaobeichen/dsh-pocket
ningbainb/deepseek-harness-desktop
PM-Shawn/Abu-Cowork
chokwinlee/deepseek-harness-desktop
SCSpotato/dsh-remote
dclichang2022/dsh-green-meter
omdsh-dev/dsh-notification