dsh-coding-sound

中文（默认） · English

DeepSeek Harness（DSH）声音插件：用声音盯住 Agent。模型输出时演奏生成式背景音乐，完成、审批/等待、思考与工具执行各有可配置的提示音——不盯着屏幕，也能凭声音知道它是在思考、还在干活、还是卡在等你。

关键词：DeepSeek Harness 声音插件 · 背景音乐 · 提示音 · 完成提醒 · 审批提醒 · 通知音效 · 声音反馈 · 专注 · 注意力 · 效率 · AI 助手声音提醒 background music · notification sound · completion chime · approval alert · focus · attention · productivity · dsh sound plugin

为什么装它

• 不用一直盯着屏幕：音乐跟着模型正在输出的文字走，停下来那一刻你听得到；思考、回答、工具执行三个阶段的声音可以分别调。
• 减少「AI 在等你」：审批与提问会响一次独立的「等待操作」提示音，切到别的窗口也不会漏掉。
• 保持节奏感：音符由正在输出的文字驱动，快慢就是它的工作节奏——它还在动，你就听得到。
• 不打扰：全部用 Web Audio 在浏览器里合成，包内没有任何音频素材；音乐、通知音量、每个阶段的频率与音高都能单独关闭或调整。

Generative background music and notification chimes for DeepSeek Harness: hear whether the agent is thinking, still working, or waiting for you, without watching the screen. Every sound is synthesized in the browser with Web Audio — the package ships no audio assets.

设置页新增一页「声音与提醒」，卡片与参考桌面版的声音设置同构：

🔊 声音与提醒                                  [已自定义]  ⌃
   背景音乐与完成/等待提示音
─────────────────────────────────────────────────────────
生成式背景音乐   [数字        ⌄]  ▶
通知音量         ────────────●  100%
生成完成         [合成音效    ⌄]  ▶
等待操作         [合成音效    ⌄]  ▶
当前会话音量     ────────────●  100%
其他会话音量     ──────────●──   80%

🔊 阶段声音
   思考 / 回答 / 工具执行，可分别关闭、调频率与音高
─────────────────────────────────────────────────────────
思考        [●]   [2 字/拍 ⌄]   [标准 ⌄]   ▶
回答正文    [●]   [4 字/拍 ⌄]   [标准 ⌄]   ▶
工具执行    [●]   [0.9 秒 ⌄]    [标准 ⌄]   ▶

左侧设置导航的「声音与提醒」使用扬声器图标：宿主对未知 section id 只提供齿轮兜底，插件在 section 的 label 里带自己的图标，并用一条只命中本行的样式隐藏兜底齿轮（宿主若改结构，最坏退回齿轮 + 扬声器两个图标，不影响功能）。

行为

场景	行为
某个会话开始输出	该会话的音乐淡入（0.25 s）；按当前阶段的密度取拍（回答默认每 4 字、思考默认每 2 字），且两拍间隔 = max(100 ms, 60 + 30 × 密度) ms——密度同时决定「几字一拍」和最快出音速度，所以试听听得到的快慢就是实际运行的速度，C 大调五声音阶随机取音，15% 概率低八度，±5% 随机 detune
输出中	节拍跟随真实字符增量，不是固定循环；整段挂载/重渲染/换会话不会被误当打字
思考（reasoning）	有：思考段和回答正文一样逐 token 出音符；可在「阶段声音 → 思考」里改密度（1/2/3/4/6/8 字一拍）、音高（低/标准/高）或关闭
工具执行	有：工具行本身不出音符；当前会话空闲约 1.2 s 后进入「工作脉冲」，频率可选 0.1 / 0.15 / 0.2 / 0.3 / 0.4 / 0.6 / 0.9 / 1.2 / 1.6 / 2.0 s 一拍（最快与思考密度 1 的 100 ms 相同），音高可选低/标准/高，或关闭。相邻两拍的间隔在设定值上下随机浮动（三角分布，约 ±35%；另有约 15% 概率拉长到 1.6–2.4 倍），听感更像打字机而不是节拍器；行内「随机」开关可以关闭浮动、回到固定节拍。音量与文字拍一致。等待审批时暂停并响「等待操作」
某个会话进入等待操作	只停这个会话的音乐（0.25 s 淡出），并响「等待操作」；其他会话照常
一轮结束	当前会话 320 ms 防抖后响「生成完成」；子代理会话不响
切会话	当前会话按「当前会话音量」、其他会话按「其他会话音量」，0.25 s 交叉过渡
其他会话在后台工作	以「其他会话音量」播放缓慢的环境脉冲（约 0.7–1.1 s 一拍）；切到该会话后改为逐字节拍
窗口在后台	继续发声；回到前台恢复，不补放积压音符

