zen-gitsync 2.17.31 → 2.17.32

package/src/utils/desktopNotify.js

@@ -12,25 +12,34 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 //
-// 长任务结束后的"人不在终端前也能收到"的提醒:系统通知 + 提示音 + 终端标题。
+// 长任务结束后的"人不在终端前也能收到"的提醒:系统通知 + 置顶弹窗 + 提示音 + 终端标题。
 //
 // 为什么需要它:release 的"装全局"阶段实测能磨十几分钟(registry 元数据/对象就绪慢,
 // 见 scripts/release.js 顶部那一长串注释),用户不可能一直盯着终端。终端里再醒目的一行
 // "🎉 发布完成",对已经走去干别的事的人等于没打 —— 提醒必须走**终端之外**的信道。
 //
-// 三条信道各自独立、各自 best-effort,一条挂掉不影响另外两条:
-//   ① 系统通知(Windows toast / macOS osascript / Linux notify-send);
-//   ② 提示音(成功与失败**不同**的音 —— 人不在屏幕前时,响成什么样是唯一能分辨结果的信号);
-//   ③ 终端标题(任务栏上那行字变成结果,回头扫一眼就知道)。
+// ============================ 两个必须踩过的坑 ============================
 //
-// 硬约束(踩过的坑都在这三条里):
-//   - **绝不抛异常、绝不阻塞**:提醒是附加品,不许把一次成功的发布变成失败退出,
-//     也不许让父进程等着它。派生进程一律 unref(),`main()` 该返回就返回。
-//   - spawn 一个不存在的命令(比如 Linux 上没装 notify-send)是走 `'error'` 事件而不是
-//     抛异常 —— 不挂这个监听就是**未捕获异常**,会直接打挂发布流程。
-//   - 文案里带用户可控内容(版本号 / 报错原文 / 任务标题)时,**按目标信道各自转义**:
-//     toast 正文进的是 XML(要转义 `& < >`),PowerShell 走单引号字符串(内部单引号翻倍)。
-//     漏了这两处不会报错,只会"什么都没弹出来",排查起来毫无线索。
+// ① **`spawn` 之后 `unref()` 就走人,提醒根本发不出去。**
+//    第一版就是这么写的(当时想的是"别让提醒拖住发布"),结果是:cmd 里老老实实打出
+//    "已发送结束提醒",而系统通知中心里一条都没有 —— 2026-09-30 实测,发版 v2.17.30 /
+//    v2.17.31 两次都没有任何提醒落地(注册表里 AUMID 的 LastNotificationAddedTime 停在
+//    更早的一次手工测试上)。隔离实验(子进程睡 3s 再写 marker,父进程立刻退出):
+//    普通 spawn、`detached: true`、甚至让子进程用 Start-Process 甩孙进程 —— **三个 marker
+//    一个都没写出来**;父进程只要不 unref(让 node 等着),marker 立刻就有。
+//    结论:**发提醒必须等子进程**,调用方 `await`。发布本来就跑了十几分钟,多等一两秒
+//    换"提醒真的送出去"完全值得。
+//
+// ② **弹窗不能由 release 进程自己扛着。** 置顶弹窗是要停留几十秒给人看的,可子进程活不过
+//    父进程(见①),node 一退弹窗就没了。办法是让"启动器"用 `Start-Process` 把它**甩出去**
+//    —— 实验证明被甩出去的进程能独立活到用户关掉它(启动器退出、甚至 node 退出之后,窗口
+//    标题仍在枚举里)。所以链路是:node wait 启动器 → 启动器把弹窗甩出去后立刻退出。
+//
+// 另外两个 Windows 细节(都实测过,改的时候别想当然):
+//   - `Start-Process -WindowStyle Hidden` 会把**窗体也一起藏掉**(STARTUPINFO 的
+//     wShowWindow=SW_HIDE 会被子进程继承,而进程的第一次 ShowWindow 会强制用它)。
+//     → 先 `Show()` 一个丢弃窗体把这一次用掉,真窗体再正常显示。
+//   - 不给 `-WindowStyle Hidden` 的话会多出一个黑色控制台窗口 → 必须给。
 import { spawn } from 'node:child_process'
 
 // ---------------------------------------------------------------------------
