Ruiming-cn/dsh-turn-notify1

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.

包名
dsh-turn-notify
版本
1.0.0
许可证
MIT
最近更新
2026年8月25日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Ruiming-cn/dsh-turn-notify

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(英文)
cooldownMs10000普通完成通知冷却(毫秒/会话)
mergeWindowMs1500关键事件防风暴合并窗口(毫秒,同会话同类)
maxSessions128会话状态容量上限(超限淘汰最旧)
previewChars15问/答预览截断字数
titlePrefix'DSH'通知标题前缀
showSessionTagtrue是否显示会话编号行
soundtrue是否播放提示音
timeoutMs10000通知子进程超时
dryRunfalse只记录日志不真正发送(测试用)
rootSessionsOnlytrue只通知根会话(子代理静默)