在 DeepSeek Harness（DSH）的开发流程中，长时间运行的 Agent 任务往往缺乏实时的听觉反馈，容易导致开发者错过任务完成或异常终止的时机。dsh-reminder 插件将 pi-peon-ping-win 的功能忠实移植到 DSH，通过声音和桌面通知提供任务生命周期的反馈。
核心功能¶
该插件基于 OpenPeon 声音包，在任务状态变化时触发声音和通知：
- 播放主题音频片段。
- 显示桌面通知。
- 原生 Windows 支持，具备三级音频回退机制：
ffplay→mpv→winmm.dll。 - 自定义 WinForms 弹出窗口。
- 支持 OpenPeon 声音包。
安装¶
作为 Profile 插件安装：
dsh plugin --profile web add dsh-reminder
安装后需重启 Harness 或重新加载 Profile，插件会自动插入 cordis.patch.yml 配置。
配置与使用¶
所有设置均通过 Web 界面完成，无需使用 /peon slash 命令。
- 打开 Web 设置页面（侧边栏齿轮图标），滚动至 “Agent Presets” 下方找到 “peon-ping sounds” 区域。
- 在该区域可以：
* 安装默认声音包：直接从 peon-ping registry 下载 10 个默认包。
* 选择声音包：从已安装的包中切换激活状态。
* 调整音量：设置播放音量。
* 切换开关：控制桌面通知、工具错误提示音以及各类别的发声（如task.complete、task.error等）。
* 设置静音窗口：配置忽略短于指定秒数的任务完成提示。 - 配置修改会实时写入
~/.config/peon-ping/config.json，无需重启即可生效。
平台支持¶
插件支持多平台，音频播放器根据系统自动选择：
- Windows：推荐安装 FFmpeg（
winget install Gyan.FFmpeg），回退顺序为 ffplay → mpv → winmm.dll。 - macOS：使用系统内置的
afplay。 - Linux：优先尝试
pw-play、paplay、ffplay、mpv、play或aplay。 - WSL：通过 PowerShell
MediaPlayer播放，路径会自动转换为 Windows 视图。
注意事项¶
- 默认行为：默认仅任务完成或异常终止时发声，其他事件（如会话开始、工具错误等）默认关闭。
- 权限依赖：插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
- 数据共享：配置文件与 pi-peon-ping 共享，位于
~/.config/peon-ping/目录。
