dsh-notify-chime 1.4.0 → 1.7.0

package/README.md

@@ -7,7 +7,13 @@
 | 回合正常结束 | `finished` | 上行三音 |
 | 中断（停止、归档、取消） | `interrupted` | 下行两音 |
 | 出错结束 | `error` | 低频双响 |
-| Agent 提问（等回答 / 等批计划） | `question` | 三声高音 |
+| Agent 提问（等回答） | `question` | 三声高音 |
+| 等待审批（`approval/asked`） | `approval` | 上行双音，稍急 |
+| 计划评审（`exit_plan_mode`） | `plan-review` | 三音上行 |
+| 目标受阻（`goal/change` → `phase: blocked`） | `goal-blocked` | 低频下行 |
+| 后台任务失败（`job/settled` → `failed`） | `job-failed` | 短促双音 |
+
+计划评审以前混在「提问」里，1.5.0 起单独分类。目标受阻只在「非 blocked → blocked」那一次跃迁发声；后台任务失败按会话 3 秒窗口去抖，多个任务同时失败只响一次。
 
 应用退出、会话分叉、被阻断，以及默认被过滤的 subagent 会话不发声。
 
@@ -25,7 +31,7 @@ dsh plugin add dsh-notify-chime
 
 | 组 | 内容 |
 | --- | --- |
-| 声音 | 总开关、音色、四类事件各自开关与试听、最小间隔、子会话提醒 |
+| 声音 | 总开关、音色、八类事件各自开关与试听、正在看的会话完成时不响、同类事件最小间隔、子会话提醒 |
 | 通知 | 通知总开关、哪些事件弹、标题前缀、正文是否带会话名 |
 | 高级 | 设置文件 / 音效 / 自定义 / 轨迹目录（只读）、恢复默认 |
 
@@ -54,7 +60,7 @@ dsh plugin add dsh-notify-chime
 
 音色为「自定义」的行会出现「上传」按钮：
 
-- 只收 WAV（`System.Media.SoundPlayer` 的限制），单文件 ≤ 5 MB
+- 支持 **WAV / MP3 / M4A / AAC**，单文件 ≤ 5 MB；WAV 走 `SoundPlayer`，其它走 WPF `MediaPlayer`（借系统解码器）
 - 存 `~/.dsh/dsh-notify-chime-sounds/<kind>.wav`，卸载插件不丢
 - 上传后该行切到「自定义」，其它事件的音色不变；没传的类仍用内置音效
 - 上传即生效，可直接点「试听」确认
@@ -70,7 +76,15 @@ dsh plugin add dsh-notify-chime
     soundset: default
     minIntervalMs: 700
     includeSubagents: false
