dsh-mobile-notify
DeepSeek Harness（DSH）插件：任务完成后，把通知推送到你的手机。
English | 简体中文
装上它之后，DSH 里的任务一停下来，你的手机就会收到一条消息：结束了什么、在哪个目录、跑了多久、最后说了什么。
✅ DSH · 重构 runner
✅ 任务完成
会话：重构 runner
目录：D:\Desktop\over
耗时：2 分 13 秒
回合：第 4 轮
回复：八个分支都改完并通过测试了。
时间：2026/10/2 16:02:11
特性
- 🔔 10 个推送渠道：ntfy、Bark、钉钉、企业微信、飞书、Server酱、PushPlus、Telegram、Qmsg酱、通用 webhook。全部只要一次 HTTPS 请求，不需要自建服务器。
- 🤫 默认不打扰：只有智能体彻底停下来才发一条 —— 一个 goal 连续跑十轮也只推一条；子代理会话默认不推。
- 🧩 纯 Host 插件：不注入客户端代码、不往会话日志里写事件、不轮询状态；发送失败只写日志，绝不影响会话本身。
- ⚙️ 26 项配置全部带默认值，在
cordis.patch.yml里覆盖即可；每项都有中文说明，会以表单形式出现在插件设置里。 - 🧪 可离线自测：26 项断言覆盖 10 个渠道的请求构建与业务码判定；还带一个本地假推送服务器做端到端联调。
快速开始（以 ntfy 为例，约 2 分钟）
第 1 步：手机装 ntfy App，订阅一个主题
- App Store / Google Play / F-Droid 搜 ntfy（开源、免注册）。
- 打开 App →
+→ 填主题名（例如dsh-7f3a91c2）→ 订阅。
第 2 步：安装插件（见下一节）
第 3 步：把主题名填进配置
编辑插件目录里的 cordis.patch.yml：
- insert:
- id: mobile-notify
name: 'dsh-mobile-notify'
config:
channel: ntfy
ntfyTopic: 'dsh-7f3a91c2' # ← 改成你订阅的主题名
改完按更新插件的两步重装一次，然后让 DSH 跑一个任务试试。
⚠️ ntfy.sh 的公共主题任何人只要猜到名字就能订阅。请用随机串（
dsh-7f3a91c2这种），不要用dsh、test之类；或在自建 ntfy 上开启访问控制后填ntfyToken。
安装
前置条件
- DSH 桌面端在运行（Node ≥ 18，自带
fetch）。 - 两种方式二选一：直接让 DSH 从 GitHub 取包（需要能访问 github.com），或先 clone 到本地（适合要改代码 / 用离线压缩包）。
方式一：一行从 GitHub 安装（推荐）
让 DSH 里的智能体执行（或自己在插件管理页填）：
plugin_manager action=install_bundle target=github:zjhaaa042-cloud/dsh-mobile-notify
返回 application: "applied" 即装好。target 是一条安装 spec，插件管理器接受这几种形式：
| 形式 | 示例 | 说明 |
|---|---|---|
| git 简写 | github:zjhaaa042-cloud/dsh-mobile-notify |
最省事 |
| git 地址 | git+https://github.com/zjhaaa042-cloud/dsh-mobile-notify.git |
等价写法 |
| 仓库页地址 | https://github.com/zjhaaa042-cloud/dsh-mobile-notify |
直接粘浏览器地址 |
| 锁版本/分支 | github:zjhaaa042-cloud/dsh-mobile-notify#v1.0.0 |
# 后跟 tag、分支或 commit |
| 本地绝对路径 | D:\dsh\dsh-mobile-notify |
见方式二 |
| 压缩包 | https://…/dsh-mobile-notify-1.0.0.tgz |
内网分发可用 |
| npm 包名 | dsh-mobile-notify |
尚未发布到 npm |
从 git 装不需要手动
npm install：pnpm 会把依赖@deepseek-ai/schemastery一起装进 profile 的虚拟store，裸导入能正常解析。只有用「本地路径」（link:）安装时才必须先在插件目录跑npm install（原因见方式二）。
装好后到 设置 → 插件 配置 channel、ntfyTopic 等字段（26 个，见 docs/configuration.md）。
方式二：clone 到本地再装（要改代码或用离线包）
git clone https://github.com/zjhaaa042-cloud/dsh-mobile-notify.git D:\dsh\dsh-mobile-notify
cd /d D:\dsh\dsh-mobile-notify
npm install
npm install 会装好本插件唯一的依赖 @deepseek-ai/schemastery（Config 校验用）。
然后让 DSH 里的智能体执行，或自己在插件管理页操作：
plugin_manager action=install_bundle target=D:\dsh\dsh-mobile-notify
返回 application: "applied" 且 warnings: [] 就是装好了；此时插件目录右侧会出现「手机通知」的图标与说明。
为什么必须先
npm install？ DSH 用link:方式安装本地包，pnpm 不会替被链接的包安装它自己的依赖；而 Node 是按包的真实路径解析裸导入的，所以插件目录里必须有node_modules。缺少时会出现dsh: warning: 1 entry did not activate+failed to import。
更新插件
改完代码或配置后，必须两步，直接重装会失败：
plugin_manager action=remove_bundle target=dsh-mobile-notify
plugin_manager action=install_bundle target=D:\dsh\dsh-mobile-notify
原因：同名依赖已在 profile 里时，pnpm add <本地目录> 不会改动依赖版本，插件管理器因此无法确定「装了什么」，会抛 ambiguous-install。remove_bundle 不会删除你的仓库文件，只把它从 profile 里摘掉。
改完 JS 代码需要这两步（重建模块）；只改文档不需要。
卸载
plugin_manager action=remove_bundle target=dsh-mobile-notify
支持渠道
| 渠道 | channel |
必填配置 | 手机端 | 备注 |
|---|---|---|---|---|
| ntfy | ntfy |
ntfyTopic |
ntfy App | 推荐：免注册、可自建 |
| Bark | bark |
barkKey |
Bark App | iOS |
| 钉钉 | dingtalk |
webhookUrl（+ dingtalkSecret） |
钉钉 | 自定义机器人，支持加签 |
| 企业微信 | wecom |
webhookUrl |
企业微信 | 群机器人 |
| 飞书 | feishu |
webhookUrl（+ feishuSecret） |
飞书 | 自定义机器人，支持签名 |
| Server酱 | serverchan |
serverchanSendKey |
微信 | 微信服务号推送 |
| PushPlus | pushplus |
pushplusToken |
微信 | 微信推送，免费额度 |
| Telegram | telegram |
telegramBotToken + telegramChatId |
Telegram | 需要能连 Telegram |
| Qmsg酱 | qmsg |
qmsgKey |
QQ 个人号无官方接口，走第三方 | |
| 通用 webhook | webhook |
webhookUrl（+ webhookHeaders） |
任意 | 自己接中转（企业微信/钉钉中转、自建 App 推送等） |
每个渠道的手把手配置步骤见 docs/channels.md。
配置
配置写在插件目录的 cordis.patch.yml 的 config: 段里，26 项全部有默认值 —— 只填你要改的即可。常用项：
| 配置 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关 |
channel |
ntfy |
推送渠道 |
trigger |
idle |
idle：彻底停下才通知；turn-end：每个回合都通知 |
notifyOn |
all |
all / completed（只推正常完成）/ error（只推异常） |
includeSubagents |
false |
子代理会话是否也通知 |
minTurnDurationMs |
0 |
只通知耗时 ≥ 该毫秒数的回合（例如 10000 跳过短任务） |
includePreview |
true |
是否附带助手最后一段回复 |
previewMaxChars |
200 |
摘要长度上限 |
timeoutMs |
10000 |
单次请求超时 |
dryRun |
false |
演练模式：只构建请求不发送 |
logPayload |
true |
把发送结果写进 DSH 日志 |
完整字段表（含各渠道密钥、类型、取值范围、示例）见 docs/configuration.md。
触发方式
trigger |
触发时机 | 适合 | 噪音 |
|---|---|---|---|
idle（默认） |
agent/status 落到 idle：没有 driver 仍在调度或活动 |
长任务、goal 多轮续跑 | 一次任务一条 |
turn-end |
每个 turn/end |
想知道每一步 | 每回合一条 |
两种方式都会按「每个会话最后已通知的 turn/end」去重，不会重复发同一次结束。idle 还会跳过超过 120 秒的陈旧结束状态（防止插件刚加载时对历史结果误报）。
通知长什么样
标题：<图标> DSH · <会话标题>，正文按渠道渲染成纯文本或 Markdown：
| 结束原因 | 图标 | 文案 |
|---|---|---|
completed |
✅ | 任务完成 |
error |
❌ | 任务出错 |
aborted |
⏹️ | 任务已中止 |
interrupted |
⏹️ | 任务被中断 |
blocked |
⛔ | 任务被阻塞 |
max-tokens |
⚠️ | 达到输出上限 |
forked |
— | 永不通知（不是一次完成） |
正文行：会话 / 目录 / 耗时 / 回合 / 来源：子代理会话（仅子代理）/ 回复：…（includePreview 打开时）/ 时间。
工作原理
会话事件 ──► 过滤 ──► 渲染文案 ──► 构建请求 ──► HTTPS POST
- 触发：订阅宿主的持久事件 ——
session/event的turn/end，或agent/status转为idle。不轮询、不写会话日志。 - 过滤：
forked永不发；notifyOn、includeSubagents、minTurnDurationMs、idle新鲜度逐层筛。 - 渲染：会话标题取自最后一条
session/title事件；回复摘要取自最后一条assistant/message的文本块；耗时 =turn/end− 同回合turn/start。 - 发送：
notify.js把通知构建成{url, headers, body}并 POST，判定成功要同时看 HTTP 状态和渠道业务码（例如钉钉errcode === 0）；超时或失败只写日志，不影响会话。
常见问题
- 没收到通知 → 先用真机单发脚本验证链路：
npm run send -- https://ntfy.sh <你的主题>；返回ok: true说明服务端已接受，问题在手机端订阅。 - 插件没生效 → 安装时返回
application: "failed"或日志里有did not activate，多半是没跑npm install（见安装）。 - 重装报
ambiguous-install→ 忘了先remove_bundle（见更新插件）。 - 只想知道「大任务」结束 →
minTurnDurationMs: 60000。 - 团队协作时太吵 → 保持
includeSubagents: false（团队成员都是子代理会话，只有主线结束才推）。想让每个成员都推就设为true。 - DSH 关掉还有通知吗 → 没有；需要 DSH 进程在运行（窗口最小化没关系）。
- 其他工作区 / profile → 插件装在哪个 profile 就对该 profile 下所有工作区生效；别的 profile 需要各装一次。
更多排查见 docs/troubleshooting.md。
开发与测试
npm test # 26 项离线断言：请求构建 + 业务码判定 + 失败/超时/dryRun
npm run mock # 本地假推送服务器（127.0.0.1:18080），配合 channel: webhook 做端到端联调
npm run send -- https://ntfy.sh <主题> # 真机单发
目录结构：
├── index.js # DSH 侧：订阅事件、过滤、渲染、调用发送
├── notify.js # 纯 Node 逻辑：文案渲染 + 请求构建 + 发送与判定（不 import DSH）
├── cordis.patch.yml # 插件行与 config（安装时读入）
├── locale/{zh,en}.json # 插件在界面里的标题与说明
├── icon.svg # 插件图标
├── docs/ # 渠道、配置、开发、排错文档
└── test/ # 离线自测 + 假服务器 + 真机单发
架构说明、如何新增一个渠道、发布注意事项见 docs/development.md。
No comments yet. Be the first to write one.