• 阶段声音独立于主卡片：思考、回答、工具执行各有一个开关，关闭某一阶段后该阶段不出声；被关闭阶段里的文字仍然算作“有活动”，不会让工作脉冲趁机补进来。
• 每行都有试听：思考/回答的 ▶ 用当前密度与音高播一小段上行音，音与音的间隔就是实际运行时该密度的出音间隔；工具执行的 ▶ 按当前脉冲频率与音高播 2–3 下，开启「随机」时使用同样的随机间隔。试听和实际运行一样，都是满音量（与文字拍相同）。即使背景音乐预设是「关闭」，试听也使用默认预设发声。
• 工作脉冲只补“没有文字的空窗”：一旦有字符到达就回到逐字节拍，且脉冲不会和文字拍叠加。
• 音乐与通知音完全隔离：「通知音量」只作用于两个提示音，音乐音量由预设自身的主增益 × 会话音量决定。
• 去重：「等待操作」按 turn + prompt 身份去重（上限 512），断线重连/重放不会重复响；打开页面时已经存在的等待状态不会补响。
• 音频挂起时不排队：页面/系统把 AudioContext 挂起时不再排新音符，恢复后从当前节奏继续。否则挂起期间的所有音符会共用同一个时间戳，恢复瞬间同时发声——听感上就是一声爆音或「沙沙/嗡嗡」的杂音。
• 多窗口：每个浏览器标签各自发声（未做跨窗口互斥）。

默认值

项	默认
生成式背景音乐	数字（digital）
通知音量	100%
生成完成	合成音效（synth）
等待操作	合成音效（synth）
当前会话音量	100%
其他会话音量	80%
思考声音	开，每 2 字一拍，音高「标准」
回答声音	开，每 4 字一拍，音高「标准」
工具执行	开，脉冲频率 0.9 s（十档：0.1 / 0.15 / 0.2 / 0.3 / 0.4 / 0.6 / 0.9 / 1.2 / 1.6 / 2.0 s），间隔随机浮动（可关闭），音高「标准」
卡片展开状态	展开（持久化）

设置按浏览器保存（localStorage），刷新页面、重启 DSH 后仍在；换一个浏览器是另一套设置。 所有值在读取时都会夹紧/校验，损坏或被手改的存储不会让页面报错。

音乐预设

预设	波形	attack	decay	sustain	release	低通	混响 decay	wet	主增益
空灵	sine	.1	.4	.4	.8	3000	.8	.35	.07
经典	triangle	.01	.2	.2	.3	2000	.3	.2	.08
数字	square	.005	.1	.1	.1	5000	.05	.05	.06
复古	sawtooth	.02	.3	.3	.4	1500	.35	.25	.08

信号链：每会话 gain → 共享低通(Q=1) → 主增益 → 输出，低通同时旁路 卷积混响 → wet → 主增益。 一个页面只有一个 AudioContext（浏览器同时只允许少量），切换预设就地重建链路并重新挂接所有会话声部。

通知音效

6 个选项：关闭 / 合成音效 / 正面通知 / 正确提示 / 界面启动 / 界面返回。全部由 Web Audio 实时合成，包内不含任何第三方音频素材。

每个音是正弦主音 + 4 倍频 shimmer（12% 电平，衰减到 0.6× 时长）：

选项	音型
合成音效	完成：1318.5 → 1568 → 2093 Hz；等待：1760 → 1318.5 Hz
正面通知	上行二音 1318.5 → 1760 Hz
正确提示	确认二音 1046.5 → 1568 Hz
界面启动	上行琶音 523.25 → 659.25 → 783.99 → 1046.5 Hz
界面返回	下行二音 783.99 → 523.25 Hz

