前言¶
在 DSH「一切皆插件」的扩展方式下，很多体验细节都可以拆成独立插件处理。多轮任务、计划模式、工具执行、审批请求、报错，这些状态变化如果只靠盯屏，后台窗口里很容易被漏掉。
dsh-perlica-ding 是一个 DeepSeek Harness 插件，用于在关键节点播放不同提示音：计划出方案、任务完成、需要你回应、出错时会响，普通问答保持安静。内置佩丽卡风格提示音，安装后无需任何配置，也可以替换自己的 WAV 音效。
插件定位¶
dsh-perlica-ding 解决的是 DSH 任务执行过程中的状态提醒问题：哪些节点该发声，哪些节点保持安静。
给定资料中的仓库地址为：
https://github.com/117BS/dsh-perlica-ding
给定资料中许可证为 MIT，README 与 package.json 均标明；package.json 中的版本号为 0.1.0。
核心能力¶
dsh-perlica-ding 提供的能力集中在任务状态提示上：
- 计划出方案、任务完成、需要你回应、出错时播放不同提示音，普通问答保持安静。
- 内置佩丽卡风格提示音，
sounds/目录随包分发，安装后无需任何配置。 - 窗口在后台也能听到提示音。
- 只响主对话：子代理/后台任务完成时不单独响，随主回合统一收尾。
- 每档音效有独立 2.5 秒防抖间隔，避免连响。
- 跨平台支持：Windows (SoundPlayer) / macOS (afplay) / Linux (paplay/aplay)。
- 可配置总开关、防抖间隔、音效目录和执行类工具列表（
execTools）。
安装与启用¶
从 GitHub 安装¶
从 GitHub 安装：
dsh plugin --profile web add https://github.com/117BS/dsh-perlica-ding
安装后需要重启 dsh web profile 才生效：
dsh web restart
从 npm 安装¶
资料给出的 npm 安装方式如下：
dsh plugin --profile web add dsh-perlica-ding
资料称 npm 发布后可用；给定资料未确认当前 npm 包是否已发布。
本地开发安装¶
本地开发安装示例如下：
dsh plugin --profile web add D:\deepseek\dsh-perlica-ding
配置¶
在 profile 的 cordis.yml 或用户 patch 层中设置 plugins.dsh-perlica-ding：
plugins:
dsh-perlica-ding:
enabled: true
debounceMs: 2500
soundDir: ""
execTools: []
各配置项作用如下：
enabled：总开关。debounceMs：同档音效最小间隔，单位毫秒。soundDir：自定义音效目录；留空则用当前工作区。execTools：指定哪些工具算“执行任务”；空数组表示所有工具都算。
自定义音效¶
内置音效位于 sounds/ 目录，随包分发，安装后可直接使用。
如果想换成自己的声音，将真正的 WAV（PCM）同名文件放到工作区根目录或配置的 soundDir，同名文件会覆盖内置声音，立即生效无需重启。
给定资料中的查找顺序为：配置目录 → 工作区 → 包内自带 → 系统回退。
自定义音效要求为真正的 WAV 格式（PCM）。如果 TTS 工具导出 MP3，需要先用 ffmpeg 转码为 PCM WAV。
手动测试声音链路可以使用给定资料中的命令：
$p = New-Object Media.SoundPlayer 'D:\deepseek\done.wav'; $p.PlaySync()
适用场景与注意¶
适合以下使用方式：
- 使用 DSH 跑多轮任务，希望计划、完成、审批、报错等节点有声音提醒。
- 希望普通问答保持安静，不被每次对话打扰。
- 希望子代理/后台任务不单独发声，只随主回合统一收尾。
- 希望在后台窗口也能听到关键状态变化。
注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 安装后需要重启
dsh web profile才生效。 - 自定义音效必须是 WAV（PCM），MP3 需先转码。
package.json声明可选peerDependencies：@deepseek-ai/cordis、@deepseek-ai/schemastery。
链接¶
插件线索给出的目录页 URL 为：
https://www.skillhub.cn/plugins/117BS/dsh-perlica-ding
仓库地址为：
https://github.com/117BS/dsh-perlica-ding
