dsh-sound-cue

中文 · English

DSH Web 提示音：需要你操作时，与任务完成时，各响一声不同的短音。

Two short Web Audio cues for DeepSeek Harness — one when you need to act, one when a task finishes.

试听 / Listen

点击即可试听默认风格 A 的两种提示音（与插件现场合成同一组音符）。若自动播放被浏览器拦住，页面上再点一次即可。

Click to hear the two default (style A) cues — the same notes the plugin synthesizes. If the browser blocks autoplay, click once more on the preview page.

备用链接 / fallbacks:

• 预览页 Preview · htmlpreview
• needs.wav · done.wav

中文

纯客户端实现，用 Web Audio 现场合成，无弹窗、无系统通知、无音频文件依赖。

行为

• 子代理会话的事件默认忽略（skipSubagents: true）
• 同一种音 400ms 内不重复播放
• 浏览器自动播放策略：首次点击/按键后解锁 AudioContext（此后一直有效）
• 完全本地合成：无网络请求、无文件依赖、无隐私外发

安装

dsh plugin --profile web add github:Nixz0824/dsh-sound-cue
# 或本地源码：
dsh plugin --profile web add "link:<本目录绝对路径>"

装完刷新浏览器页面即可生效（客户端 bundle 随页面加载）。

配置

写在本包 cordis.patch.yml 的 insert 行（也可在 profile 的 cordis.patch.yml 里覆盖）：

改配置后刷新页面生效。

结构

• lib/index.js —— 宿主入口（纯客户端插件，宿主侧为空）
• lib/client.js —— 客户端 bundle（官方 ModuleLoader 格式，免构建）
• cordis.patch.yml —— bundle 装配层（insert + 默认配置）
• docs/ —— 试听页与两种提示音的 WAV

lib/ 为手写维护的发布源；改完刷新页面即可。

开发

npm run check
python scripts/gen-preview-sounds.py   # 重新生成 docs/sounds/*.wav

License

BSD-3-Clause.

English

Client-only. Cues are synthesized with the Web Audio API — no popups, no OS notifications, no audio files at runtime.

Behavior

• Subagent sessions are ignored by default (skipSubagents: true)
• The same cue will not replay within 400ms
• Browser autoplay policy: the first click or keypress unlocks AudioContext; it stays unlocked after that
• Fully local: no network, no file dependency, nothing leaves the machine

Install

dsh plugin --profile web add github:Nixz0824/dsh-sound-cue
# or from a local checkout:
dsh plugin --profile web add "link:<absolute-path-to-this-folder>"

Reload the browser page after install (the client bundle loads with the page).

Config

Set on the insert row in this package's cordis.patch.yml (or override from the profile cordis.patch.yml):

Reload the page after changing config.

Layout

• lib/index.js — host entry (empty; this plugin is client-only)
• lib/client.js — client bundle (official ModuleLoader format, no build)
• cordis.patch.yml — bundle patch (insert + defaults)
• docs/ — listen page and the two preview WAVs

lib/ is the hand-maintained source. Edit and reload.

Development

npm run check
python scripts/gen-preview-sounds.py   # regenerate docs/sounds/*.wav

License

BSD-3-Clause.