tdeluna024-ui/dsh-done-notifier

README 摘要

dsh-done-notifier 当 DeepSeek Harness（DSH）的模型完成一轮回复、等待你输入时，自动弹出 macOS 系统通知 ，并播放一句童声提示音： 「老板，我干完活儿了！快来！」 让你离开电脑或切到别的窗口时，也能第一时间知道「轮到你了」。 目录 - 特性 - 环境要求 - 安装 - 自定义 - 工作原理 - 发布新版本 - License 特性 - 模型每完成一轮回复、状态进入 idle 时触发一次通知。 - 弹出系统通知横幅（标题 DeepSeek ，正文 模型已完成，等你回复 ）。 - 同时用 afplay 播放随包携带的童声提示音（真人神经语音合成）。 - 只通知顶层对话，忽略子代理（subagent）的结束，避免轰炸。 - 单轮内模型连续调用多个工具期间状态保持 running ，不会重复触发。 - 纯 JS、零依赖、无需构建授权，从 GitHub 直装即可。 环境要求 - macOS（依赖系统自带的 osascript 与 afplay ）。 - DSH 已安装，profile 包含提供 agents 与 shell 服务的宿主组合（ @deepseek-ai/dsh-base 即满足）。 非 macOS 平台会打印一条警告并跳过，不影响其他功能。 安装 从 GitHub 直接安装（推荐，无需 npm）： 或从发布页下载 tarball 离线安装： 安装后重启 DSH 生效。若 dsh 不在 PATH，改用： 自定义 - 横幅文案： 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 标签即可自动发布： 工作流会运行 npm pack ，把 dsh-done-notifier- .tgz 上传到对应 Release。 License MIT

分类