@dsh-external/dsh-agent-sound-alert
Agent 停止音效提醒：监听会话事件 firehose，在完成、审批询问和异常中断时播放 macOS 系统音效
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:moonlin1213/dsh-agent-sound-alert#3667d06b071ab2e9e94e3eec78e94949046c049dAgent Sound Alert 以 @dsh-external/dsh-agent-sound-alert 发布，当前版本为 0.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A macOS sound notification plugin for DeepSeek Harness. It listens to the Host session event firehose and plays a local system sound when an Agent completes a turn, asks for approval, or stops abnormally.
Package name: @dsh-external/dsh-agent-sound-alert
afplay and /System/Library/Sounds)The repository is open source but intentionally has private: true in package.json: it is distributed as a GitHub source plugin, not published to npm.
| Event | Meaning | Default sound | Setting |
|---|---|---|---|
turn/end completed | Turn completed; waiting for user input | Glass | onCompleted |
approval/asked | Tool approval requested; debounced per session | Tink | onApproval |
turn/end error / blocked | Turn failed or became blocked | Basso | onError |
turn/end aborted (hook / legacy) | Abnormal interruption such as a policy hook | Sosumi | onAborted |
turn/end max-tokens | Output reached its token limit | Glass | onMaxTokens (off by default) |
Subagent sessions are ignored by default. User-initiated cancellation (user, parent, or disposed) and crash-recovery replay (interrupted) do not play a sound.
Open Settings → Plugins → Plugin configuration → agent-sound-alert. Changes apply live.
enabled: master switchvolume: 0 to 1, default 0.7approvalDebounceMs: minimum interval between approval sounds in one session, default 2500includeSubagents: also notify for subagent sessions, default falsenoneThe plugin exposes agent_sound_alert_test; pass completed, approval, error, aborted, or a macOS system sound name.
git clone https://github.com/moonlin1213/dsh-agent-sound-alert.git
cd dsh-agent-sound-alert
npm install --legacy-peer-deps
npm run check
The repository includes a verified lib/ build so a fresh clone can be installed directly. Contributors who modify src/ must run npm run check and commit the regenerated lib/. The build script locates the newest valid installed DSH runtime; set DSH_RUNTIME=/absolute/path/to/runtime when automatic discovery is not appropriate.
Use dev_inject_plugin only while developing:
dev_inject_plugin /absolute/path/to/dsh-agent-sound-alert
This writes a persistent entry to ~/.dsh/super-injector/registry.json; DSH restores it after restart. Development injection is therefore not the same as a temporary one-process load.
dev_install_package requires lib/, which is included in this repository. If you changed the source, complete the Build steps first. Before converting a development injection into a formal bundle installation, remove the development registration first:
dev_uninject_plugin dsh-agent-sound-alert
dev_install_package /absolute/path/to/dsh-agent-sound-alert
Never keep both dev_inject_plugin registration and dsh.profile.bundles registration for the same plugin. Otherwise DSH can restore both copies during cold start and fail with an error such as:
settings namespace "agent-sound-alert" is already registered
The correct formal state is:
dsh.profile.bundles entry~/.dsh/super-injector/registry.jsoninsert or accidental disabled override in cordis.patch.yml--dump-config validates static configuration only. It does not prove that runtime injection restoration and bundle loading will not collide.
After formal installation:
already registered nor plugin tree failed to load.The plugin makes no network requests and collects no telemetry. It only reads DSH session lifecycle events and launches the local macOS afplay process. Custom audio paths are not written to plugin logs or tool responses. Playback is capped at three concurrent processes, and active players are stopped when the plugin is unloaded.
MIT