-    kinds: { finished: true, interrupted: true, error: true, question: true }
+    kinds:
+      finished: true
+      interrupted: true
+      error: true
+      question: true
+      approval: true
+      plan-review: true
+      goal-blocked: true
+      job-failed: true
     toast: { enabled: true, kinds: [question], includeSession: true }
 ```
 
@@ -80,10 +94,11 @@ dsh plugin add dsh-notify-chime
 | `soundset` | `default` | 全局音色：`default` / `soft` / `chime` / `retro` / `digital` / `wood` / `custom` |
 | `minIntervalMs` | `700` | 同类事件最小间隔，防连响 |
 | `includeSubagents` | `false` | 是否也为子会话发声 |
+| `quietCurrent` | `false` | 正在查看的那个会话完成时不发声（只影响完成，审批/提问/出错照响） |
 | `kinds.<kind>` | `true` | 该类事件是否发声 |
 | `sounds.<kind>` | 内置 wav | 单类音效路径；`false` 或 `null` 表示不响 |
-| `player` | `auto` | `auto` / `powershell` / `pwsh` / `none` / 播放器路径 |
-| `questionTools` | `["ask_user_question", "exit_plan_mode"]` | 视为提问的工具名 |
+| `player` | `auto` | `auto` / `powershell` / `pwsh` / `wpf` / `none` / 播放器路径。`auto` 时 wav 用 `SoundPlayer`、其它格式用 WPF `MediaPlayer` |
+| `questionTools` | `["ask_user_question"]` | 只决定谁触发 `question` 音。`exit_plan_mode` 固定归 `plan-review`，想静音它请关 `kinds.plan-review` |
 | `toast.enabled` | `false` | 是否弹系统通知（本包初值为 `true`） |
 | `toast.kinds` | `null` | 只对哪些 kind 弹，`null` 为全部 |
 | `toast.title` | `DeepSeek Harness` | 通知标题前缀，最长 60 字符 |
@@ -140,7 +155,7 @@ node tools/smoke-test.mjs --verbose
 - 监听会话日志的追加流，冷启动打开历史会话不补响。
 - 每次提醒 spawn 独立子进程播放，不阻塞 Host。PowerShell 冷启动约 200 ms，延迟约 0.3 s。
 - 无音量调节，跟随系统默认播放设备；默认设备是虚拟声卡时人耳可能听不到。
-- 自定义音效只支持 WAV，不支持 mp3 / flac。
+- 自定义音效支持 WAV / MP3 / M4A / AAC；WMA、FLAC 不支持（系统虽有解码器，但没有接）。
 - 目录：`lib/`（宿主）、`client.js`（设置页）、`assets/`（音效）、`tools/`（脚本）。
 
 ## 音效来源

package/client.js

@@ -32,6 +32,10 @@ window.__ModuleLoader__.load({
       { key: 'interrupted', label: '工作中断', sound: null, soundExists: true },
       { key: 'error', label: '工作出错', sound: null, soundExists: true },
       { key: 'question', label: 'Agent 提问', sound: null, soundExists: true },
+      { key: 'approval', label: '等待审批', sound: null, soundExists: true },
+      { key: 'plan-review', label: '计划评审', sound: null, soundExists: true },
+      { key: 'goal-blocked', label: '目标受阻', sound: null, soundExists: true },
+      { key: 'job-failed', label: '后台任务失败', sound: null, soundExists: true },
     ]
 
     /** 宿主没返回音色套清单时的兜底。 */
@@ -48,6 +52,7 @@ window.__ModuleLoader__.load({
     const EMPTY_SETTINGS = {
       enabled: true,
       soundset: 'default',
+      quietCurrent: false,
       perKindSoundset: {},
       customSounds: {},
       kinds: { finished: true, interrupted: true, error: true, question: true },
@@ -73,10 +78,27 @@ window.__ModuleLoader__.load({
     }
     const listeners = new Set()
     const emit = () => { for (const fn of listeners) fn(state) }
+    /** apply 时保存的客户端上下文，供 refresh 读取「当前会话」。 */
+    let pluginCtx = null
+
+    /** 读客户端当前打开的会话 id；拿不到就返回 null（该功能温和失效，不影响其它能力）。 */
+    function currentSessionId () {
+      try {
+        const sessions = pluginCtx && typeof pluginCtx.get === 'function' ? pluginCtx.get('sessions') : undefined
+        const list = sessions && sessions.list
+        const snap = list && typeof list.getSnapshot === 'function' ? list.getSnapshot() : undefined
+        const id = snap ? snap.current : undefined
+        return typeof id === 'string' && id.length > 0 ? id : null
+      } catch {
+        return null
+      }
+    }
 
     async function refresh () {
       try {
-        const r = await fetch(API + '/state', { headers: { accept: 'application/json' } })
+        const current = currentSessionId()
+        const url = API + '/state' + (current ? '?current=' + encodeURIComponent(current) : '')
+        const r = await fetch(url, { headers: { accept: 'application/json' } })
         if (!r.ok) throw new Error('HTTP ' + r.status)
         const j = await r.json()
         state = { ...state, loading: false, error: null, ...j }
@@ -152,8 +174,9 @@ window.__ModuleLoader__.load({
       sectionHint: { fontSize: '12px', color: C.dim, flex: 1, minWidth: 0 },
       chevron: { fontSize: '11px', color: C.dim, marginLeft: 'auto', flex: 'none' },
       sectionBody: { padding: '12px 14px', display: 'grid', gap: '12px' },
-      row: { display: 'flex', alignItems: 'flex-start', gap: '12px' },
-      rowText: { display: 'grid', gap: '2px', flex: 1, minWidth: 0 },
+      // 行布局自适应：空间不够时控件整体换到下一行，而不是把标题挤成一字一列
+      row: { display: 'flex', alignItems: 'flex-start', gap: '12px', flexWrap: 'wrap' },
+      rowText: { display: 'grid', gap: '2px', flex: '1 1 200px', minWidth: '180px' },
       rowTitle: { fontSize: '13px', fontWeight: 550 },
       rowDesc: { fontSize: '12px', color: C.dim, lineHeight: 1.5 },
       toggle: (on) => ({
@@ -165,13 +188,13 @@ window.__ModuleLoader__.load({
         position: 'absolute', top: '2px', left: on ? '18px' : '2px', width: '16px', height: '16px',
         borderRadius: '50%', background: '#fff', transition: 'left 160ms ease',
       }),
-      inline: { display: 'flex', alignItems: 'center', gap: '8px', flex: 'none' },
+      inline: { display: 'flex', alignItems: 'center', gap: '8px', flex: '0 1 auto', flexWrap: 'wrap', justifyContent: 'flex-end' },
       input: {
         width: '110px', padding: '5px 8px', fontSize: '13px', textAlign: 'right',
         border: '1px solid ' + C.border, borderRadius: C.radiusSm, background: 'transparent', color: C.text,
       },
       inputWide: {
-        flex: 1, minWidth: 0, padding: '5px 8px', fontSize: '13px',
+        flex: '1 1 160px', minWidth: '160px', padding: '5px 8px', fontSize: '13px',
         border: '1px solid ' + C.border, borderRadius: C.radiusSm, background: 'transparent', color: C.text,
       },
       btn: (disabled) => ({
@@ -179,7 +202,9 @@ window.__ModuleLoader__.load({
         border: '1px solid ' + C.border, background: 'transparent', color: C.text,
         cursor: disabled ? 'default' : 'pointer', opacity: disabled ? 0.5 : 1, flex: 'none',
       }),
-      chips: { display: 'flex', gap: '6px', flexWrap: 'wrap', flex: 'none' },
+      chips: { display: 'flex', gap: '6px', flexWrap: 'wrap', minWidth: 0 },
+      /** 行内 chips：允许收缩换行，右对齐 */
+      chipsRow: { display: 'flex', gap: '6px', flexWrap: 'wrap', flex: '0 1 auto', minWidth: 0, maxWidth: '100%', justifyContent: 'flex-end' },
       fileBtn: {
         padding: '5px 10px', fontSize: '12px', borderRadius: C.radiusSm, border: '1px dashed ' + C.border,
         color: C.dim, cursor: 'pointer', flex: 'none', whiteSpace: 'nowrap',
@@ -414,7 +439,7 @@ window.__ModuleLoader__.load({
                 uploading === meta.key ? '上传中' : (customSounds[meta.key] ? '重新上传' : '上传'),
                 h('input', {
                   type: 'file',
-                  accept: '.wav,audio/wav',
+                  accept: '.wav,.mp3,.m4a,.aac',
                   style: S.fileInput,
                   onChange: (e) => upload(e, meta),
                 }))
@@ -430,7 +455,7 @@ window.__ModuleLoader__.load({
       ))
 
       /** 音色套选择：选中即写设置，试听按钮随即用新音色。 */
-      const soundsetChips = h('div', { style: S.chips }, soundsets.map((set) => {
+      const soundsetChips = h('div', { style: S.chipsRow }, soundsets.map((set) => {
         const on = soundset === set.key
         return h('button', {
           type: 'button',
@@ -441,7 +466,7 @@ window.__ModuleLoader__.load({
         }, set.label)
       }))
 
-      const toastChips = h('div', { style: S.chips }, kindMeta.map((meta) => {
+      const toastChips = h('div', { style: S.chipsRow }, kindMeta.map((meta) => {
         const on = toastKinds.includes(meta.key)
         return h('button', {
           type: 'button',
@@ -510,6 +535,16 @@ window.__ModuleLoader__.load({
               }, '保存'),
             ),
           }),
+          rowNode({
+            key: 'quietCurrent',
+            title: '正在看的会话完成时不响',
+            desc: '只对「工作完成」生效；审批、提问、出错照常响。默认关闭。',
+            control: toggleNode({
+              on: settings.quietCurrent === true,
+              label: '正在看的会话完成时不响',
+              onChange: (v) => commit({ quietCurrent: v }, v ? '正在看的会话完成时不再响' : '完成时照常响'),
+            }),
+          }),
           rowNode({
             key: 'subagents',
             title: '子会话也提醒',
@@ -642,6 +677,7 @@ window.__ModuleLoader__.load({
     const inject = ['slots']
 
     function apply (ctx) {
+      pluginCtx = ctx
       ctx.effect(() => {
         refresh()
         const timer = setInterval(() => { if (!document.hidden) refresh() }, POLL_MS)

package/lib/host.js

@@ -22,14 +22,14 @@
  */
 
 import { spawn } from 'node:child_process'
-import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { appendFileSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
-import { dirname, isAbsolute, join, resolve } from 'node:path'
+import { dirname, extname, isAbsolute, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 /** 设置页写入的用户设置文件名（放在 DSH 主目录）。 */
 const SETTINGS_FILENAME = 'dsh-notify-chime.json'
-const VERSION = '1.4.0'
+const VERSION = '1.7.0'
 /** 去抖间隔上限：填成天文数字会让提示音事实上永久失效，这里兜住。 */
 const MAX_MIN_INTERVAL_MS = 600000
 /** 通知标题前缀的长度上限（再长会被系统截断，也挤掉事件名）。 */
@@ -50,6 +50,10 @@ const SOUNDSETS = [
 const SOUNDSET_KEYS = SOUNDSETS.map((set) => set.key)
 /** 自定义音效上传上限：5 MB，足够十几秒无损音频。 */
 const MAX_UPLOAD_BYTES = 5 * 1024 * 1024
+/** 后台任务失败按会话去抖：一轮里多个任务同时失败只响一次。 */
+const JOB_FAIL_WINDOW_MS = 3000
+/** 客户端上报「当前正在查看的会话」后，多久内有效；过期视为没人在看。 */
+const QUIET_CURRENT_MAX_AGE_MS = 15000
 
 /** DSH 主目录：profile 启动时带 DSH_HOME，裸进程回落到 ~/.dsh。 */
 function dshHome () {
@@ -90,6 +94,10 @@ const KINDS = {
   interrupted: { asset: 'interrupted.wav', label: '工作中断', body: '本轮工作已被中断' },
   error: { asset: 'error.wav', label: '工作出错', body: '本轮工作因错误结束' },
   question: { asset: 'question.wav', label: 'Agent 提问', body: 'Agent 正在等待你的回答' },
+  approval: { asset: 'approval.wav', label: '等待审批', body: '有操作正在等你批准' },
+  'plan-review': { asset: 'plan-review.wav', label: '计划评审', body: 'Agent 提交了计划，等你评审' },
+  'goal-blocked': { asset: 'goal-blocked.wav', label: '目标受阻', body: '当前目标被阻塞，需要你介入' },
+  'job-failed': { asset: 'job-failed.wav', label: '后台任务失败', body: '一个后台任务执行失败' },
 }
 
 /** 默认配置（config 中未给出的字段取这里的值）。 */
@@ -99,14 +107,25 @@ const DEFAULTS = {
   minIntervalMs: 700,
   /** 是否也为 subagent / 子会话发声。 */
   includeSubagents: false,
-  /** 音色套：default | soft | chime | retro | digital | wood | custom。 */
+  /**
+   * 音色套：default | soft | chime | retro | digital | wood | custom。
+   */
   soundset: 'default',
+  /**
+   * 「当前正在查看的会话完成时不响」：默认关闭。
+   * 只影响 finished，审批 / 提问 / 出错等一律照响。
+   */
+  quietCurrent: false,
   /** 每类事件是否发声（设置页可逐类关掉，不必整类静音）。 */
   kinds: {
     finished: true,
     interrupted: true,
     error: true,
     question: true,
+    approval: true,
+    'plan-review': true,
+    'goal-blocked': true,
+    'job-failed': true,
   },
   /** 声音播放器：'auto' | 'powershell' | 'pwsh' | 'none'，或播放器可执行文件的绝对路径。 */
   player: 'auto',
@@ -130,8 +149,11 @@ const DEFAULTS = {
   },
   /** 每个事件种类的声音文件；null / false 表示该类事件不发声。 */
   sounds: Object.fromEntries(Object.entries(KINDS).map(([key, meta]) => [key, join(ASSET_DIR, meta.asset)])),
-  /** 被视为「提问」的工具名。 */
-  questionTools: ['ask_user_question', 'exit_plan_mode'],
+  /**
+   * 视为「提问」的工具名，只决定谁触发 question 音。
+   * exit_plan_mode 有专属的 plan-review 分类（1.5.0 起），不再受此表控制。
+   */
+  questionTools: ['ask_user_question'],
   /** 调试用：把每次触发追加写入该文件（每行一条 JSON）。默认关闭。 */
   traceFile: null,
 }
@@ -151,6 +173,7 @@ function settingsFromOptions(options) {
   return {
     enabled: options.enabled,
     soundset: options.soundset,
+    quietCurrent: Boolean(options.quietCurrent),
     perKindSoundset: { ...DEFAULT_PER_KIND_SOUNDSET },
     customSounds: { ...DEFAULT_CUSTOM_SOUNDS },
     kinds: { ...options.kinds },
@@ -174,6 +197,7 @@ function normalizeSettings(raw, fallback) {
   const out = {
     enabled: fallback.enabled,
     soundset: fallback.soundset,
+    quietCurrent: fallback.quietCurrent,
     perKindSoundset: { ...fallback.perKindSoundset },
     customSounds: { ...fallback.customSounds },
     kinds: { ...fallback.kinds },
@@ -193,6 +217,7 @@ function normalizeSettings(raw, fallback) {
     }
   }
   if (typeof raw.soundset === 'string' && SOUNDSET_KEYS.includes(raw.soundset)) out.soundset = raw.soundset
+  if (typeof raw.quietCurrent === 'boolean') out.quietCurrent = raw.quietCurrent
   if (raw.perKindSoundset !== null && typeof raw.perKindSoundset === 'object' && !Array.isArray(raw.perKindSoundset)) {
     for (const key of KIND_KEYS) {
       const value = raw.perKindSoundset[key]
@@ -232,13 +257,14 @@ function applySettingsPatch(current, patch, fallback) {
   }
   if (patch.reset === true) return normalizeSettings({}, fallback)
 
-  const known = new Set(['enabled', 'soundset', 'perKindSoundset', 'customSounds', 'kinds', 'minIntervalMs', 'includeSubagents', 'toast', 'reset'])
+  const known = new Set(['enabled', 'soundset', 'quietCurrent', 'perKindSoundset', 'customSounds', 'kinds', 'minIntervalMs', 'includeSubagents', 'toast', 'reset'])
   for (const key of Object.keys(patch)) {
     if (!known.has(key)) throw new Error(`未知设置项 "${key}"`)
   }
   const next = {
     enabled: current.enabled,
     soundset: current.soundset,
+    quietCurrent: current.quietCurrent,
     perKindSoundset: { ...current.perKindSoundset },
     customSounds: { ...current.customSounds },
     kinds: { ...current.kinds },
@@ -252,6 +278,10 @@ function applySettingsPatch(current, patch, fallback) {
     }
     next.soundset = patch.soundset
   }
+  if (patch.quietCurrent !== undefined) {
+    if (typeof patch.quietCurrent !== 'boolean') throw new TypeError('quietCurrent 必须是布尔值')
+    next.quietCurrent = patch.quietCurrent
+  }
   if (patch.perKindSoundset !== undefined) {
     if (patch.perKindSoundset === null || typeof patch.perKindSoundset !== 'object' || Array.isArray(patch.perKindSoundset)) {
       throw new TypeError('perKindSoundset 必须是对象')
@@ -399,6 +429,23 @@ function resolveSoundFile(value) {
   return isAbsolute(text) ? text : resolve(HERE, '..', text)
 }
 
+/**
+ * 按文件头判断音频格式；不认识返回 null。
+ * 只认四种：WAV（RIFF/WAVE）、MP3（ID3 或 MPEG 帧同步）、M4A（ftyp）、AAC（ADTS 帧同步）。
+ */
+function detectAudioFormat(buffer) {
+  if (buffer.length < 12) return null
+  const at = (start, end) => buffer.toString('ascii', start, end)
+  if (at(0, 4) === 'RIFF' && at(8, 12) === 'WAVE') return 'wav'
+  if (at(0, 3) === 'ID3') return 'mp3'
+  if (at(4, 8) === 'ftyp') return 'm4a'
+  if (buffer[0] === 0xFF && (buffer[1] & 0xE0) === 0xE0) {
+    // MPEG 音频帧：layer 位（byte1 的 2–1 位）为 0 是 ADTS/AAC，否则是 MP3
+    return (buffer[1] & 0x06) === 0 ? 'aac' : 'mp3'
+  }
+  return null
+}
+
 /** PowerShell 单引号字符串转义。 */
 function quotePowerShell(text) {
   return `'${text.replace(/'/g, "''")}'`
