Victor-770/dsh-reminder

dsh-reminder

DeepSeek Harness（dsh）的 peon-ping 声音通知插件 —— 忠实移植自 pi 插件 pi-peon-ping-win。

在生命周期事件时播放主题音效（魔兽争霸 III 苦工、GLaDOS、Duke Nukem、星际争霸等），并显示桌面通知 —— 支持原生 Windows（三级音频回退：ffplay → mpv → winmm.dll PlaySound，自定义 WinForms 弹窗）。

致谢

本项目是移植作品，并非原创。所有底层功能的功劳归于原作者：

- pi-peon-ping —— Josh Thomas，pi 编程代理的 peon-ping 通知扩展原作。
- pi-peon-ping-win —— cppgohan，添加原生 Windows 支持的 fork（音频回退、WinForms 弹窗、事件感知通知）。
- peon-ping 与 OpenPeon 音效包 / 音效库。

感谢以上项目以 MIT 许可证开源，使本移植成为可能。

功能

| 事件 | 音效分类 | 桌面通知 | 默认音效 |
|-------|----------|----------|----------|
| 会话开始 | session.start —— “Ready to work?” | — | 关 |
| Agent 开始工作 | task.acknowledge —— “Work, work.” | — | 关 |
| 单个工具失败 | task.error —— 错误音效 | error —— 正文标明出错工具 | 关（声音和弹窗都跟随 tool_error_sounds 开关） |
| 快速连续提问（10 秒内 ≥3 次） | user.spam —— 不耐烦语音 | — | 关 |
| 任务完成 | task.complete —— 完成音效 | done —— 正文显示助手最后回复（截断） | 开 |
| 任务意外终止（出错 / 取消 / 阻塞 / 达到 token 上限） | task.error —— 错误音效 | error —— 正文标明失败原因 | 开 |
| 上下文压缩 | resource.limit —— 极限音效 | compacted —— 正文：“Context compacted” | 关 |

dsh 移植默认：保持安静 —— 只有任务「完成」或「意外终止」时会响。 其余事件（会话开始、每次提问的 ack、快速提问、单个工具出错、压缩）默认关闭，可用 /peon toggle  重新开启（工具出错用 /peon tool-error on）。

功能表与 pi 插件一致，只是宿主换成了 dsh，且默认开关集合不同。事件映射：

| pi 事件 | dsh 事件 |
|----------|----------|
| session_start | session/created（顶层会话） |
| before_agent_start | user/message（kind user） |
| agent_start | turn/start |
| tool_execution_end（出错） | tool/result 且 isError |
| agent_end | turn/end |
| session_compact | compaction/end（压缩完成后触发） |

环境要求

- DeepSeek Harness（任意 profile —— 插件以 profile bundle 方式安装）
- 系统装有音频播放器（见下方平台支持）。Windows 上推荐 winget install Gyan.FFmpeg。

安装（npm）

以 profile 插件方式安装：

dsh plugin --profile web add dsh-reminder

重启 harness（或重载 profile），让新的 bundle 层挂载。bundle patch（cordis.patch.yml）会自动插入 peon-ping 插件行 —— 无需手动编辑 cordis.patch.yml。

从本地目录安装：

dsh plugin --profile web add D:/1codeprojects/dsh-plugins/dsh-reminder

卸载：

dsh plugin --profile web remove dsh-reminder

使用方法

所有设置都在网页设置页里：打开设置（侧边栏齿轮图标），在 Agent 预设 下面找到 peon-ping 声音 一节。在那里可以：

- 查看当前状态（音效包、音量、开关、中继模式）和宿主返回的通知信息；
- 安装默认音效包（从 peon-ping registry 下载 10 个默认包）；
- 从已安装的音效包中选择当前使用的包；
- 调节音量；
- 开关桌面通知、工具出错响铃，以及每个音效分类；
- 暂停/恢复声音、设置静默窗口与中继模式；
- 试听 当前音效包的 session.start 声音。

