前言¶
在 DeepSeek Harness(DSH)里跑长任务时,顶层会话往往要等多轮推理才结束。人若盯着页面或反复刷新,既费注意力,也容易错过「已经做完」的时机。常见做法是另写脚本轮询状态,或接企业 IM 机器人,但和 DSH 的会话事件、Web 界面脱节,配置和降级也要自己管。
下面介绍社区插件 dsh-fishgirl-notify(完成提醒 / 肥鱼娘):在 DSH 顶层会话完成一轮任务时,按配置向手机推送「做好啦」类通知,并在 Web 页面内播放肥鱼娘动效弹窗。多通道可插拔,单路失败自动降级,且不会阻塞会话;子代理回合不触发。维护者为 newpage1,分类为工作流,开源仓库见 GitHub,社区目录页为 skillhub.cn。许可证 MIT,当前 package 版本 1.0.1。
这是什么¶
插件监听 DSH 会话与事件管线,在顶层会话完成一轮任务时组装通知并分发;同时在浏览器端注入客户端,展示页内「做好啦~」动效与设置入口。设计目标是「提醒到人 + 页内反馈」,而不是替代 DSH 本身的任务执行。
核心功能¶
多通道推送(可插拔、失败降级)¶
README 列出的通道如下(凭证与平台限制以仓库说明为准):
| 通道 | 平台侧重 | 主要凭证 |
|---|---|---|
| feishu(群机器人) | 全平台,文档标注鸿蒙首选 | 群自定义机器人 webhook |
| feishu-app(自建应用) | 有飞书即可 | App ID / App Secret + 接收方 ID(open_id 或 chat_id) |
| ntfy | 鸿蒙(卓易通)/ 安卓等 | server 与 topic,可选 token |
| webpush | Android / 桌面 Chrome | VAPID(插件可生成)+ 浏览器订阅 |
| inpage | Web 页面 | 无;默认始终启用(SSE 与回放) |
任一通道发送失败不阻塞 DSH 会话;默认 channelOrder 为 [feishu, ntfy, webpush],feishu-app 需自行加入顺序。未知通道 id 会被 registry 跳过并记 debug。
页内动效与设置¶
客户端注入 Web 平台,提供右下角肥鱼娘入口与设置卡:可配置各通道密钥、预览「只在本页测试」动效。页内提醒默认开启。
触发范围¶
仅顶层会话一轮任务完成时触发;子代理回合不触发。这与「等主会话整轮结束再提醒」的使用习惯一致。
安装与启用¶
宿主要求 DSH >= 0.2.1-rc.2(见 package.json 中 dsh.engines 与 peerDependencies)。
1、从 GitHub 安装(官方 README 命令):
dsh plugin --profile web add github:newpage1/dsh-fishgirl-notify
2、若从本地目录调试,使用绝对路径:
dsh plugin --profile web add /absolute/path/to/dsh-fishgirl-notify
3、安装后若页面尚未出现肥鱼娘按钮,重启一次 dsh web(宿主按包名缓存插件模块)。
插件在 web profile 下挂载 bundle patch 与 client,无额外 npm 运行时依赖声明。
配置¶
打开 DSH Web → 设置 → Web 插件 → 完成提醒,或点击页面右下角肥鱼娘按钮:
- 飞书群机器人:填写 webhook
- 飞书应用:填写 App ID、App Secret、接收方 ID
- ntfy:填写 server 与 topic
- Web Push:在支持的浏览器中点击订阅
- 页内动效默认开启;可用「只在本页测试」预览
各通道的申请步骤见仓库内 docs/使用说明.md。配置除 patch 默认值外,可由数据目录 config.json 覆盖(README「与技术方案的偏差」一节说明了未导出 schemastery Config 时的路径)。
典型用法¶
1、安装插件并重启 dsh web(若需要)。
2、在 Web 设置中至少启用一种外发通道(或仅使用页内动效)。
3、发起一次顶层会话任务,待该轮结束后检查:手机或订阅端是否收到通知,页面是否弹出肥鱼娘动效。
开发者自测(README 快速上手,无外网依赖):
node test/run-tests.mjs
仓库说明该脚本包含 34 项断言。手机端授权与鸿蒙 / Android / iOS 差异见 docs/使用说明.md。
适用场景与注意¶
适合谁:经常在 DSH Web 上跑长回合、希望任务结束时用手机或页内得到明确反馈的开发者;已使用飞书、ntfy 或 Web Push 的团队可按现有基建对接。
运行与信任边界:插件随当前 dsh 进程权限运行,会读写本地 secrets、VAPID、订阅等(lib/store.js 等);安装前宜浏览源码与 MIT 许可证,勿在 webhook、topic 等字段填入不可信环境的外链凭证。
平台限制(摘自 README):Web Push 在鸿蒙 / iOS 浏览器侧不支持;ntfy 在鸿蒙需卓易通,且无系统级推送;feishu webhook 校验对回环地址有额外放行,便于本地网关测试。
生态说明:DSH 社区插件目录(如 skillhub.cn)为独立站点,与 DeepSeek / 幻方无官方从属关系;添加插件属于本机扩展行为,非「官方应用商店」分发。
结尾¶
dsh-fishgirl-notify 把「顶层会话一轮完成」这一事件接到飞书、ntfy、Web Push 与页内 SSE 动效上,失败降级且不卡会话,适合作为工作流里的完成提醒层。进一步了解可访问 目录页 与 GitHub 仓库。