@local/session-chime
会话完成工作时播放桌面提示音，等待您的回答或批准时播放另一种提示音。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:neil-ji/dsh-session-chime#b7b32c5935cf6e1c5f6bd431cbd965cc729923b1Session Chime 以 @local/session-chime 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
@local/session-chime)给这台桌面加两种声音，让你可以离开屏幕去玩游戏或忙别的：
| 时机 | 声音 | 含义 |
|---|---|---|
会话把一段活儿干完（running → idle） | 1 秒的双音铃声 | "干完了，来下一条指令" |
| 会话停下来等你回答 / 等你批准时 | 两声短促高音（约 0.5 秒） | "我在等你，回来确认一下" |
两种声音明显不同，闭着眼也能听出是"完成"还是"要你确认"。
git clone https://github.com/neil-ji/dsh-session-chime.git
然后在 Harness 里把这个目录作为本地 bundle 装进你的 profile（Plugin Manager 的本地安装，或者让 Agent 用 install_bundle 指向该目录的绝对路径）。装好后输入 /chime test 应听到一声完成铃声，/chime test waiting 是"等你确认"的两声短音。
System.Media.SoundPlayer 播放），DSH 0.2.x。node test/selftest.mjs（用静音 WAV 跑完整链路，不会打扰你）。在网页里放一个 <audio>，人一走开就不可靠：标签页被切到后台会被节流、浏览器还有自动播放限制，页面关掉更是什么都没有。所以这个插件放在 Host 进程里：它监听 Agent 状态与 Session 事件，直接从操作系统音频设备出声，网页在后台、窗口最小化、甚至浏览器页面关掉都不受影响。
依据 agent/status 的 running → idle。Agent 在干活期间一直是 running，把这一批输入全部处理完才回到 idle，所以这是"一段工作结束"，而不是"一次模型调用结束"。两道保护：
只依赖 Session 里已经落盘的事实，因此与哪个应答器抢到请求无关：
tool/call 里出现 ask_user_question / exit_plan_mode，且对应的 tool/result 还没出现 —— Agent 正卡在"等人回答"上（计划评审也是这个通道）。approval/asked / approval/decided 审计事件 —— 工具要人批准（只有 approval 策略是 ask 的会话才会出现；本机默认 danger-full-access 是 never，所以一般不会响）。user-questions/request 与 approval/request 两个 waterfall 事件作为第二条通道，只观察、不抢答。waitingDelayMs（默认 400ms）用于过滤"立刻就被解决"的请求：自动批准的、马上被取消的提问，不会响。
在 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
| 字段 | 默认 | 含义 |
|---|---|---|
enabled | true | 总开关；false 时两种声音都不响 |
mode | chime | chime 播放合成的声音；speak 用系统语音播报 |
volume | 0.8 | 音量，0.05 ~ 1（对 wavPath 指定的文件无效） |
speakText | 任务完成 | mode: speak 时"完成"念的文本 |
waitingSpeakText | 需要你确认 | mode: speak 时"等你确认"念的文本 |
wavPath | 空 | 改成播放你自己的 .wav；留空使用内置声音（两种声音会用同一个文件） |
cooldownMs | 2500 | 两次"完成"提示之间的最小间隔，0 表示不限制 |
settleMs | 1200 | 回到 idle 后等待多久确认真的结束 |
minRunMs | 500 | 短于这个时长的运行不提示（过滤一闪而过的状态变化） |
notifyWaiting | true | 是否在"等你回答 / 等你批准"时响 |
waitingDelayMs | 400 | 请求出现后等多久才响（过滤立即被解决的请求） |
waitingDedupeMs | 3000 | 同一段时间内重复的等待请求只响一次 |
includeSubagents | false | 是否也为子代理（subagent / workflow 子会话）的完成而响；子代理本来就不能开人工交互，所以不会有"等待"提示 |
logFile | 空 | 填一个路径可记录每次响/跳过的原因，排查用（超过 256 KB 自动清空） |
在输入框里直接输入，不用发消息给模型：
| 命令 | 作用 |
|---|---|
/chime 或 /chime status | 看当前设置和上一次响的时间 |
/chime on / /chime off | 临时开关（只影响当前 Host 进程，重启后回到配置值） |
/chime test | 立刻响一次"完成"声 |
/chime test waiting | 立刻响一次"等你确认"声 |
/chime volume 0.4 | 临时改音量 |
/chime mode chime / /chime mode speak | 切换声音 / 语音播报 |
/chime waiting on / /chime waiting off | 要不要"等你确认"的提示 |
/chime subagents on / /chime subagents off | 是否包含子代理 |
index.js：Host 插件本体。监听 agent/status（并旁听 api-session/status）、session/event、user-questions/request、approval/request；用 ctx.get('sessions').get(id).header.origin 判断子代理；用 ctx.get('commands').register() 注册 /chime。audio.js：合成两种声音（44.1 kHz / 16-bit / 单声道 WAV，写到系统临时目录并按音量缓存）并驱动一个常驻的 powershell.exe 助手进程。助手只在第一次出声时启动，之后每声只写一行 ASCII 命令（路径和中文文本以 base64 传递，避免 5.1 的管道编码问题），助手退出后自动重建；插件卸载时关闭它的 stdin。不依赖任何 npm 包，也不使用 ctx.subprocess 之类的工具沙箱服务：它需要的是这台机器的音频设备，而不是一个被沙箱约束的子进程。
MIT © 2026 Neil Ji