@@ -80,12 +89,27 @@ const POWERSHELL_AUMID =
 // 这几个英文名)。逐个试,一个都没有才退回 SystemSounds 的默认音。
 const WIN_WAVS = {
   ok: ['Windows Notify System Generic.wav', 'notify.wav', 'chimes.wav'],
-  fail: ['Windows Critical Stop.wav', 'Windows Battery Critical.wav', 'Alarm01.wav'],
+  error: ['Windows Critical Stop.wav', 'Windows Battery Critical.wav', 'Alarm01.wav'],
+}
+const WIN_SYSTEM_SOUND = { ok: 'Asterisk', error: 'Hand' }
+
+// 三条可能出现的结局各一套配色(置顶弹窗的底色)。warn 用琥珀色:"包已经发出去了、
+// 只是没装到全局"既不是成功也不是失败,涂成绿的或红的都是误导。
+const LEVEL_COLORS = {
+  ok: { accent: [46, 160, 67], bg: [24, 28, 26] },
+  warn: { accent: [204, 141, 30], bg: [32, 28, 18] },
+  error: { accent: [200, 70, 70], bg: [34, 22, 24] },
 }
-const WIN_SYSTEM_SOUND = { ok: 'Asterisk', fail: 'Hand' }
 
-function winSoundScript(ok) {
-  const kind = ok ? 'ok' : 'fail'
+/** `level` 缺省时按 ok 回落:true → ok,false → error */
+function normalizeLevel(level, ok) {
+  if (level === 'ok' || level === 'warn' || level === 'error') return level
+  return ok === false ? 'error' : 'ok'
+}
+
+function winSoundScript(level) {
+  // warn 也走"普通提示音":它要人看一眼,但不是出错
+  const kind = level === 'error' ? 'error' : 'ok'
   const candidates = WIN_WAVS[kind].map((f) => `(Join-Path $env:WINDIR 'Media\\${f}')`).join(', ')
   return [
     '$played = $false',
@@ -112,6 +136,102 @@ function winToastScript(title, message) {
   ].join('; ')
 }
 
+// 置顶弹窗的停留时长。给足 5 分钟:系统横幅只挂 MessageDuration(本机实测 5 秒)就没了,
+// 而"人走开几分钟再回来"才是常态;再长就没必要了(通知中心 + 终端标题都是常驻的)。
+export const POPUP_TIMEOUT_MS = 5 * 60 * 1000
+
+/**
+ * 置顶弹窗的脚本。**由启动器用 Start-Process 甩出去单独跑**(理由见文件头坑②)。
+ *
+ * 用 -EncodedCommand(UTF-16LE base64)传,绕开所有命令行引号问题:标题/正文里带单引号、
+ * 双引号、`&`、`%` 都不会出事。
+ */
+export function winPopupScript({ title, message, level, ok = true, timeoutMs = POPUP_TIMEOUT_MS } = {}) {
+  const lv = normalizeLevel(level, ok)
+  const { accent, bg } = LEVEL_COLORS[lv]
+  const rgb = ([r, g, b]) => `[System.Drawing.Color]::FromArgb(${r}, ${g}, ${b})`
+  const minutes = Math.max(1, Math.round(timeoutMs / 60000))
+  return [
+    "$ErrorActionPreference = 'SilentlyContinue'",
+    'Add-Type -AssemblyName System.Windows.Forms',
+    'Add-Type -AssemblyName System.Drawing',
+    // 先 Show 一个丢弃窗体:进程的**第一次** ShowWindow 会被 STARTUPINFO 里的
+    // wShowWindow(SW_HIDE,来自 Start-Process -WindowStyle Hidden)强制覆盖,
+    // 让它顶掉,真窗体才能正常显示 —— 不加这段弹窗永远不出现。
+    '$d = New-Object System.Windows.Forms.Form',
+    '$d.Show(); $d.Hide(); $d.Dispose()',
+    '$f = New-Object System.Windows.Forms.Form',
+    `$f.Text = ${psQuote(title)}`,
+    '$f.TopMost = $true',
+    "$f.StartPosition = 'CenterScreen'",
+    '$f.ClientSize = New-Object System.Drawing.Size(540, 250)',
+    '$f.MinimizeBox = $false',
+    '$f.MaximizeBox = $false',
+    "$f.FormBorderStyle = 'FixedToolWindow'",
+    `$f.BackColor = ${rgb(bg)}`,
+    '$f.KeyPreview = $true',
+    // 整块窗体都能点掉:人在键盘前时一下就走,不用瞄准按钮
+    '$f.Add_Click({ $f.Close() })',
+    "$f.Add_KeyDown({ if ($_.KeyCode -eq 'Escape') { $f.Close() } })",
+    '$bar = New-Object System.Windows.Forms.Label',
+    '$bar.Dock = "Top"',
+    '$bar.Height = 5',
+    `$bar.BackColor = ${rgb(accent)}`,
+    '$f.Controls.Add($bar)',
+    '$t = New-Object System.Windows.Forms.Label',
+    `$t.Text = ${psQuote(title)}`,
+    "$t.Font = New-Object System.Drawing.Font('Microsoft YaHei UI', 13, [System.Drawing.FontStyle]::Bold)",
+    "$t.ForeColor = [System.Drawing.Color]::FromArgb(240, 242, 245)",
+    '$t.Dock = "Top"',
+    '$t.Height = 56',
+    '$t.Padding = New-Object System.Windows.Forms.Padding(20, 14, 20, 0)',
+    '$f.Controls.Add($t)',
+    '$m = New-Object System.Windows.Forms.Label',
+    `$m.Text = ${psQuote(message)}`,
+    "$m.Font = New-Object System.Drawing.Font('Microsoft YaHei UI', 10)",
+    "$m.ForeColor = [System.Drawing.Color]::FromArgb(190, 196, 205)",
+    '$m.Dock = "Fill"',
+    '$m.Padding = New-Object System.Windows.Forms.Padding(20, 8, 20, 0)',
+    '$f.Controls.Add($m)',
+    '$h = New-Object System.Windows.Forms.Label',
+    `$h.Text = ${psQuote(`点击窗口任意位置关闭(${minutes} 分钟后自动关闭)`)}`,
+    "$h.Font = New-Object System.Drawing.Font('Microsoft YaHei UI', 8)",
+    "$h.ForeColor = [System.Drawing.Color]::FromArgb(130, 138, 150)",
+    '$h.Dock = "Bottom"',
+    '$h.Height = 34',
+    '$h.TextAlign = "MiddleLeft"',
+    '$h.Padding = New-Object System.Windows.Forms.Padding(20, 0, 20, 6)',
+    '$f.Controls.Add($h)',
+    '$timer = New-Object System.Windows.Forms.Timer',
+    `$timer.Interval = ${timeoutMs}`,
+    '$timer.Add_Tick({ $f.Close() })',
+    '$timer.Start()',
+    '[void]$f.ShowDialog()',
+  ].join('\n')
+}
+
+/**
+ * Windows 的"启动器":在**一个** PowerShell 里按顺序做完三件事,然后退出。
+ * 三件事各自 try 住 —— 通知被策略挡了不该把提示音一起带走。
+ *
+ * 顺序是有讲究的:toast 和甩弹窗都是瞬间返回的(体感上同时出现),提示音是同步阻塞的
+ * (PlaySync 要把 wav 放完),放最后才不会拖慢前两者。
+ */
+export function winLauncherScript({ title, message, level, ok = true, timeoutMs } = {}) {
+  const lv = normalizeLevel(level, ok)
+  const popupB64 = Buffer.from(
+    winPopupScript({ title, message, level: lv, timeoutMs }),
+    'utf16le'
+  ).toString('base64')
+  return [
+    "$ErrorActionPreference = 'SilentlyContinue'",
+    `try { ${winToastScript(title, message)} } catch { }`,
+    "try { Start-Process -WindowStyle Hidden -FilePath 'powershell.exe'"
+      + ` -ArgumentList @('-NoProfile','-NonInteractive','-EncodedCommand','${popupB64}') } catch { }`,
+    `try { ${winSoundScript(lv)} } catch { }`,
+  ].join('; ')
+}
+
 // ---------------------------------------------------------------------------
 // 计划(纯函数 —— 单测只断言这里)
 // ---------------------------------------------------------------------------
@@ -119,28 +239,26 @@ function winToastScript(title, message) {
 /**
  * 按平台把"提醒一次"翻译成要跑的进程列表。
  *
- * 纯函数,不碰进程也不碰文件系统,便于单测;真正 spawn 的是 notifyDesktop()。
+ * 纯函数,不碰进程也不碰文件系统,便于单测;真正 spawn + 等待的是 notifyDesktop()。
  * 返回 `{ title, cmds: [{ cmd, args }] }`。
  */
-export function buildNotifyPlan({ platform = process.platform, title, message, ok = true } = {}) {
+export function buildNotifyPlan({ platform = process.platform, title, message, ok = true, level, timeoutMs } = {}) {
   const safeTitle = String(title ?? '')
   const safeMessage = String(message ?? '')
+  const lv = normalizeLevel(level, ok)
 
   if (platform === 'win32') {
-    const ps = ['-NoProfile', '-NonInteractive', '-Command']
+    const script = winLauncherScript({ title: safeTitle, message: safeMessage, level: lv, timeoutMs })
     return {
       title: safeTitle,
-      cmds: [
-        { cmd: 'powershell.exe', args: [...ps, winToastScript(safeTitle, safeMessage)] },
-        { cmd: 'powershell.exe', args: [...ps, winSoundScript(ok)] },
-      ],
+      cmds: [{ cmd: 'powershell.exe', args: ['-NoProfile', '-NonInteractive', '-Command', script] }],
     }
   }
 
   if (platform === 'darwin') {
     const script = `display notification ${appleScriptQuote(safeMessage)}`
       + ` with title ${appleScriptQuote(safeTitle)}`
-      + ` sound name ${appleScriptQuote(ok ? 'Glass' : 'Basso')}`
+      + ` sound name ${appleScriptQuote(lv === 'error' ? 'Basso' : 'Glass')}`
     return { title: safeTitle, cmds: [{ cmd: 'osascript', args: ['-e', script] }] }
   }
 
@@ -150,54 +268,94 @@ export function buildNotifyPlan({ platform = process.platform, title, message, o
     cmds: [
       {
         cmd: 'notify-send',
-        args: ['-a', 'zen-gitsync', '-u', ok ? 'normal' : 'critical', safeTitle, safeMessage],
+        args: ['-a', 'zen-gitsync', '-u', lv === 'error' ? 'critical' : 'normal', safeTitle, safeMessage],
       },
       {
         cmd: 'paplay',
         args: [
-          ok
-            ? '/usr/share/sounds/freedesktop/stereo/complete.oga'
-            : '/usr/share/sounds/freedesktop/stereo/dialog-error.oga',
+          lv === 'error'
+            ? '/usr/share/sounds/freedesktop/stereo/dialog-error.oga'
+            : '/usr/share/sounds/freedesktop/stereo/complete.oga',
         ],
       },
     ],
   }
 }
 
+// 等子进程结束(或超时后杀掉它,免得把调用方一直吊着)
+function waitForChild(child, timeoutMs) {
+  return new Promise((resolve) => {
+    let done = false
+    let timer = null
+    const finish = (settled) => {
+      if (done) return
+      done = true
+      if (timer) clearTimeout(timer)
+      resolve(settled)
+    }
+    timer = setTimeout(() => {
+      try {
+        child.kill()
+      } catch {
+        /* 已经退了 */
+      }
+      finish(false)
+    }, timeoutMs)
+    // 命令不存在(比如 Linux 上没装 notify-send)只会走 'error' 事件,不挂这个监听
+    // 就是未捕获异常 —— 会直接把一次成功的发布打挂。提醒是附加品,不许反噬主线。
+    child.on('error', () => finish(false))
+    child.on('exit', () => finish(true))
+  })
+}
+
 /**
- * 发一次提醒。返回成功派生的进程数(拿不到具体结果 —— 提醒本身没有失败可言)。
+ * 发一次提醒,**并等它真的做完**(默认最多 15s)。返回 `{ launched, delivered }`。
  *
- * 不 await、不阻塞:所有子进程 unref(),调用方紧接着 process.exit() 也不会把它们掐掉。
+ * 为什么必须 await(而不是 spawn 完就走):见文件头坑①。第一版就是 fire-and-forget,
+ * 结果 cmd 里打着"已发送结束提醒"、而系统里一条通知都没有。
+ *
+ * 超时不会抛异常,只是把子进程杀掉并如实报 `delivered: false` —— 提醒失败不影响发布结果。
  */
-export function notifyDesktop({ title, message, ok = true, platform = process.platform } = {}) {
+export async function notifyDesktop({
+  title,
+  message,
+  ok = true,
+  level,
+  platform = process.platform,
+  timeoutMs = 15000,
+} = {}) {
   let plan
   try {
-    plan = buildNotifyPlan({ platform, title, message, ok })
+    plan = buildNotifyPlan({ platform, title, message, ok, level })
   } catch {
-    return 0
+    return { launched: 0, delivered: false }
   }
 
-  let launched = 0
+  const children = []
   for (const { cmd, args } of plan.cmds) {
     try {
       const child = spawn(cmd, args, { stdio: 'ignore' })
-      // 命令不存在只会触发 'error' 事件;没有这个监听就是未捕获异常
-      child.on('error', () => {})
-      child.unref()
-      launched += 1
+      children.push(child)
     } catch {
       /* 参数非法等同步异常:吞掉,提醒失败不反噬主线 */
     }
   }
-  return launched
+
+  const settled = await Promise.all(children.map((c) => waitForChild(c, timeoutMs)))
+  return {
+    launched: children.length,
+    delivered: children.length > 0 && settled.every(Boolean),
+  }
 }
 
 /**
  * 改终端标题。
  *
- * Windows 走 `process.title`(Node 内部是 SetConsoleTitle,实测 cmd 窗口标题会变);
+ * Windows 走 `process.title`(Node 内部是 SetConsoleTitle,实测 cmd 窗口标题会变),
  * 其他平台 process.title 只改进程名,所以额外写一次 OSC 0 转义 —— 只在 TTY 上写,
  * 重定向到文件时写这个等于往文件里灌乱码。
+ *
+ * 这条信道**不需要任何子进程**,所以哪怕通知/弹窗全被系统挡住,任务栏上那行字也还在。
  */
 export function setTerminalTitle(text) {
   const title = String(text ?? '')

package/src/utils/desktopNotify.test.js

@@ -14,14 +14,17 @@
 //
 // src/utils/desktopNotify.js 里"纯函数 + 转义"部分的单元测试(node:test 内置)。
 //
-// 只测到 buildNotifyPlan 为止,**不真的 spawn** —— 单测里弹 toast / 响一声会打扰跑测试的人。
-// 这里要守住的两件事,都是"错了不会报错、只会静默失效"的类型:
+// 只测到 buildNotifyPlan 为止,**不真的 spawn** —— 单测里弹窗/响一声会打扰跑测试的人。
+// 这里要守住的三件事,全都是"错了不会报错、只会静默失效"的类型:
 //   ① 文案里的 `<` / `&` 没转义 → toast 的 XML 解析失败 → 一条都不弹,且错误被吞;
-//   ② 文案里的单引号没翻倍 → PowerShell 语法错 → 静默什么都不做。
+//   ② 文案里的单引号没翻倍 → PowerShell 语法错 → 静默什么都不做;
+//   ③ 弹窗脚本没被正确 base64 编进启动器 → Start-Process 收到一段垃圾,弹窗永远不出现。
 import { test } from 'node:test'
 import assert from 'node:assert/strict'
 import {
   buildNotifyPlan,
+  winPopupScript,
+  winLauncherScript,
   psQuote,
   xmlEscape,
   appleScriptQuote,
@@ -47,56 +50,108 @@ test('appleScriptQuote: 先转反斜杠再转双引号(顺序反了会把 \\"
   assert.equal(appleScriptQuote('C:\\tmp'), '"C:\\\\tmp"')
 })
 
-// ========== Windows ==========
+// ========== Windows:启动器 ==========
 
-test('win32 plan: 两个进程 —— toast 一个、提示音一个', () => {
+test('win32 plan: 只起一个 PowerShell(三件事都在同一个进程里做,省两次冷启动)', () => {
   const plan = buildNotifyPlan({ platform: 'win32', title: 't', message: 'm', ok: true })
-  assert.equal(plan.cmds.length, 2)
-  assert.ok(plan.cmds.every((c) => c.cmd === 'powershell.exe'))
-  assert.ok(plan.cmds.every((c) => c.args.includes('-NoProfile') && c.args.includes('-NonInteractive')))
+  assert.equal(plan.cmds.length, 1)
+  assert.equal(plan.cmds[0].cmd, 'powershell.exe')
+  assert.ok(plan.cmds[0].args.includes('-NoProfile'))
+  assert.ok(plan.cmds[0].args.includes('-NonInteractive'))
 })
 
-test('win32 toast: 正文走 XML 转义,且整段脚本是单引号字面量(带引号也不炸)', () => {
-  const plan = buildNotifyPlan({
+test('win32 启动器:toast + 甩弹窗 + 提示音三件事齐,且各自 try 住', () => {
+  const script = buildNotifyPlan({ platform: 'win32', title: 't', message: 'm', ok: true }).cmds[0].args.at(-1)
+  assert.ok(script.includes('ToastNotificationManager'), '缺 toast')
+  assert.ok(script.includes('Start-Process -WindowStyle Hidden'), '缺甩弹窗')
+  assert.ok(script.includes('SoundPlayer'), '缺提示音')
+  assert.ok(script.includes('try {') && script.includes('catch { }'), '三件事没各自 try 住')
+})
+
+test('win32 启动器:弹窗脚本按 UTF-16LE base64 编进 -EncodedCommand', () => {
+  const title = '发布完成 · zen-gitsync v1.2.3'
+  const message = "包里有 'quote' 与 <tag>"
+  const script = winLauncherScript({ title, message, level: 'ok' })
+  const popup = winPopupScript({ title, message, level: 'ok' })
+  const b64 = Buffer.from(popup, 'utf16le').toString('base64')
+  assert.ok(script.includes(b64), '启动器里的 base64 与 winPopupScript 对不上')
+  // 反向自证:解回来必须还是原脚本(自证不是空断言)
+  const decoded = Buffer.from(b64, 'base64').toString('utf16le')
+  assert.equal(decoded, popup)
+  assert.ok(decoded.includes("包里有 ''quote'' 与 <tag>"), 'PS 单引号未翻倍')
+})
+
+test('win32 toast: 正文走 XML 转义,且整段脚本是单引号字面量', () => {
+  const script = buildNotifyPlan({
     platform: 'win32',
     title: "it's done",
     message: 'Unexpected token < in JSON & "x"',
     ok: true,
-  })
-  const script = plan.cmds[0].args.at(-1)
+  }).cmds[0].args.at(-1)
   assert.ok(script.includes('Unexpected token &lt; in JSON &amp; "x"'), 'XML 未转义')
   assert.ok(script.includes("it''s done"), 'PS 单引号未翻倍')
-  // 转义后的正文不能再出现裸的 <text> 之外的尖括号
   assert.ok(!script.includes('< in JSON'), '原始 < 漏进了 XML')
 })
 
-test('win32 提示音:成功与失败是不同的音源', () => {
-  const okScript = buildNotifyPlan({ platform: 'win32', title: 't', message: 'm', ok: true }).cmds[1].args.at(-1)
-  const failScript = buildNotifyPlan({ platform: 'win32', title: 't', message: 'm', ok: false }).cmds[1].args.at(-1)
-  assert.notEqual(okScript, failScript)
+test('win32 提示音:成功与失败是不同的音源,且成功走普通提示音', () => {
+  const okScript = buildNotifyPlan({ platform: 'win32', title: 't', message: 'm', ok: true }).cmds[0].args.at(-1)
+  const errScript = buildNotifyPlan({ platform: 'win32', title: 't', message: 'm', ok: false }).cmds[0].args.at(-1)
   assert.ok(okScript.includes('Windows Notify System Generic.wav'))
-  assert.ok(failScript.includes('Windows Critical Stop.wav'))
-  // 各自的兜底音也要分开
+  assert.ok(errScript.includes('Windows Critical Stop.wav'))
   assert.ok(okScript.includes('SystemSounds]::Asterisk.Play()'))
-  assert.ok(failScript.includes('SystemSounds]::Hand.Play()'))
+  assert.ok(errScript.includes('SystemSounds]::Hand.Play()'))
+})
+
+test('win32 提示音:warn 用普通提示音(要人看一眼,但不是出错)', () => {
+  const script = buildNotifyPlan({ platform: 'win32', title: 't', message: 'm', level: 'warn' }).cmds[0].args.at(-1)
+  assert.ok(script.includes('Windows Notify System Generic.wav'))
+  assert.ok(!script.includes('Windows Critical Stop.wav'))
+})
+
+// ========== Windows:弹窗 ==========
+
+test('弹窗:置顶 + 可点掉 + 有兜底自动关闭(不然会一直挂在桌面上)', () => {
+  const script = winPopupScript({ title: 't', message: 'm', level: 'ok', timeoutMs: 5000 })
+  assert.ok(script.includes('$f.TopMost = $true'))
+  assert.ok(script.includes('$f.Add_Click({ $f.Close() })'))
+  assert.ok(script.includes("$_.KeyCode -eq 'Escape'"))
+  assert.ok(script.includes('$timer.Interval = 5000'))
+})
+
+test('弹窗:先 Show 一个丢弃窗体吞掉 STARTUPINFO 的 SW_HIDE,否则真窗体永远不显示', () => {
+  const script = winPopupScript({ title: 't', message: 'm' })
+  const dummyAt = script.indexOf('$d.Show(); $d.Hide(); $d.Dispose()')
+  const realAt = script.indexOf('ShowDialog()')
+  assert.ok(dummyAt >= 0 && realAt > dummyAt, '丢弃窗体没出现在真窗体之前')
+})
+
+test('弹窗:三种结局三套配色,ok / warn / 未给 level 时按 ok 回落', () => {
+  // 取顶部色条的颜色(背景色在脚本里更靠前,不能拿"第一个 Argb"当判据)
+  const colorOf = (opts) =>
+    winPopupScript({ title: 't', message: 'm', ...opts }).match(/\$bar\.BackColor = .*?Argb\((\d+, \d+, \d+)\)/)[1]
+  assert.equal(colorOf({ level: 'ok' }), '46, 160, 67')
+  assert.equal(colorOf({ level: 'warn' }), '204, 141, 30')
+  assert.equal(colorOf({ level: 'error' }), '200, 70, 70')
+  // 没给 level:ok:false 应当拿到错误色,而不是默认色
+  assert.equal(colorOf({ ok: true }), '46, 160, 67')
+  assert.equal(colorOf({ ok: false }), '200, 70, 70')
 })
 
-test('win32 提示音:先 PlaySync 播 wav,播到了就不放兜底音', () => {
-  const script = buildNotifyPlan({ platform: 'win32', title: 't', message: 'm' }).cmds[1].args.at(-1)
-  assert.ok(script.includes('PlaySync()'))
-  assert.ok(script.includes('if (-not $played)'), '兜底音没被 $played 拦住 → 会响两遍')
+test('弹窗:正文里的单引号 / 换行不会破语法(整体走 psQuote)', () => {
+  const script = winPopupScript({ title: "it's", message: "line1\nline2 'quoted'" })
+  assert.ok(script.includes("line1\nline2 ''quoted''"))
 })
 
 // ========== macOS / Linux ==========
 
-test('darwin plan: 一条 osascript,成功失败用不同的 sound name', () => {
+test('darwin plan: 一条 osascript,成功用 Glass、出错用 Basso', () => {
   const okPlan = buildNotifyPlan({ platform: 'darwin', title: 't', message: 'm', ok: true })
-  const failPlan = buildNotifyPlan({ platform: 'darwin', title: 't', message: 'm', ok: false })
+  const errPlan = buildNotifyPlan({ platform: 'darwin', title: 't', message: 'm', ok: false })
   assert.equal(okPlan.cmds.length, 1)
   assert.equal(okPlan.cmds[0].cmd, 'osascript')
   assert.ok(okPlan.cmds[0].args[1].includes('sound name "Glass"'))
-  assert.ok(failPlan.cmds[0].args[1].includes('sound name "Basso"'))
-  assert.ok(failPlan.cmds[0].args[1].includes('with title "t"'))
+  assert.ok(errPlan.cmds[0].args[1].includes('sound name "Basso"'))
+  assert.ok(errPlan.cmds[0].args[1].includes('with title "t"'))
 })
 
 test('darwin plan: 文案里的双引号转义后再进 AppleScript', () => {
@@ -118,5 +173,5 @@ test('未知平台按 linux 兜底(不抛异常)', () => {
 test('缺省参数不炸:title / message 全空也能生成计划', () => {
   const plan = buildNotifyPlan({ platform: 'win32' })
   assert.equal(plan.title, '')
-  assert.equal(plan.cmds.length, 2)
+  assert.equal(plan.cmds.length, 1)
 })