dsh-reminder
peon-ping 为 DeepSeek Harness 提供声音通知——忠实移植 pi 插件 pi-peon-ping-win（原生 Windows 音频回退、WinForms 弹窗、OpenPeon 音效包）。默认仅在任务完成或意外终止时发出提示音。设置
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-reminder@0.1.4Reminder 以 dsh-reminder 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
peon-ping sound notifications for DeepSeek Harness (dsh) — a faithful port of the pi plugin
pi-peon-ping-win.
Plays themed audio clips (Warcraft III Peon, GLaDOS, Duke Nukem, StarCraft, …) on lifecycle events using OpenPeon sound packs, and shows desktop notifications — with native Windows support (three-tier audio fallback ffplay → mpv → winmm.dll PlaySound, custom WinForms popup).
This project is a port, not an original work. All credit for the underlying functionality goes to:
Thank you to all of them for the original work and the MIT license that makes this port possible.
| Event | Sound category | Desktop notification | Default sound |
|---|---|---|---|
| Session start | session.start — "Ready to work?" | — | off |
| Agent starts working | task.acknowledge — "Work, work." | — | off |
| Individual tool failure | task.error — error sound | error — body names the failing tool | off (beep and popup follow the tool_error_sounds switch) |
| Task completes | task.complete — completion sound | done — body shows the assistant's last response (truncated) | on |
| Task terminates unexpectedly (error / cancelled / blocked / token limit) | task.error — error sound | error — body names the failure | on |
| Context compaction | resource.limit — limit sound | compacted — body: "Context compacted" | off |
dsh port default: the harness stays quiet — only a task completing or terminating unexpectedly beeps. Everything else (session start, per-prompt ack, spam, individual tool errors, compaction) is off by default and can be re-enabled with /peon toggle <category> (tool errors with /peon tool-error on).
This is the same feature table as the pi plugin; only the host and the default on/off set changed. The event mapping:
| pi event | dsh event |
|---|---|
session_start | session/created (top-level sessions) |
before_agent_start | user/message (kind user) |
agent_start | turn/start |
tool_execution_end (error) | tool/result with isError |
agent_end | turn/end |
session_compact | compaction/end (fires after compaction completes) |
winget install Gyan.FFmpeg for the best experience.Install as a profile plugin:
dsh plugin --profile web add dsh-reminder
Restart the harness (or reload the profile) so the new bundle layer mounts. The bundle patch (cordis.patch.yml) inserts the peon-ping plugin row automatically — no manual cordis.patch.yml editing.
To install from a local checkout:
dsh plugin --profile web add D:/1codeprojects/dsh-plugins/dsh-reminder
To uninstall:
dsh plugin --profile web remove dsh-reminder
All settings live in the web Settings page: open Settings (the gear icon in the sidebar), scroll past Agent Presets to the peon-ping sounds section. There you can:
Changes are written through to ~/.config/peon-ping/config.json immediately, so they apply to the next event without a restart. There is no /peon slash command — the pi TUI panel became this web page.
Settings-page transport: the page talks to the host through the plugin's own
/peon/apiHTTP route (same origin, behind the browser-trust fence), not through the host's settings-namespace allowlist (dsh-host-apiproxy'sWEB_SETTINGS_NAMESPACESadmits only built-in namespaces; a third-party namespace is filtered fromsettings.describeeven when registered). So the settings page works on dsh versions that never addedpeon-pingto that allowlist.
To install specific packs from the registry directly, edit ~/.config/peon-ping/config.json or use the registry's pack names with the page's install action (the page installs the defaults; pack names come from the peon-ping registry).
| Platform | Player | Notifications |
|---|---|---|
| macOS | afplay (built-in) | osascript |
| Linux | pw-play, paplay, ffplay, mpv, play, or aplay (first found) | notify-send (desktop session required) |
| WSL | PowerShell MediaPlayer — the WSL path is converted to the Windows view (wslpath -w → \\wsl.localhost\<distro>\... or D:\...) so the spawned Windows PowerShell can actually open the file | Windows Toast (text-only; no icon — WinRT silently drops icons from WSL paths) |
| Windows (native) ⭐ | ffplay (recommended, winget install Gyan.FFmpeg) → mpv → winmm.dll PlaySound fallback (no volume control) | Custom WinForms popup (multi-monitor, no AUMID needed) |
WSL audio works out of the box on any distro: the \\wsl.localhost\<distro>\... prefix, the user name, and the /mnt/<drive> mounts are resolved dynamically by wslpath -w per machine — nothing is hardcoded.
Config, state, and packs live in the same files the pi plugin uses, so a machine that already ran pi-peon-ping keeps its packs and settings:
~/.config/peon-ping/config.json~/.config/peon-ping/state.json~/.config/peon-ping/packs/| Option | Default | Description |
|---|---|---|
default_pack | "peon" | Active sound pack |
volume | 1.0 | Sound volume (0.0–1.0) |
enabled | true | Master on/off switch |
desktop_notifications | true | Show system notifications on task complete |
categories | task.complete + task.error on, rest off | Per-event toggles for sound and popup (see the feature table) |
tool_error_sounds | false | Individual tool failures: beep + popup when enabled; fully silent when off |
silent_window_seconds | 0 | Suppress task.complete for tasks shorter than N seconds |
annoyed_threshold | 3 | Number of rapid prompts to trigger spam detection |
annoyed_window_seconds | 10 | Time window for spam detection |
relay_mode | "auto" | Relay mode: "auto", "local", or "relay" |
playback_wait_seconds | 2 | Seconds the PowerShell player process stays alive after Play() |
Legacy config with active_pack is migrated to default_pack on load. Packs are also picked up from ~/.claude/hooks/peon-ping/packs (Claude Code).
The extension auto-detects SSH sessions, devcontainers, and Codespaces, and routes audio through the peon-ping relay running on your local machine (see the peon-ping remote development docs). Configure with /peon relay.
The repository is self-contained: all type declarations come from the npm
devDependencies (no vendored or machine-specific paths in tsconfig.json).
npm install
npm test # run tests
npm run typecheck # type check
npm run build # build lib/ (host bundle)
npm run build:client # build lib/client.js (browser bundle)
npm run publish:dry-run # verify the npm package contents
MIT. All credit for the original work goes to joshuadavidthomas (pi-peon-ping) and cppgohan (pi-peon-ping-win, native Windows support).