dsh-sounds 🔊
> 我给 DeepSeek Harness（一个 AI 编程助手）加的三段提示音：任务完成、任务失败、等待批准时，电脑会响一声提醒我。
| 什么时候响 | 声音 | 感觉 |
|---|---|---|
| 🎉 任务完成 / 回合完成 | 叮咚叮咚叮咚 | 欢快的庆祝三连音 |
| ❌ 任务失败 / 请求出错 | 嘟—— | 低沉的警示音 |
| ⏳ 等待批准 / Agent 提问 | 叮 | 轻轻一声提醒 |
- 声音是浏览器现场合成的（Web Audio），没有音频文件，不占空间
- 完全独立，不影响 DeepSeek Harness 本身，也不用装别的插件
---
专业版说明（给想自己用/改造的人）
它是什么
一个 DeepSeek Harness (DSH) 插件（bundle），订阅官方事件后通过独立 SSE 端点 /harness-sounds/events 推送，浏览器端用 Web Audio 合成播放。
触发事件 → 音效映射
| 场景 | 音效 | 触发事件 |
|---|---|---|
| 任务完成 / 回合完成 | celebrate（523/659/784Hz 上行三连音） | jobs.onJobDone completed、turn/end |
| 任务失败 / 请求出错 | error（170Hz 方波） | jobs.onJobDone failed、agent/request-error |
| 等待批准 | wait（880Hz 短音） | approval/asked |
| Agent 提问选择 | wait（880Hz 短音） | tool/call（ask_user_question） |
架构
Host (Node.js)
jobs.onJobDone / agent/request-error / session/event
→ SSE 广播 /harness-sounds/events
Client (browser)
EventSource 订阅 → Web Audio 合成 → 播放- Host (
.dsh-plugin/index.mjs)：直接订阅官方服务事件，SSE 推送，不依赖任何其他插件 - Client (
.dsh-plugin/client.js)：EventSource订阅 +Web Audio振荡器合成 - 浏览器自动播放策略：首次
pointerdown/keydown解锁 AudioContext
安装到 DeepSeek Harness
1. 把本包放到 web profile 的 node_modules/（或任意 bundle 解析位置） 2. 在 profile 的 package.json 注册 bundle：
{
"dependencies": {
"harness-sounds": "file:./node_modules/harness-sounds"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"harness-sounds"
]
}
}
}3. 重启 dsh web，刷新页面，点击页面任意位置一次（解锁音频）
项目结构
├── index.html # 音效试听页（GitHub Pages 首页）
├── package.json # DSH bundle 声明（dsh.bundle / dsh.client）
├── cordis.patch.yml # 组合补丁：挂载插件
└── .dsh-plugin/
├── index.mjs # Host：事件订阅 + SSE 广播
├── client/
│ └── index.mjs # Client 源码：EventSource + Web Audio
├── client.js # Client 构建产物（bundle 加载）
└── src/
└── session-events.mjs # turn/start · turn/end 边沿解析（纯函数）开发 / 构建
# 构建 client（esbuild → __ModuleLoader__ 包装）
npx esbuild .dsh-plugin/client/index.mjs --bundle --format=cjs --platform=browser --target=es2020 --outfile=.dsh-plugin/client-bundle.js
node wrap-client.mjs .dsh-plugin/client-bundle.js .dsh-plugin/client.js harness-sounds许可证
MIT © 2026