前言¶
在 DeepSeek Harness (DSH) 的 Web 环境中，智能体执行任务时，用户往往正在做其他事情，难以第一时间察觉任务结束。dsh-turn-chime 插件利用 DSH 的渲染插槽机制，在智能体回合结束时自动播放提示音，帮助用户快速捕捉任务完成信号。
核心功能¶
该插件专注于解决“任务完成无感”的问题，主要包含以下能力：
* 任务完成后播放提示音。
* 提供设置页，支持开关提示音、调节音量。
* 支持上传自定义音频文件，格式包括 MP3、WAV、OGG、M4A。
* 内置两音铃声合成功能。
* 三重触发保险机制：新鲜度窗口（60 秒）、页面稳定窗口（3 秒）、去重机制（200 条上限）。
* 设置与音频存储在宿主端，支持跨浏览器持久化。
* 隐私保护：不读取凭据、不访问外网、不修改 DSH 内核。
安装与启用¶
安装前需确保环境满足要求：Node.js ≥ 20, pnpm ≥ 10。
使用官方 CLI 安装：
dsh plugin --profile web add dsh-turn-chime@latest
安装完成后，必须重启 dsh web 进程，并在浏览器中执行硬刷新（Ctrl/Cmd+Shift+R）以加载最新代码。
配置与使用¶
插件安装后，在 DSH 设置页中找到“提示音”相关选项。
- 开关与音量：在设置页开启提示音，拖动音量滑块调节至合适大小。
- 试听：点击“试听”按钮确认当前音量下的播放效果。
- 自定义音频：点击“上传音频”选择本地文件，支持最大 8 MB 的音频文件。上传后自动生效。
- 恢复默认：如需使用内置铃声，可在设置页点击“恢复内置”。
插件会将配置文件与音频文件存储在宿主端的 ~/.dsh/turn-chime/ 目录下。
工作原理与限制¶
- 触发机制：插件注册在 DSH 的
conversation.chat.assistant-actions插槽上，通过渲染一个隐形条目（渲染null）来标记任务完成时刻。 - 保险机制：为了防止干扰，设置了三道保险：只有 60 秒内的新鲜回合会响、刚打开页面 3 秒内的渲染不算、同一回合最多响一次。
- 生效范围：提示音仅对当前打开的会话生效。任务失败或中断时也会播放提示音，目前不区分成功与失败状态。
- 浏览器限制：由于浏览器自动播放策略，首次使用需在页面上有一次交互（点击或按键）以解锁音频权限，之后任务完成即可自动播放。
结语¶
dsh-turn-chime 是一个轻量级的 DSH Web 插件，它利用官方公开的渲染插槽，在不侵入内核的前提下提供了任务完成的听觉反馈。适合需要清晰感知智能体执行进度的开发者使用。
