dsh-done-notifier
当 DeepSeek Harness（DSH）的模型完成一轮回复、等待你输入时，自动弹出 macOS 系统通知，并播放一句童声提示音：
> 「老板，我干完活儿了！快来！」
让你离开电脑或切到别的窗口时，也能第一时间知道「轮到你了」。
目录
- [特性](#特性)
- [环境要求](#环境要求)
- [安装](#安装)
- [自定义](#自定义)
- [工作原理](#工作原理)
- [发布新版本](#发布新版本)
- [License](#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 <你的 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 <你的 profile 名> add ./dsh-done-notifier-0.1.0.tgz安装后重启 DSH 生效。若 dsh 不在 PATH，改用：
node <dsh 安装根目录>/apps/cli/lib/bin.js plugin --profile <name> 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-<version>.tgz 上传到对应 Release。
License
[MIT](./LICENSE)