@@ -417,14 +464,50 @@ function powerShellArgs(script) {
   return ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-EncodedCommand', encodePowerShellCommand(script)]
 }
 
-/** 解析本机可用的声音播放器；返回 { command, args(file) } 或 null。 */
-function resolvePlayer(preference) {
+/** WPF MediaPlayer 需要 STA 线程，单独一组参数。 */
+function powerShellArgsSta(script) {
+  return ['-NoProfile', '-NonInteractive', '-STA', '-ExecutionPolicy', 'Bypass', '-EncodedCommand', encodePowerShellCommand(script)]
+}
+
+/**
+ * MP3 / M4A 等非 WAV 格式的播放脚本：WPF MediaPlayer 走系统解码器。
+ * 播完才退出进程，避免提示音被截断；时长未知时最多等 5 秒，防止卡死。
+ */
+function mediaPlayerScript(file) {
+  return [
+    "$ErrorActionPreference='Stop'",
+    'Add-Type -AssemblyName PresentationCore',
+    '$player = New-Object System.Windows.Media.MediaPlayer',
+    `$player.Open([Uri]::new(${quotePowerShell(file)}))`,
+    'for ($i = 0; $i -lt 40 -and -not $player.NaturalDuration.HasTimeSpan; $i++) { Start-Sleep -Milliseconds 50 }',
+    '$duration = 0; if ($player.NaturalDuration.HasTimeSpan) { $duration = $player.NaturalDuration.TimeSpan.TotalSeconds }',
+    '$player.Play()',
+    '$limit = if ($duration -gt 0) { [math]::Min(600, [math]::Ceiling($duration * 10) + 20) } else { 50 }',
+    'for ($i = 0; $i -lt $limit; $i++) { Start-Sleep -Milliseconds 100; if ($duration -gt 0 -and $player.Position.TotalSeconds -ge $duration) { break } }',
+    '$player.Close()',
+  ].join(';')
+}
+
+/**
+ * 解析播放器；返回 { command, args(file) } 或 null。
+ *
+ * ext 决定 Windows 上走哪条路：WAV → SoundPlayer（延迟低），其它 → WPF MediaPlayer
+ * （借系统解码器播 mp3 / m4a，需要 STA）。
+ */
+function resolvePlayer(preference, ext) {
   if (preference === 'none') return null
   const platform = process.platform
+  const isWav = ext === '' || ext === '.wav'
   if (platform === 'win32') {
+    const wantsPowerShell = preference === 'auto' || preference === 'powershell' || preference === 'pwsh'
+    // 非 WAV 一律走 MediaPlayer：SoundPlayer 只认 WAV。
+    // MediaPlayer 需要 STA，只有 Windows PowerShell 有 -STA（pwsh 7 没有），所以这里固定用 powershell.exe。
+    if (preference === 'wpf' || (wantsPowerShell && !isWav)) {
+      return { command: 'powershell.exe', args: (file) => powerShellArgsSta(mediaPlayerScript(file)) }
+    }
     // auto / powershell / pwsh 走 PowerShell 脚本（-EncodedCommand 免引号转义）；
     // 其它值当播放器可执行文件，直接把文件路径作为唯一参数传过去。
-    if (preference === 'auto' || preference === 'powershell' || preference === 'pwsh') {
+    if (wantsPowerShell) {
       const command = preference === 'pwsh' ? 'pwsh.exe' : 'powershell.exe'
       return {
         command,
@@ -438,7 +521,7 @@ function resolvePlayer(preference) {
   if (platform === 'darwin') {
     return { command: preference === 'auto' ? 'afplay' : preference, args: (file) => [file] }
   }
-  // Linux: 依次尝试 paplay / aplay
+  // Linux: 依次尝试 paplay / aplay（两者都支持多种格式）
   const command = preference === 'auto' ? (existsSync('/usr/bin/paplay') ? 'paplay' : 'aplay') : preference
   return { command, args: (file) => [file] }
 }
@@ -483,10 +566,15 @@ export function apply(ctx, rawConfig) {
   const options = resolveOptions(rawConfig)
   const logger = ctx.logger('notify-sound')
 
-  const player = resolvePlayer(options.player)
-  if (player === null) logger.info('sound player disabled (player: none)')
+  if (options.player === 'none') logger.info('sound player disabled (player: none)')
   const questionTools = new Set(options.questionTools)
   const lastFired = new Map()
+  /** 目标阶段的上一状态：只有「非 blocked → blocked」才响一次。 */
+  const goalPhase = new Map()
+  /** 后台任务失败按会话去抖。 */
+  const lastJobFail = new Map()
+  /** 客户端上报的「当前正在查看的会话」：{ id, at }；过期视为没人在看。 */
+  let currentView = { id: null, at: 0 }
   const tracePath = options.traceFile === null ? null : resolveSoundFile(options.traceFile)
 
   // patch 值就是初始默认值；设置页写入的值覆盖它（存在 ~/.dsh/dsh-notify-chime.json）
@@ -500,27 +588,32 @@ export function apply(ctx, rawConfig) {
     return own || settings.soundset || 'default'
   }
 
-  /** 按当前音色套解析某类事件的音效文件；null 表示这类事件不发声。 */
+  /** 按当前音色套解析某类事件的音效文件；null 表示这类事件不发声。任何异常都退化为"不响"。 */
   const soundFileFor = (kind) => {
-    const configured = options.sounds[kind]
-    // patch 显式把该类设成 false / null：整类静音，任何音色套都不覆盖
-    if (configured === null || configured === false) return null
-    const set = effectiveSoundset(kind)
-    if (set === 'custom') {
-      const own = settings.customSounds ? settings.customSounds[kind] : null
-      if (typeof own === 'string' && own.length > 0) {
-        if (existsSync(own)) return own
-        logger.warn(`custom sound missing: ${own}`)
+    try {
+      const configured = options.sounds[kind]
+      // patch 显式把该类设成 false / null：整类静音，任何音色套都不覆盖
+      if (configured === null || configured === false) return null
+      const set = effectiveSoundset(kind)
+      if (set === 'custom') {
+        const own = settings.customSounds ? settings.customSounds[kind] : null
+        if (typeof own === 'string' && own.length > 0) {
+          if (existsSync(own)) return own
+          logger.warn(`custom sound missing: ${own}`)
+        }
+        // 这类没上传、或文件被移走：回退内置默认，不静音
+        return resolveSoundFile(configured)
+      }
+      if (set && set !== 'default') {
+        const preset = join(ASSET_DIR, set, `${kind}.wav`)
+        if (existsSync(preset)) return preset
+        logger.warn(`sound set "${set}" has no ${kind}.wav, falling back to default`)
       }
-      // 这类没上传、或文件被移走：回退内置默认，不静音
       return resolveSoundFile(configured)
+    } catch (error) {
+      logger.warn(`sound resolve failed (${kind}): ${error instanceof Error ? error.message : String(error)}`)
+      return null
     }
-    if (set && set !== 'default') {
-      const preset = join(ASSET_DIR, set, `${kind}.wav`)
-      if (existsSync(preset)) return preset
-      logger.warn(`sound set "${set}" has no ${kind}.wav, falling back to default`)
-    }
-    return resolveSoundFile(configured)
   }
 
   /** 追加一行触发记录（仅在配置了 traceFile 时）。 */
@@ -535,13 +628,16 @@ export function apply(ctx, rawConfig) {
 
   /** 播放一个音频文件（不阻塞宿主）；返回实际播放的路径或 null。 */
   const playFile = (file) => {
-    if (file === null || player === null) return null
-    if (!existsSync(file)) {
-      logger.warn(`sound file not found: ${file}`)
-      return null
-    }
+    if (file === null) return null
     try {
-      const child = spawn(player.command, player.args(file), { windowsHide: true, stdio: 'ignore' })
+      if (!existsSync(file)) {
+        logger.warn(`sound file not found: ${file}`)
+        return null
+      }
+      // 按扩展名选播放器：.wav 走 SoundPlayer，mp3 / m4a 走 WPF MediaPlayer
+      const chosen = resolvePlayer(options.player, extname(file).toLowerCase())
+      if (chosen === null) return null
+      const child = spawn(chosen.command, chosen.args(file), { windowsHide: true, stdio: 'ignore' })
       child.on('error', (error) => logger.warn(`sound player failed: ${error.message}`))
       child.unref()
       return file
@@ -563,6 +659,16 @@ export function apply(ctx, rawConfig) {
       trace({ time: new Date(now).toISOString(), kind, skipped: skipReason, ...detail })
       return
     }
+    // 「当前正在查看的会话完成时不响」：只对 finished 生效，且要求客户端刚上报过
+    const viewingThis = settings.quietCurrent
+      && kind === 'finished'
+      && currentView.id !== null
+      && currentView.id === detail?.sessionId
+      && now - currentView.at < QUIET_CURRENT_MAX_AGE_MS
+    if (viewingThis) {
+      trace({ time: new Date(now).toISOString(), kind, skipped: 'quiet-current', ...detail })
+      return
+    }
     const previous = lastFired.get(kind) ?? 0
     if (now - previous < settings.minIntervalMs) {
       trace({ time: new Date(now).toISOString(), kind, skipped: 'debounce', ...detail })
@@ -623,7 +729,13 @@ export function apply(ctx, rawConfig) {
     return undefined
   }
 
-  ctx.on('session/event', (session, event) => {
+  /**
+   * 处理一条会话事件。
+   *
+   * 这里所有字段访问都可能因 DSH 版本变化而抛错（getter、缺字段、结构变更），
+   * 所以调用方用 try/catch 收口——插件最坏表现是少响一次，绝不能把异常抛回宿主事件循环。
+   */
+  const handleSessionEvent = (session, event) => {
     if (!settings.includeSubagents && (session?.header?.origin === 'subagent' || session?.header?.parentSession !== undefined)) return
     if (event === null || typeof event !== 'object') return
 
@@ -634,13 +746,88 @@ export function apply(ctx, rawConfig) {
       return
     }
 
-    if (event.type === 'tool/call' && questionTools.has(event.data?.name)) {
-      fire('question', {
+    if (event.type === 'tool/call') {
+      const name = event.data?.name
+      if (typeof name !== 'string') return
+      // 计划评审是 exit_plan_mode 的专用语义，单独发声
+      if (name === 'exit_plan_mode') {
+        fire('plan-review', { sessionId: session?.id, title: sessionTitle(session), tool: name })
+        return
+      }
+      if (questionTools.has(name)) {
+        fire('question', {
+          sessionId: session?.id,
+          title: sessionTitle(session),
+          tool: name,
+          body: `Agent 正在等待你的回答（${name}）`,
+        })
+      }
+      return
+    }
+
+    // 审批请求：DSH 0.2.2 起是独立会话事件（见 known-event-types）
+    if (event.type === 'approval/asked') {
+      const data = event.data
+      if (data === null || typeof data !== 'object') return
+      const toolName = typeof data.toolName === 'string' ? data.toolName : ''
+      fire('approval', {
         sessionId: session?.id,
         title: sessionTitle(session),
-        tool: event.data.name,
-        body: `Agent 正在等待你的回答（${event.data.name}）`,
+        tool: toolName || undefined,
+        body: toolName ? `等待你批准：${toolName}` : undefined,
       })
+      return
+    }
+
+    // 目标受阻：只在「非 blocked → blocked」那一次跃迁发声
+    if (event.type === 'goal/change') {
+      const data = event.data
+      const goal = data !== null && typeof data === 'object' ? data.goal : undefined
+      const phase = goal !== null && typeof goal === 'object' && typeof goal.phase === 'string' ? goal.phase : undefined
+      const key = session?.id ?? '__none__'
+      if (phase === undefined) {
+        // clear 等没有 goal 的变更要清掉状态，否则同一会话之后新建目标再受阻会被误判成重复跃迁
+        if (data !== null && typeof data === 'object' && data.operation === 'clear') goalPhase.delete(key)
+        return
+      }
+      const previous = goalPhase.get(key)
+      goalPhase.set(key, phase)
+      if (phase === 'blocked' && previous !== 'blocked') {
+        fire('goal-blocked', {
+          sessionId: session?.id,
+          title: sessionTitle(session),
+          body: typeof goal.objective === 'string' && goal.objective ? `目标受阻：${goal.objective}` : undefined,
+        })
+      }
+      return
+    }
+
+    // 后台任务失败：正向断言只认 status === 'failed'，并按会话去重
+    if (event.type === 'job/settled') {
+      const data = event.data
+      if (data === null || typeof data !== 'object') return
+      if (data.status !== 'failed') return
+      const key = session?.id ?? '__none__'
+      const now = Date.now()
+      const previous = lastJobFail.get(key) ?? 0
+      if (now - previous < JOB_FAIL_WINDOW_MS) {
+        trace({ time: new Date(now).toISOString(), kind: 'job-failed', skipped: 'job-window', sessionId: session?.id })
+        return
+      }
+      lastJobFail.set(key, now)
+      fire('job-failed', {
+        sessionId: session?.id,
+        title: sessionTitle(session),
+        body: typeof data.detail === 'string' && data.detail ? `后台任务失败：${data.detail}` : undefined,
+      })
+    }
+  }
+
+  ctx.on('session/event', (session, event) => {
+    try {
+      handleSessionEvent(session, event)
+    } catch (error) {
+      logger.warn(`session/event handler failed: ${error instanceof Error ? error.message : String(error)}`)
     }
   })
 
@@ -688,6 +875,19 @@ export function apply(ctx, rawConfig) {
         res.end(JSON.stringify(payload))
       }
 
+      /** 路由兜底：未捕获异常转成 500 JSON，既不让请求挂起，也不冒泡到宿主。 */
+      const guard = (handler) => async (req, res) => {
+        try {
+          await handler(req, res)
+        } catch (error) {
+          logger.warn(`route failed: ${error instanceof Error ? error.message : String(error)}`)
+          try {
+            if (res.headersSent) res.end()
+            else json(res, 500, { ok: false, error: '插件内部错误' })
+          } catch { /* 连接已断，忽略 */ }
+        }
+      }
+
       /** 读 JSON 请求体；超过 16 KB 视为异常请求。出错时已自行响应，返回 null。 */
       const readJson = async (req, res) => {
         let body = ''
@@ -706,6 +906,13 @@ export function apply(ctx, rawConfig) {
         }
       }
 
+      /** 从 req.url 里取查询串；没有 url（mock / 非常规请求）时返回空表。 */
+      const queryOf = (url) => {
+        const text = typeof url === 'string' ? url : ''
+        const at = text.indexOf('?')
+        return new URLSearchParams(at < 0 ? '' : text.slice(at + 1))
+      }
+
       const routes = [
         {
           kind: 'exact',
@@ -716,6 +923,9 @@ export function apply(ctx, rawConfig) {
               return
             }
             if (req.method === 'HEAD') { res.writeHead(200); res.end(); return }
+            // 客户端每次轮询带上「当前正在查看的会话」，供 quietCurrent 判断
+            const current = queryOf(req.url).get('current')
+            if (current) currentView = { id: current, at: Date.now() }
             json(res, 200, statePayload())
           },
         },
@@ -763,7 +973,7 @@ export function apply(ctx, rawConfig) {
               json(res, 200, { ok: false, kind, error: '这类事件已配置为不发声（patch 的 sounds 设成 false / null）' })
               return
             }
-            if (player === null) {
+            if (options.player === 'none') {
               json(res, 200, { ok: false, kind, sound: file, error: '播放器被禁用（patch 的 player: none）' })
               return
             }
@@ -803,15 +1013,21 @@ export function apply(ctx, rawConfig) {
               chunks.push(chunk)
             }
             const buffer = Buffer.concat(chunks)
-            if (buffer.length < 44 || buffer.toString('ascii', 0, 4) !== 'RIFF' || buffer.toString('ascii', 8, 12) !== 'WAVE') {
-              json(res, 400, { ok: false, error: '只支持 WAV 文件（播放后端 System.Media.SoundPlayer 不支持其它格式）' })
+            const format = detectAudioFormat(buffer)
+            if (format === null) {
+              json(res, 400, { ok: false, error: '无法识别的音频格式，支持 WAV / MP3 / M4A / AAC' })
               return
             }
             const dir = soundsDir()
-            const file = join(dir, `${kind}.wav`)
+            const file = join(dir, `${kind}.${format}`)
             try {
               mkdirSync(dir, { recursive: true })
               writeFileSync(file, buffer)
+              // 换格式时清掉同类旧文件，避免同一声效留两份
+              for (const stale of ['wav', 'mp3', 'm4a', 'aac']) {
+                if (stale === format) continue
+                try { unlinkSync(join(dir, `${kind}.${stale}`)) } catch { /* 不存在就忽略 */ }
+              }
             } catch (error) {
               json(res, 500, { ok: false, error: `写入失败：${error instanceof Error ? error.message : String(error)}` })
               return
@@ -840,7 +1056,7 @@ export function apply(ctx, rawConfig) {
       ]
       const disposers = routes.map((route) => {
         try {
-          return wctx.webServer.register(route)
+          return wctx.webServer.register({ ...route, handler: guard(route.handler) })
         } catch (error) {
           // 单条路由注册失败不该连累事件监听与其它路由
           logger.warn(`route register failed: ${route.path}: ${error instanceof Error ? error.message : String(error)}`)

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-notify-chime",
-  "version": "1.4.0",
+  "version": "1.7.0",
   "type": "module",
-  "description": "回合完成、中断、出错或 Agent 提问时发声，可另弹系统通知；六套音色，支持自定义 WAV。",
+  "description": "回合完成、中断、出错、审批或提问时发声，可另弹系统通知；六套音色，自定义音效支持 WAV / MP3 / M4A。",
   "main": "lib/host.js",
   "exports": {
     ".": "./lib/host.js",

package/tools/make_sounds.py

@@ -115,6 +115,14 @@ SETS = {
                           length=0.78, gain=0.40, decay=6.5),
             "question": dict(notes=[(93, 0.00, 0.20, 0.90), (93, 0.20, 0.20, 0.95), (100, 0.40, 0.42, 1.00)],
                              length=0.85, gain=0.34, decay=7.5),
+            "approval": dict(notes=[(81, 0.00, 0.20, 0.90), (88, 0.14, 0.50, 1.00)],
+                             length=0.75, gain=0.40, decay=6.0),
+            "plan-review": dict(notes=[(84, 0.00, 0.24, 0.90), (88, 0.14, 0.24, 0.95), (91, 0.28, 0.55, 1.00)],
+                                length=0.90, gain=0.38, decay=5.5),
+            "goal-blocked": dict(notes=[(48, 0.00, 0.30, 1.00), (43, 0.22, 0.55, 0.90)],
+                                 length=0.85, gain=0.42, decay=5.0),
+            "job-failed": dict(notes=[(72, 0.00, 0.14, 1.00), (71, 0.16, 0.30, 0.90)],
+                               length=0.50, gain=0.40, decay=8.0),
         },
     },
     # 柔和：低八度、慢起音、谐波少，适合安静环境
@@ -129,6 +137,14 @@ SETS = {
                           length=0.92, gain=0.30, decay=3.8),
             "question": dict(notes=[(81, 0.00, 0.24, 0.90), (81, 0.24, 0.24, 0.95), (88, 0.48, 0.50, 1.00)],
                              length=1.05, gain=0.30, decay=3.4),
+            "approval": dict(notes=[(69, 0.00, 0.30, 0.90), (76, 0.18, 0.60, 1.00)],
+                             length=0.95, gain=0.30, decay=3.2),
+            "plan-review": dict(notes=[(72, 0.00, 0.34, 0.90), (76, 0.18, 0.34, 0.95), (79, 0.36, 0.65, 1.00)],
+                                length=1.15, gain=0.30, decay=3.0),
+            "goal-blocked": dict(notes=[(40, 0.00, 0.36, 1.00), (35, 0.26, 0.60, 0.90)],
+                                 length=0.95, gain=0.30, decay=3.4),
+            "job-failed": dict(notes=[(64, 0.00, 0.20, 1.00), (63, 0.22, 0.40, 0.90)],
+                               length=0.65, gain=0.30, decay=4.0),
         },
     },
     # 钟声：长尾、泛音密集、金属感
@@ -143,6 +159,14 @@ SETS = {
                           length=1.20, gain=0.30, decay=2.4),
             "question": dict(notes=[(93, 0.00, 0.30, 0.90), (93, 0.25, 0.30, 0.95), (96, 0.50, 0.90, 1.00)],
                              length=1.35, gain=0.30, decay=2.0),
+            "approval": dict(notes=[(86, 0.00, 0.45, 0.90), (93, 0.16, 0.85, 1.00)],
+                             length=1.20, gain=0.30, decay=2.2),
+            "plan-review": dict(notes=[(84, 0.00, 0.50, 0.90), (88, 0.16, 0.50, 0.95), (91, 0.32, 0.90, 1.00)],
+                                length=1.40, gain=0.30, decay=2.0),
+            "goal-blocked": dict(notes=[(50, 0.00, 0.60, 1.00), (45, 0.30, 0.90, 0.90)],
+                                 length=1.30, gain=0.30, decay=2.4),
+            "job-failed": dict(notes=[(74, 0.00, 0.40, 1.00), (73, 0.24, 0.70, 0.90)],
+                               length=1.00, gain=0.30, decay=2.6),
         },
     },
     # 复古：方波（奇次谐波）、短促、8-bit 味
@@ -157,6 +181,14 @@ SETS = {
                           length=0.38, gain=0.34, decay=10.0),
             "question": dict(notes=[(88, 0.00, 0.10, 0.90), (88, 0.12, 0.10, 0.95), (91, 0.24, 0.18, 1.00)],
                              length=0.46, gain=0.34, decay=9.0),
+            "approval": dict(notes=[(79, 0.00, 0.10, 0.90), (84, 0.10, 0.20, 1.00)],
+                             length=0.35, gain=0.34, decay=9.0),
+            "plan-review": dict(notes=[(76, 0.00, 0.10, 0.90), (79, 0.09, 0.10, 0.95), (84, 0.18, 0.18, 1.00)],
+                                length=0.40, gain=0.34, decay=9.0),
+            "goal-blocked": dict(notes=[(48, 0.00, 0.12, 1.00), (43, 0.12, 0.20, 0.90)],
+                                 length=0.36, gain=0.34, decay=9.0),
+            "job-failed": dict(notes=[(72, 0.00, 0.09, 1.00), (71, 0.10, 0.16, 0.90)],
+                               length=0.30, gain=0.34, decay=10.0),
         },
     },
     # 电子：极硬起音、极短衰减，像设备提示音
@@ -171,6 +203,14 @@ SETS = {
                           length=0.30, gain=0.36, decay=16.0),
             "question": dict(notes=[(93, 0.00, 0.07, 0.90), (93, 0.10, 0.07, 0.95), (96, 0.20, 0.14, 1.00)],
                              length=0.38, gain=0.36, decay=14.0),
+            "approval": dict(notes=[(83, 0.00, 0.07, 0.90), (88, 0.08, 0.14, 1.00)],
+                             length=0.26, gain=0.36, decay=14.0),
+            "plan-review": dict(notes=[(81, 0.00, 0.07, 0.90), (85, 0.07, 0.07, 0.95), (88, 0.14, 0.14, 1.00)],
+                                length=0.32, gain=0.36, decay=14.0),
+            "goal-blocked": dict(notes=[(53, 0.00, 0.08, 1.00), (48, 0.09, 0.16, 0.90)],
+                                 length=0.30, gain=0.36, decay=14.0),
+            "job-failed": dict(notes=[(74, 0.00, 0.06, 1.00), (73, 0.07, 0.12, 0.90)],
+                               length=0.22, gain=0.36, decay=16.0),
         },
     },
     # 木质：低频、极快衰减，敲击感，不刺耳
@@ -185,6 +225,14 @@ SETS = {
                           length=0.34, gain=0.42, decay=22.0),
             "question": dict(notes=[(79, 0.00, 0.09, 0.90), (79, 0.11, 0.09, 0.95), (83, 0.22, 0.14, 1.00)],
                              length=0.42, gain=0.42, decay=20.0),
+            "approval": dict(notes=[(69, 0.00, 0.09, 0.90), (74, 0.08, 0.16, 1.00)],
+                             length=0.30, gain=0.42, decay=20.0),
+            "plan-review": dict(notes=[(67, 0.00, 0.09, 0.90), (71, 0.08, 0.09, 0.95), (74, 0.16, 0.14, 1.00)],
+                                length=0.35, gain=0.42, decay=20.0),
+            "goal-blocked": dict(notes=[(45, 0.00, 0.10, 1.00), (40, 0.10, 0.16, 0.90)],
+                                 length=0.30, gain=0.42, decay=20.0),
+            "job-failed": dict(notes=[(64, 0.00, 0.08, 1.00), (63, 0.09, 0.14, 0.90)],
+                               length=0.26, gain=0.42, decay=20.0),
         },
     },
 }