完成提醒通知 tdeluna024-ui/dsh-done-notifier

dsh-done-notifier

License: MIT
dsh-plugin

当 DeepSeek Harness（DSH）的模型完成一轮回复、等待你输入时，自动弹出 macOS 系统通知，并播放一句童声提示音：

「老板，我干完活儿了！快来！」

让你离开电脑或切到别的窗口时，也能第一时间知道「轮到你了」。

demo

目录

- 特性
- 环境要求
- 安装
- 自定义
- 工作原理
- 发布新版本
- License

特性

- 模型每完成一轮回复、状态进入 idle 时触发一次通知。
- 弹出系统通知横幅（标题 DeepSeek，正文 模型已完成，等你回复）。
- 同时用 afplay 播放随包携带的童声提示音（真人神经语音合成）。
- 只通知顶层对话，忽略子代理（subagent）的结束，避免轰炸。
- 单轮内模型连续调用多个工具期间状态保持 running，不会重复触发。
- 纯 JS、零依赖、无需构建授权，从 GitHub 直装即可。

环境要求

- macOS（依赖系统自带的 osascript 与 afplay）。
- DSH 已安装，profile 包含提供 agents 与 shell 服务的宿主组合（@deepseek-ai/dsh-base 即满足）。

非 macOS 平台会打印一条警告并跳过，不影响其他功能。

安装

从 GitHub 直接安装（推荐，无需 npm）：

dsh plugin --profile add github:tdeluna024-ui/dsh-done-notifier

或从发布页下载 tarball 离线安装：

curl -LO https://github.com/tdeluna024-ui/dsh-done-notifier/releases/latest/download/dsh-done-notifier-0.1.0.tgz
dsh plugin --profile add ./dsh-done-notifier-0.1.0.tgz

安装后重启 DSH 生效。若 dsh 不在 PATH，改用：

node /apps/cli/lib/bin.js plugin --profile add github:tdeluna024-ui/dsh-done-notifier

自定义

- 横幅文案：index.js 顶部的 TITLE / BODY 常量。
- 提示音：替换 assets/notify-kid.mp3（afplay 支持 mp3 / aiff / m4a / wav），保持文件名一致即可。

工作原理

- 监听宿主事件 agent/status：状态从 running 回到 idle 即表示「模型跑完、等待用户」。
- 通过 ctx.agents.roots() 识别顶层对话，过滤子代理。
- 用 shell 服务依次执行 osascript（弹横幅）与 afplay（放提示音）。
- 提示音通过 import.meta.url 从包目录解析，不依赖任何用户绝对路径。

发布新版本

本项目用 GitHub Actions 自动打包。推送一个 v* 标签即可自动发布：

git tag v0.1.0
git push origin v0.1.0

工作流会运行 npm pack，把 dsh-done-notifier-.tgz 上传到对应 Release。

License

MIT