• 最终增益 = 通知音量 / 100 × 选项电平；四个命名选项沿用原素材的响度比例（正面 .62 / 正确 .85 / 启动 1 / 返回 .70），切换时不会忽大忽小。
• 「合成音效」按场景区分完成/等待两种音型；四个命名选项对两个场景使用同一段音型（与原素材行为一致）。
• 音量为 0 时两个提示音都不播；浏览器不支持 Web Audio 时设置页给出提示，页面其余功能不受影响。

安装

dsh plugin --profile desktop add dsh-coding-sound

装完到 设置 → 插件 启用 dsh-coding-sound，然后完全退出并重开 DSH；设置页会多出 声音与提醒。

本地开发用 link 安装；改 src/ 后重建 client.js 并刷新页面即可：

dsh plugin --profile desktop add link:/path/to/dsh-coding-sound
node build.mjs

• 没有原生依赖、没有安装脚本，client.js 已预构建，macOS / Windows / Linux 行为一致。
• 离线安装：npm pack 得到 tgz，拷到目标机后执行 dsh plugin --profile desktop add <tgz>，同样在设置里启用并重启。
• 运行时不联网：所有声音由 Web Audio 合成，包内没有音频素材。

设置与存储

设置保存在浏览器 localStorage（键 dsh:coding-sound:v1），刷新、重启后仍在；不同浏览器各自独立。Safari 首次出声需要点一下页面，这是浏览器的自动播放策略，插件已处理恢复。

兼容性

• 与 dsh-typewriter-blip、ui-beep 等声音插件可以并存：不共享 DOM 节点，也不改写彼此的 DOM。
• 浏览器不支持 Web Audio 时，设置页会给出提示，页面其余功能不受影响。

素材与许可

插件不包含任何第三方音频素材：6 个通知音效全部由 Web Audio 实时合成。源代码以 MIT 许可发布，见 LICENSE。

---

English

中文简介：用声音盯住 Agent——模型输出时演奏生成式背景音乐，完成、等待操作、思考与工具执行各有提示音。

Generative background music and notification chimes for DeepSeek Harness (DSH): hear whether the agent is thinking, still working, or waiting for you, without watching the screen.

• Generative music while the model streams — notes follow the real character stream, not a fixed loop. Four presets (Ethereal / Classic / Digital / Retro) and one voice per session, so two busy sessions never collide.
• Separate chimes — completion and waiting-for-input are distinct; six synthesized options, with a notification volume independent of the music.
• Per-phase sounds — thinking, answer and tool execution each have their own switch, a rate (characters per beat or pulse interval) and a pitch; the tool pulse can jitter like a typewriter.
• Settings card — Settings → Sound & alerts, with an audition button on every option and separate current/other session volumes.

Install:

dsh plugin --profile desktop add dsh-coding-sound

Local development uses a link install, so src/ edits are picked up after a rebuild and a page refresh:

dsh plugin --profile desktop add link:/path/to/dsh-coding-sound

Defaults: Digital preset, notification volume 100%, "Synth" completion and waiting chimes, current session 100%, other sessions 80%, thinking every 2 characters, answer every 4, tool pulse 0.9 s with the random jitter on.

All sounds are synthesized in the browser with Web Audio — the package ships no audio files. Settings live in the browser's localStorage (dsh:coding-sound:v1), so each browser keeps its own. MIT.

---

同作者的其他插件 · More plugins by the same author

• DSH 分屏工作区（dsh-split-workspace）— 把 DSH 会话区拆成任意数量的原生窗格：左右、上下、田字 2×2 与自动网格，每个窗格都是独立会话。
  DSH split workspace (dsh-split-workspace) — Split the DSH conversation area into unlimited native panes — side by side, stacked, 2×2 and an automatic grid — each a real session with its own composer and streaming.

支持作者 · Support the author

如果这个项目帮你省下了盯屏幕的时间，欢迎请作者喝杯咖啡 ☕，或者给作者「充充电」⚡。金额随意，心意最重要。

If this project saved you some screen time, you can buy the author a coffee ☕ or top up the author's battery ⚡. Any amount is welcome — the thought counts.

_{支付宝 · 微信支付 / Alipay · WeChat Pay}