改动会立即写入 ~/.config/peon-ping/config.json，下一次事件即生效，无需重启。已删除 /peon 斜杠命令 —— pi 的 TUI 面板改成了这个网页页面。

设置页的传输通道：设置页通过插件自带的 /peon/api HTTP 路由读写配置（与网页同源，走浏览器信任篱笆），不依赖 dsh 宿主向网页客户端暴露的设置命名空间白名单（dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 只放行内置 namespace，第三方插件的 namespace 即使注册成功也会被过滤）。因此本插件在未把 peon-ping 加入白名单的 dsh 版本上，设置页也能正常显示和操作。

平台支持

| 平台 | 播放器 | 通知 |
|----------|--------|------|
| macOS | afplay（内置） | osascript |
| Linux | pw-play、paplay、ffplay、mpv、play、aplay（按顺序探测） | notify-send（需要桌面环境） |
| WSL | PowerShell MediaPlayer —— WSL 路径会先经 wslpath -w 转换成 Windows 视图（\\wsl.localhost\\... 或 D:\...），Windows 侧才能真正打开文件 | Windows Toast（纯文本，无图标 —— WinRT 对 WSL 路径的图标会静默丢弃） |
| Windows（原生） ⭐ | ffplay（推荐，winget install Gyan.FFmpeg）→ mpv → winmm.dll PlaySound 回退（无音量控制） | 自绘 WinForms 弹窗（多显示器、无需 AUMID） |

WSL 音频在任意发行版上开箱即用：\\wsl.localhost\\... 前缀、用户名、/mnt/ 挂载都由 wslpath -w 在每台机器上动态解析 —— 没有任何写死的路径。

配置与数据

配置、状态与音效包与 pi 插件共用同一目录，已安装过 pi-peon-ping 的机器可直接复用音效包与设置：

- ~/.config/peon-ping/config.json
- ~/.config/peon-ping/state.json
- ~/.config/peon-ping/packs/

| 选项 | 默认值 | 说明 |
|--------|---------|-------------|
| default_pack | "peon" | 当前音效包 |
| volume | 1.0 | 音量（0.0–1.0） |
| enabled | true | 总开关 |
| desktop_notifications | true | 任务完成时显示系统通知 |
| categories | task.complete + task.error 开，其余关 | 各事件的声音与弹窗开关（见功能表） |
| tool_error_sounds | false | 单个工具调用失败：开启时响铃+弹窗，关闭时完全静默 |
| silent_window_seconds | 0 | 对短于 N 秒的任务抑制 task.complete |
| annoyed_threshold | 3 | 触发“快速提问”音效的连续提问次数 |
| annoyed_window_seconds | 10 | 快速提问检测时间窗口 |
| relay_mode | "auto" | 中继模式："auto"、"local" 或 "relay" |
| playback_wait_seconds | 2 | Play() 之后 PowerShell 播放进程存活秒数 |

旧配置中的 active_pack 会在加载时自动迁移为 default_pack。若存在 ~/.claude/hooks/peon-ping/packs（Claude Code），也会自动读取其中的音效包。

远程开发

插件自动检测 SSH 会话、devcontainer 与 Codespaces，并通过本机运行的 peon-ping 中继转发音频（参见 peon-ping 远程开发文档）。用 /peon relay 配置。

开发

仓库完全自包含：所有类型声明来自 npm devDependencies（tsconfig.json 中没有 vendored 或机器相关的路径）。

npm install
npm test              # 运行测试
npm run typecheck     # 类型检查
npm run build         # 构建 lib/（宿主端）
npm run build:client  # 构建 lib/client.js（浏览器端）
npm run publish:dry-run  # 检查 npm 包内容

许可证

MIT。原插件版权归 joshuadavidthomas（pi-peon-ping）与 cppgohan（pi-peon-ping-win，原生 Windows 支持）。