Ruiming-cn/dsh-turn-notify ↗★ 1
dsh-turn-notify
Windows toast + chime when the agent needs you: turn done, blocked, error, max-tokens, interrupted, approval, question, and plan review, with bilingual previews and a per-session anti-storm queue.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Ruiming-cn/dsh-turn-notify说明文档
阅读完整 README ↗3. 配置补丁
bundle 已声明插件条目;如需调整选项,在 ~/.dsh/profiles/web/cordis.patch.yml 的 insert 列表给同一条目附加 config(id 必须保持 turn-notify):
- id: turn-notify
config:
language: zh # zh | en(通知文案语言,默认 zh)
sound: true
notify:
completed: true
blocked: true
aborted: true
error: true
maxTokens: true
interrupted: true
goals: true
approvals: true
questions: true
planReview: true
agentError: true
cooldownMs: 10000
mergeWindowMs: 1500
previewChars: 15
titlePrefix: DSH
showSessionTag: true
timeoutMs: 10000
dryRun: false
默认值在插件代码内;以上配置项与旧版手动
name: "./turn-notify/index.mjs"等价,只是无需再写相对路径。
5. 首次使用:注册 AUMID 快捷方式(一次性)
Toast 要显示应用图标、且归属于「DSH 通知」而不是「PowerShell」,需要系统存在一个带 AUMID 的开始菜单快捷方式:
- 位置:开始菜单
%APPDATA%\Microsoft\Windows\Start Menu\Programs\DSH 通知.lnk - 目标:
...\turn-notify\dsh-notify.exe - AppUserModelID:
dsh-turn-notify - IconLocation:DSH 黑色鲸鱼图标
C:\Users\20668\.dsh\dsh-whale.ico,0
已注册后无需重复操作;重装/换机需重新注册。
配置项
| 配置 | 默认 | 说明 |
|---|---|---|
notify | 全开 | 各事件类型开关(completed/blocked/aborted/error/maxTokens/interrupted/goals/approvals/questions/planReview/agentError) |
language | 'zh' | 通知文案语言:zh(中文)或 en(英文) |
cooldownMs | 10000 | 普通完成通知冷却(毫秒/会话) |
mergeWindowMs | 1500 | 关键事件防风暴合并窗口(毫秒,同会话同类) |
maxSessions | 128 | 会话状态容量上限(超限淘汰最旧) |
previewChars | 15 | 问/答预览截断字数 |
titlePrefix | 'DSH' | 通知标题前缀 |
showSessionTag | true | 是否显示会话编号行 |
sound | true | 是否播放提示音 |
timeoutMs | 10000 | 通知子进程超时 |
dryRun | false | 只记录日志不真正发送(测试用) |
rootSessionsOnly | true | 只通知根会话(子代理静默) |