配置

配置项	默认值	说明
`sound`	`true`	播放提示音
`soundFile`	空	提示音文件路径（mp3/wav/mid/wma/aac）。留空时自动在服务器工作目录 / 插件目录（自带 ding.mp3）/ 用户主目录找 `ding.mp3`，找不到则回退系统"叮咚"双音
`volume`	`1.0`	提示音音量（0.0 ~ 1.0，1.0 为原始音量，如 `0.5` 即一半音量）
`balloon`	`true`	显示 Windows 通知
`title`	`DSH 完成`	通知标题
`debounceMs`	`200`	状态防抖毫秒数
`minIntervalMs`	`3000`	两次通知的最小间隔
`notifySubagents`	`false`	是否也通知子代理完成
`quietOnViewing`	`true`	当前会话免打扰：窗口在前台（可见且有焦点）且完成的会话正是正在查看的会话时静默；切走窗口 / 看别的会话 / 没开对话页时照常提醒
`runningNotify`	`true`	长任务运行中提醒：只弹 Windows 通知、不响铃
`runningFirstAfterMs`	`180000`	运行中提醒首次延迟毫秒数（默认 3 分钟）
`runningIntervalMs`	`300000`	运行中提醒后续间隔毫秒数（默认 5 分钟）
`runningTitle`	`DSH 运行中`	运行中提醒的通知标题（v1.0.0 更新新增）
`questionNotify`	`true`	用户提问提醒：Agent 通过 `ask_user_question` 提问等待回答时立即提醒（文本区别于完成通知）
`questionTitle`	`DSH 提问`	提问提醒的通知标题
`doneTemplate`	空	自定义完成通知文本（支持 `{title}`/`{prefix}`/`{elapsed}`，留空用默认）
`runningTemplate`	空	自定义运行中提醒文本（支持 `{title}`/`{prefix}`/`{elapsed}`，留空用默认）
`questionTemplate`	空	自定义提问通知文本（支持 `{title}`/`{prefix}`/`{question}`，留空用默认）
`approvalNotify`	`true`	工具审批提醒：工具调用等待你批准时立即提醒
`approvalTitle`	`DSH 审批`	审批提醒的通知标题
`approvalTemplate`	空	自定义审批通知文本（支持 `{title}`/`{prefix}`/`{tool}`，留空用默认）
`notifierName`	空	通知应用显示名（Windows 通知设置里显示的名称）。留空时跟随 WebUI 语言自动切换：中文「DSH叮当通知」，英文「dsh-ding-notifier」；填写后固定使用该名称

完整示例：

- insert:
    - id: dsh-ding
      name: 'dsh-ding'
      config:
        sound: true
        soundFile: 'C:\codewhale\ding.mp3'
        volume: 0.8
        balloon: true
        title: 'DSH 完成'
        debounceMs: 200
        minIntervalMs: 3000
        quietOnViewing: true
        runningNotify: true
        runningFirstAfterMs: 180000
        runningIntervalMs: 300000

Configuration

Option	Default	Description
`sound`	`true`	Play the alert sound
`soundFile`	empty	Path to the sound file (mp3/wav/mid/wma/aac). When empty, the script looks for `ding.mp3` in the server working directory / plugin directory (bundled ding.mp3) / user home; falls back to the system beep if not found
`volume`	`1.0`	Alert sound volume (0.0 ~ 1.0; `1.0` = original volume, e.g. `0.5` = half volume)
`balloon`	`true`	Show the Windows notification
`title`	`DSH Done`	Notification title
`debounceMs`	`200`	Status debounce in ms
`minIntervalMs`	`3000`	Minimum interval between two notifications
`notifySubagents`	`false`	Also notify when subagents finish
`quietOnViewing`	`true`	Quiet on current: silent while the window is focused AND the finishing session is the one you are viewing; still reminds when you switch away, view another session, or no conversation page is open
`runningNotify`	`true`	Long-task progress reminder: Windows toast only, no sound
`runningFirstAfterMs`	`180000`	First progress reminder delay in ms (default 3 min)
`runningIntervalMs`	`300000`	Progress reminder interval in ms (default 5 min)
`runningTitle`	`DSH Running`	Notification title for progress reminders (new in v1.0.0 update)
`questionNotify`	`true`	Question reminder: alerts immediately when the agent asks you something via `ask_user_question` and waits (text differs from completion)
`questionTitle`	`DSH Question`	Notification title for question reminders
`doneTemplate`	empty	Custom completion text (`{title}`/`{prefix}`/`{elapsed}`; empty = default)
`runningTemplate`	empty	Custom progress-reminder text (`{title}`/`{prefix}`/`{elapsed}`; empty = default)
`questionTemplate`	empty	Custom question text (`{title}`/`{prefix}`/`{question}`; empty = default)
`approvalNotify`	`true`	Tool approval reminder: alert when a tool call waits for your approval
`approvalTitle`	`DSH Approval`	Notification title for approval reminders
`approvalTemplate`	empty	Custom approval text (`{title}`/`{prefix}`/`{tool}`; empty = default)
`notifierName`	empty	Notification app display name (shown in Windows notification settings). Leave empty to follow the WebUI language: Chinese "DSH叮当通知", English "dsh-ding-notifier"; enter a name to pin it

Full example:

- insert:
    - id: dsh-ding
      name: 'dsh-ding'
      config:
        sound: true
        soundFile: 'C:\codewhale\ding.mp3'
        volume: 0.8
        balloon: true
        title: 'DSH 完成'
        debounceMs: 200
        minIntervalMs: 3000
        quietOnViewing: true
        runningNotify: true
        runningFirstAfterMs: 180000
        runningIntervalMs: 300000

dsh-ding

インストール

ドキュメント

配置

Configuration