@yangtianlong/dsh-sound
DSH Web GUI 提示音插件：消息完成与需要用户确认时播放提示音。完成音、确认音各自可在 设置→通用 里通过下拉框选择音效（默认合成音 + 自定义上传），上传的音效、开关与选择状态持久化到 $DSH_HOME/dsh-sound/，重启后保留。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @yangtianlong/dsh-sound@0.1.1Sound 以 @yangtianlong/dsh-sound 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
正在加载相关插件…
让 DeepSeek Harness 在该提醒你的时候，真的发出声音。
当 Agent 回复完成或需要你确认时自动播放提示音。支持独立开关、自定义音效、即时试听与本地持久化。
使用 DeepSeek Harness 执行耗时任务时，你往往会切到其他窗口继续工作。DSH Sound 会在两个关键节点把你叫回来：
默认合成音开箱即用，也可以换成你自己的提示音。
| 功能 | 说明 |
|---|---|
| 两类事件提醒 | 分别监听“回复完成”和“需要确认” |
| 独立开关 | 完成音与确认音可以单独开启或关闭 |
| 默认合成音 | 无需准备音频文件，安装后即可使用 |
| 自定义音效 | 为两类事件分别上传并选择自己的音频 |
| 即时试听 | 在设置面板中直接试听当前音效 |
| 本地持久化 | 开关、当前选择和上传音效在重启后保留 |
| 原生设置入口 | 面板集成在 设置 → 通用 → 提示音 |
DeepSeek Harness 实际界面：设置 → 通用 → 提示音
[!TIP] 推荐通过 npm 安装稳定版本；本地开发时再使用下方的
link:方式。
进入 DeepSeek Harness 使用的 profile，然后直接从 npm 安装：
cd ~/.dsh/profiles/<name>
pnpm add @yangtianlong/dsh-sound
如果该 profile 使用 npm 管理依赖，也可以运行：
npm install @yangtianlong/dsh-sound
安装命令会自动把包加入 dependencies。接着打开同一目录下的 package.json，把插件加入 dsh.profile.bundles。如果该字段已经存在，请合并内容，不要覆盖原配置：
{
"dsh": {
"profile": {
"bundles": [
"@yangtianlong/dsh-sound"
]
}
}
}
安装完成后，完全退出并重新打开 DeepSeek Harness。
先克隆仓库：
git clone https://github.com/aloneusername/dsh-sound.git
然后把依赖值换成本地绝对路径，并保持 bundle 名称不变：
{
"dependencies": {
"@yangtianlong/dsh-sound": "link:/absolute/path/to/dsh-sound"
},
"dsh": {
"profile": {
"bundles": [
"@yangtianlong/dsh-sound"
]
}
}
}
再次运行 pnpm install，然后重启 DeepSeek Harness。
“重置”只会恢复当前选择，不会删除已经上传的音频文件。
| 提示音 | 触发条件 |
|---|---|
| 完成音 | 会话中的 Agent 从运行状态切换为结束状态 |
| 确认音 | 会话中新增待处理的审批或提问 |
插件通过浏览器的 Web Audio 能力读取音频。可优先使用 wav、mp3、ogg、m4a、aac、flac 或 webm 等常见格式，实际可解码格式取决于系统和 WebView 支持。
音频会经过 Base64 编码后写入本地，建议单个文件不超过 24 MiB。
所有设置和自定义音效都保存在本机：
$DSH_HOME/dsh-sound/
├── state.json
└── sounds/
├── done/<id>.ext
└── attention/<id>.ext
state.json：保存开关状态、当前选择和音效元数据；sounds/done/：保存完成音；sounds/attention/：保存确认音；确认 package 名称已经同时加入 dependencies 和 dsh.profile.bundles，执行 pnpm install 后完全重启 DeepSeek Harness。
先在设置面板点击一次“试听”，或与页面进行一次点击/键盘交互。系统的自动播放策略可能会在首次交互前暂停 Web Audio。
换用 wav、mp3 或 ogg 等常见格式，并确认文件不超过 24 MiB。
.
├── index.js # 宿主端：配置、音效存储与本地路由
├── client.js # 浏览器端：事件监听、播放引擎与设置面板
├── cordis.patch.yml # DeepSeek Harness bundle 注入配置
├── package.json
└── assets/ # README 封面与真实界面截图
node --check index.js
node --check client.js
npm pack --dry-run
MIT License