neil-ji/dsh-session-chime ↗★ 0

@local/session-chime

Plays a desktop sound when a session finishes its work, and a different ping when it is waiting for your answer or approval. 适合在后台运行任务、需要声音提醒进度的 DSH 用户。

Package
@local/session-chime
Compatibility
Unverified
Version
1.0.0
License
MIT
Last updated
Oct 26, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:neil-ji/dsh-session-chime

配置

在 cordis.patch.yml 的 session-chime 行里改,改完重启 Harness 生效:

- insert:
    - id: session-chime
      name: '@local/session-chime'
      config:
        enabled: true
        mode: chime
        volume: 0.8
        cooldownMs: 2500
        settleMs: 1200
        minRunMs: 500
        notifyWaiting: true
        waitingDelayMs: 400
        waitingDedupeMs: 3000
        includeSubagents: false
字段默认含义
enabledtrue总开关;false 时两种声音都不响
modechimechime 播放合成的声音;speak 用系统语音播报
volume0.8音量,0.05 ~ 1(对 wavPath 指定的文件无效)
speakText任务完成mode: speak 时"完成"念的文本
waitingSpeakText需要你确认mode: speak 时"等你确认"念的文本
wavPath空改成播放你自己的 .wav;留空使用内置声音(两种声音会用同一个文件)
cooldownMs2500两次"完成"提示之间的最小间隔,0 表示不限制
settleMs1200回到 idle 后等待多久确认真的结束
minRunMs500短于这个时长的运行不提示(过滤一闪而过的状态变化)
notifyWaitingtrue是否在"等你回答 / 等你批准"时响
waitingDelayMs400请求出现后等多久才响(过滤立即被解决的请求)
waitingDedupeMs3000同一段时间内重复的等待请求只响一次
includeSubagentsfalse是否也为子代理(subagent / workflow 子会话)的完成而响;子代理本来就不能开人工交互,所以不会有"等待"提示
logFile空填一个路径可记录每次响/跳过的原因,排查用(超过 256 KB 自动清空)