前言¶
用 DeepSeek Harness（DSH）跑长任务时，人往往不在屏幕前：任务结束、报错、或卡在「等你审批」时，只能隔一段时间回来看一眼。邮件、桌面通知在客厅或通勤场景里也不总是够用。下面介绍社区插件 dsh-alert（维护者 ysl289，分类：工作流）：在 AI 跑完、出错、等你审批等节点，把提醒推到手机；提供七个免费通道可选，只做纯提醒、不带远程审批按钮，也不强依赖其它插件。
这是什么¶
dsh-alert 的定位很单一：把 DSH 里的关键状态变更通知送到手机。它不替代你在电脑上的审批操作，只告诉你「该回来看了」。
- 仓库：ysl289/dsh-alert
- 目录页：SkillHub 插件页
- 许可证：MIT（README 与 package.json 一致）
- 运行环境：Node.js >= 18
- 当前 package.json 版本：1.9.1
DeepSeek Harness 生态采用「一切皆插件」的思路；SkillHub 等目录是社区站点，与 DeepSeek / 幻方无官方从属关系。安装前建议自行查看源码与许可证——插件以当前 DSH 进程权限运行。
核心功能¶
六个触发器（默认全开，可单独关闭）¶
| 触发器 | 何时提醒 |
|---|---|
| 任务完成 | 一轮对话正常结束 |
| 任务出错 | 出错、被中断 |
| 等你审批 | AI 请求执行需批准的命令 |
| 等你回答 | AI 使用 ask_user_question 提问 |
| 任务受阻 | 权限不足、目标被阻塞 |
| 目标完成 | 长期目标达成 |
四道防打扰闸门¶
| 闸门 | 默认行为 |
|---|---|
| 延迟提醒 | 等 20 秒再发；若期间你已回到屏幕操作则取消 |
| 短任务过滤 | 运行不足 30 秒的不发 |
| 免打扰时段 | 可设如 23:00-08:00 |
| 定时汇总 | 可选，例如 30 分钟合并一条 |
以上均可在设置里调整或关闭。
七个免费通道（可多选，任一成功即算成功）¶
按 README 说明，通道包括：ntfy、Bark、Server酱、Webhook（钉钉 / 飞书 / 企微群）、微信（企业微信自建应用）、QQ 机器人、自定义 HTTP。若已安装 @xmanrui/dsh-im，还可选 IM 复用，直接沿用 dsh-im 里配好的机器人与目标。
README 推荐个人用户优先 ntfy：无需注册、不限条数、不用配企业可信 IP。企业微信路径需配置「企业可信 IP」，家庭宽带动态 IP 下个人用户往往难以长期维持。
与其它插件的可选联动¶
缺了对应插件时，增强功能不生效，主流程仍可工作：
| 插件 | 效果 |
|---|---|
| dsh-pocket | 通知内链接换成局域网地址，同 WiFi 下手机可点开 |
| dsh-cost-meter | 提醒可带上本次花费 |
| dsh-claude-style | 设置面板自动切珊瑚色 |
| dsh-im | 增加 IM 复用通道 |
| dsh-notify-windows | 桌面同时弹窗 |
安装与启用¶
插件不是热加载，任意安装方式完成后都需要 重启 DSH（Desktop 退出再开；Web 则重启 dsh web 并刷新浏览器）。重启后进入 设置 → 手机提醒 打开面板。
方式一：插件市场¶
DSH → 设置 → 插件 → 搜索 dsh-alert → 安装 → 重启 DSH。
方式二：对话安装¶
在 DSH 对话里说：
帮我装 dsh-alert
方式三：从 GitHub 安装¶
先进入 profile 目录（通常为 ~/.dsh/profiles/desktop），再执行：
cd ~/.dsh/profiles/desktop
npm install github:ysl289/dsh-alert
在 package.json 的 dsh.profile.bundles 里增加一行 "dsh-alert"，然后重启 DSH。
方式四：本地目录（调试）¶
cd ~/.dsh/profiles/desktop
npm install /path/to/dsh-alert
同样在 bundles 中登记并重启。
典型用法：ntfy 快速开始（约 2 分钟）¶
README 以 ntfy 为例，步骤如下：
- 手机应用商店安装 ntfy（开发者 Philipp Heckel，白底黑色小喇叭图标）。
- 在 DSH 设置 → 手机提醒 中复制面板生成的主题名（形如
dsh-7f3a）。 - 打开 ntfy → 右上角
+→Subscribe to topic→ 粘贴主题名 →SUBSCRIBE。 - 回到面板点击「发送测试」，手机收到即表示通路正常。
主题名是手机与电脑之间的订阅标识，两边必须完全一致；修改后需在 App 里重新订阅。
ntfy 相关字段：主题名必填；服务器默认 https://ntfy.sh；自建且开启鉴权时才填访问令牌；提醒强度默认 high（弹窗置顶），default 仅进通知栏。
其它通道（Bark、Server酱、Webhook、企业微信、QQ、自定义、IM 复用）在面板内有分步说明；Server酱免费版为 5 条/天；钉钉 / 飞书 Webhook 需在机器人安全设置中加自定义关键词 DSH（插件标题均带 DSH）。
设置项概要¶
何时提醒：六个触发器开关；延迟秒数（默认 20）；短任务阈值（默认 30 秒）；免打扰时段与处理方式；定时汇总开关与间隔。
提醒内容：是否带跳回链接（配合 dsh-pocket 更有用）、AI 最后一段回复、工作目录、花费（需 dsh-cost-meter）、是否包含子代理会话等，均有独立开关。
面板外观：可跟随宿主、DeepSeek 蓝或 Claude 珊瑚色。
适用场景与注意¶
适合：长时间 unattended 跑 DSH 任务、需要离开电脑但希望「完成 / 失败 / 待审批 / 待回答」时手机能收到提醒的开发者。
注意：
- 纯提醒，无远程审批；敏感操作仍应在电脑上确认。
- 多通道可同时开启，插件会向已启用的通道发送；失败时 README 说明常见错误码会附带解释与处理建议。
- 企业微信、QQ 等通道配置成本较高；个人场景 README 明确倾向 ntfy 或 Bark（iPhone）。
- 安装与配置涉及第三方 App、机器人密钥与 Webhook URL，请自行保管，勿提交到公开仓库。
结尾¶
dsh-alert 把 DSH 任务生命周期里的关键节点接到手机，用多通道与防打扰规则减少无效推送，并保持对其它插件的弱耦合。需要详情、排错与开发说明时，以 GitHub README 为准。
- 目录页：https://www.skillhub.cn/plugins/ysl289/dsh-alert
- GitHub：https://github.com/ysl289/dsh-alert
