JohnXu22786/notifier

README excerpt

dsh-chime 在 dsh（DeepSeek Harness）上运行的桌面提醒信号插件： 任务完成、等待批准、运行出错 时，在 dsh 所在机器的桌面弹出系统通知，并按需播放提示音——不用一直盯着终端或网页界面。 零运行时依赖：不需要 npm 通知库，直接调用操作系统自带能力（macOS 的 osascript/afplay、Linux 的 notify-send/音频后端、Windows 的 PowerShell 原生组件）。 目录 - 设计理念 - 特性 - 快速开始 - 接入说明（给 dsh 的加载机制） - 事件与信号映射 - 配置 - 命令行工具 - 平台与系统依赖 - 故障排查 - 开发 - 许可 设计理念 「只在需要人回来的时候提醒，不为每个微事件打扰」是插件的核心原则。dsh 每次生成响应、每次工具调用都会产生大量事件，如果全部弹窗，提醒就变成了噪音。因此 dsh-chime 只提炼三类信号： 信号 含义 默认提示音 done 一个回合完整跑完（生成结束） 完成音 blocked 正在等待真人批准 / 需要人介入 警示音 failed 回合或请求出错 错误音 信号在内部沿一条四段流水线流动，每一段都可以独立配置或关闭： 特性 - 三类信号独立控制 ：完成 / 批准 / 报错可分别开关、分别定制文案与音效（事件类型过滤）。 - 跨平台桌面通知 ：macOS、Windows、Linux 原生实现，无需任何第三方包。 - 可定制提示音 ：系统音效或自定义音频文件，支持音量；也可整体静音。 - 自定义文案模板 ：标题与正文均支持占位符（会话、项目、耗时、错误摘要等）。 - 自定义图标 ：桌面通知图标可指定图片文件（Windows 需 .ico，Linux 任意格式）。 - 免打扰时段（hush） ：支持跨午夜窗口（如 22:00–08:00）与按星期生效。 - 频率限制（cadence） ：同类信号最小间隔 + 全局突发上限，防刷屏。 - 审批宽限期 ：审批请求若被自动裁决（策略拒绝/无应答者），不会打扰；只有确实在等真人时才提醒。 - 会话耗时统计 ：完成通知里带上本回合耗时。 - 命令行自检 ：不启动 dsh 也能试响、探测通道可用性、查看生效配置。 快速开始 前置条件：Node.js ≥ 22.19（dsh 的运行要求），已装好 dsh CLI 并初始化过 profile。 或者发布到 npm 后： 验证接入： 试响（不需要 dsh 运行）： 注意：通知发生在 dsh 服务进程所在的机器 上。若 dsh 运行在远程服务器，提醒会出现在服务器桌面，而不是你的本地桌面。 接入说明（给 dsh 的加载机制） dsh 的插件体系是 bundle（包）+ patch（配置层） 双层模型。本插件包包含三个要素： 1. bundle 声明（package…

Category