@freely01/opencode-notify 0.2.0 → 0.3.0

package/README.md

@@ -13,7 +13,7 @@ opencode 通知插件 — 监听会话中的关键事件，通过多渠道推送
 > - Linux 系统通知需 `libnotify` 包（桌面发行版通常预装）
 > - 事件映射基于 @opencode-ai/plugin@1.15.12 的行为，后续版本升级可能影响兼容性
 > - `run_completed` 事件暂未实现（opencode 无直接完成事件）
-> - 屏幕跑马灯效果仅 Linux X11 环境支持（依赖 Python + PyGObject），Wayland/macOS/Windows 不生效
+> - 屏幕跑马灯效果：Linux X11（Python + PyGObject）/ Windows（PowerShell + WinForms）四边彩色流动
 > - 仅在 Ubuntu 24.04 (X11) 环境下测试并使用，其它平台未验证
 >
 > 如有问题欢迎提 Issue，但不保证及时响应和修复。
@@ -26,7 +26,7 @@ opencode 通知插件 — 监听会话中的关键事件，通过多渠道推送
 - 去重机制：同一事件在时间窗口内不重复发送
 - 会话感知抑制：活跃会话按事件类型智能过滤，不遗漏 `run_failed` 等重要通知
 - 零外部运行时依赖（仅 js-yaml 用于配置解析）
-- **屏幕跑马灯**：通知时屏幕四边高亮闪烁（Linux X11，Python + GTK 内置）
+- **屏幕跑马灯**：通知时屏幕四边高亮闪烁（Linux X11，Python + GTK 内置；Windows 实验性，PowerShell + WinForms）
 - **渠道级事件过滤**：每个渠道可独立配置监听哪些事件，灵活分流
 - **远程延迟推送**：正常通知发出后，指定渠道额外延迟推送以防遗漏
 - **Terminator 子屏检测**：自动检测子屏最大化场景，被遮挡的会话强制通知
@@ -39,13 +39,13 @@ opencode 通知插件 — 监听会话中的关键事件，通过多渠道推送
 | 自定义 Webhook / 企业微信 / 飞书 | ✅ | ✅ | ✅ |
 | 诊断 CLI (`bun cli.ts`) | ✅ | ✅ | ✅ |
 | **系统消息通知** | ✅ `osascript` 内置 | ⚠️ 需 `libnotify` 包 | ⚠️ 需 BurntToast 模块 |
-| **屏幕跑马灯** | ❌ | ✅ Python+GTK 内置 | ❌ |
+| **屏幕跑马灯** | ❌ | ✅ Python+GTK 内置 | ✅ PowerShell+WinForms |
 
 **说明：**
 - **macOS**: 系统通知使用 `osascript`，系统内置，开箱即用
 - **Linux**: 系统通知使用 `notify-send`，来自 `libnotify`。桌面发行版通常预装，如缺失可 `apt install libnotify-bin` / `yum install libnotify`
 - **Windows**: 系统通知使用 PowerShell `New-BurntToastNotification`，需额外安装 [BurntToast](https://github.com/Windos/BurntToast) 模块。Webhook 渠道不受影响
-- **屏幕跑马灯**: 仅 Linux X11 环境。使用 Python + PyGObject(GTK 3)，Ubuntu GNOME 桌面内置，无需额外安装。Wayland 暂不支持
+- **屏幕跑马灯**: Linux X11 使用 Python + PyGObject(GTK 3) 创建透明覆盖窗口，60fps 彩色四边跑马灯动画；Windows 使用 PowerShell + .NET WinForms 创建屏幕四边彩色闪烁边框（实验性）。中间完全透明可点击穿透，不影响操作。macOS 暂不支持
 - 非系统通知模块（Webhook 推送、CLI 诊断）均为纯 HTTP/Node API，全平台一致
 
 > **已测试渠道：** 系统通知、企业微信、自定义 Webhook（Gotify）。飞书等其他渠道理论可用，暂未做验证。
@@ -158,10 +158,9 @@ custom_webhook:
 ![跑马灯效果](doc/de.png)
 
 - 独立渠道，可与系统通知分开启停、分开配置事件过滤
-- 使用 Python + PyGObject(GTK 3) 创建透明覆盖窗口，不干扰当前操作
-- 60fps 动画，彩色灯光沿四边循环运动（红→橙→黄→绿→蓝）
+- Linux X11: 使用 Python + PyGObject(GTK 3) 创建透明覆盖窗口，60fps 彩色灯光沿四边循环运动
+- Windows: 使用 PowerShell + .NET WinForms 创建屏幕四边彩色闪烁边框（8px 宽），中间完全透明可点击穿透，不阻挡任何操作
 - 非阻塞执行，不影响通知发送速度
-- 仅 Linux X11 环境，Ubuntu GNOME 桌面内置，无需额外安装
 
 ```yaml
 screen_flash:
@@ -506,9 +505,10 @@ opencode-notify/
 │   │   ├── darwin.ts        #   macOS (osascript)
 │   │   ├── linux.ts         #   Linux (notify-send)
 │   │   └── win32.ts         #   Windows (PowerShell)
-│   ├── screen-flash/        # 屏幕跑马灯（Linux X11）
-│   │   ├── index.ts         #   入口 + 平台守卫
-│   │   └── linux.ts         #   Linux 实现 (Python+GTK)
+│   ├── screen-flash/        # 屏幕跑马灯（Linux + Windows）
+│   │   ├── index.ts         #   入口 + 平台路由
+│   │   ├── linux.ts         #   Linux 实现 (Python+GTK)
+│   │   └── win32.ts         #   Windows 实现 (PowerShell+WinForms)
 │   ├── custom-webhook.ts    # 自定义 Webhook
 │   ├── wechat-work.ts       # 企业微信
 │   └── feishu.ts            # 飞书

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freely01/opencode-notify",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "opencode 通知插件 - 监听会话事件并通过多渠道推送通知",
   "type": "module",
   "main": "index.ts",

package/senders/screen-flash/index.ts

@@ -1,15 +1,17 @@
 /**
  * 屏幕跑马灯发送器
  *
- * 通知时在屏幕四边产生彩色跑马灯效果。
- * 当前仅 Linux X11 支持（Python + GTK 透明覆盖窗口）。
- * 其他平台静默忽略。
+ * 通知时在屏幕产生彩色闪烁效果，吸引注意力。
+ * - Linux  → Python + GTK3 透明覆盖窗口（四边跑马灯动画）
+ * - Windows → PowerShell + .NET WinForms 全屏彩色闪烁
+ * - macOS / 其他 → 静默忽略
  */
 
 import type { Sender } from "../types.js"
 import type { Message } from "../../message.js"
 import type { ScreenFlashChannelConfig } from "../../config.js"
-import { flash } from "./linux.js"
+import { flash as linuxFlash } from "./linux.js"
+import { flash as win32Flash } from "./win32.js"
 
 export class ScreenFlashSender implements Sender {
   readonly name = "screen_flash"
@@ -20,8 +22,11 @@ export class ScreenFlashSender implements Sender {
   }
 
   async send(_msg: Message): Promise<void> {
-    // 仅 Linux 支持跑马灯效果
-    if (process.platform !== "linux") return
-    await flash(this.config)
+    if (process.platform === "linux") {
+      await linuxFlash(this.config)
+    } else if (process.platform === "win32") {
+      await win32Flash(this.config)
+    }
+    // macOS 及其他平台静默忽略
   }
 }

package/senders/screen-flash/win32.ts

@@ -0,0 +1,129 @@
+/**
+ * Windows 屏幕跑马灯
+ *
+ * 使用 PowerShell + .NET Windows Forms 创建屏幕四边彩色闪烁边框。
+ * 将四边分成多个小段，逐帧偏移颜色，产生 LED 跑马灯流动效果。
+ *
+ * 所有数据通过 $form.Tag（Form 的真实属性）传递，避免事件回调作用域问题。
+ */
+
+import { execSync } from "node:child_process"
+import type { ScreenFlashChannelConfig } from "../../config.js"
+
+export async function flash(config: ScreenFlashChannelConfig): Promise<void> {
+  const duration = config.duration ?? 3.0
+  const speed = config.speed ?? 4.0
+  const borderWidth = 8
+  const totalMs = duration * 1000
+  const intervalMs = Math.max(20, Math.min(150, Math.round(60 / speed)))
+  const segSize = 10
+
+  const psScript = `
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+
+$bc = @(
+  [System.Drawing.Color]::Red,
+  [System.Drawing.Color]::Orange,
+  [System.Drawing.Color]::Yellow,
+  [System.Drawing.Color]::LimeGreen,
+  [System.Drawing.Color]::Blue,
+  [System.Drawing.Color]::Purple
+)
+$g = New-Object System.Collections.ArrayList
+for ($b = 0; $b -lt $bc.Length; $b++) {
+  $n = ($b + 1) % $bc.Length
+  for ($s = 0; $s -lt 8; $s++) {
+    $r = [int]($bc[$b].R + ($bc[$n].R - $bc[$b].R) * $s / 8)
+    $g_ = [int]($bc[$b].G + ($bc[$n].G - $bc[$b].G) * $s / 8)
+    $b_ = [int]($bc[$b].B + ($bc[$n].B - $bc[$b].B) * $s / 8)
+    [void]$g.Add([System.Drawing.Color]::FromArgb(255, [Math]::Min(255,$r), [Math]::Min(255,$g_), [Math]::Min(255,$b_)))
+  }
+}
+
+$form = New-Object System.Windows.Forms.Form
+$form.WindowState = 'Maximized'
+$form.FormBorderStyle = 'None'
+$form.TopMost = $true
+$form.ShowInTaskbar = $false
+$form.BackColor = [System.Drawing.Color]::Fuchsia
+$form.TransparencyKey = [System.Drawing.Color]::Fuchsia
+# Tag 存哈希表: @{ offset=0; gradient=$g; segSize=${segSize}; bw=${borderWidth} }
+$form.Tag = @{ offset = 0; gradient = $g; segSize = ${segSize}; bw = ${borderWidth} }
+
+$form.Add_Paint({
+  $d = $form.Tag
+  $gfx = $args[1].Graphics
+  $w = $form.ClientSize.Width
+  $h = $form.ClientSize.Height
+  $gr = $d.gradient
+  $gl = $gr.Count
+  $ss = $d.segSize
+  $bw = $d.bw
+  $off = $d.offset
+
+  # 上边 (左→右)
+  for ($x = 0; $x -lt $w; $x += $ss) {
+    $gi = [int](($x / $ss) + $off) % $gl
+    $sw = [Math]::Min($ss, $w - $x)
+    $br = [System.Drawing.SolidBrush]::new($gr[$gi])
+    $gfx.FillRectangle($br, $x, 0, $sw, $bw)
+    $br.Dispose()
+  }
+  # 右边 (上→下)
+  for ($y = 0; $y -lt $h; $y += $ss) {
+    $gi = [int](($w / $ss) + ($y / $ss) + $off) % $gl
+    $sh = [Math]::Min($ss, $h - $y)
+    $br = [System.Drawing.SolidBrush]::new($gr[$gi])
+    $gfx.FillRectangle($br, $w - $bw, $y, $bw, $sh)
+    $br.Dispose()
+  }
+  # 下边 (右→左)
+  for ($x = 0; $x -lt $w; $x += $ss) {
+    $gi = [int](($w / $ss) + ($h / $ss) + ($x / $ss) + $off) % $gl
+    $sw = [Math]::Min($ss, $w - $x)
+    $br = [System.Drawing.SolidBrush]::new($gr[$gi])
+    $gfx.FillRectangle($br, $w - $x - $sw, $h - $bw, $sw, $bw)
+    $br.Dispose()
+  }
+  # 左边 (下→上)
+  for ($y = 0; $y -lt $h; $y += $ss) {
+    $gi = [int](($w / $ss) * 2 + ($h / $ss) + ($y / $ss) + $off) % $gl
+    $sh = [Math]::Min($ss, $h - $y)
+    $br = [System.Drawing.SolidBrush]::new($gr[$gi])
+    $gfx.FillRectangle($br, 0, $h - $y - $sh, $bw, $sh)
+    $br.Dispose()
+  }
+})
+
+$form.Show()
+
+# 点击穿透
+$code = @'
+[DllImport("user32.dll")]
+public static extern int SetWindowLong(IntPtr h, int n, int v);
+[DllImport("user32.dll")]
+public static extern int GetWindowLong(IntPtr h, int n);
+'@
+$win32 = Add-Type -MemberDefinition $code -Name W -Namespace W -PassThru
+$style = $win32::GetWindowLong($form.Handle, -20)
+$win32::SetWindowLong($form.Handle, -20, $style -bor 0x20 -bor 0x80)
+
+# 跑马灯循环
+$sw = [System.Diagnostics.Stopwatch]::StartNew()
+while ($sw.ElapsedMilliseconds -lt ${totalMs}) {
+  $d = $form.Tag
+  $d.offset = $d.offset + 1
+  $form.Invalidate()
+  [System.Windows.Forms.Application]::DoEvents()
+  Start-Sleep -Milliseconds ${intervalMs}
+}
+$sw.Stop()
+$form.Close()
+`.trim()
+
+  execSync(`powershell -NoProfile -Command ${JSON.stringify(psScript)}`, {
+    timeout: Math.max(5000, totalMs + 5000),
+    stdio: "ignore",
+  })
+}

package/senders/system/index.ts

@@ -4,8 +4,10 @@
  * 根据运行平台自动选择实现：
  * - macOS  → darwin.ts  (osascript)
  * - Linux  → linux.ts   (notify-send)
- * - Windows → win32.ts  (PowerShell BurntToast / MessageBox)
+ * - Windows → win32.ts  (WinRT Native Toast + NotifyIcon 回退)
  * - 其他平台 → 静默忽略
+ *
+ * Windows 首次调用时自动注册快捷方式，使 toast 出现在通知中心。
  */
 
 import type { Sender } from "../types.js"
@@ -39,6 +41,11 @@ export class SystemSender implements Sender {
 
 /**
  * 转义标题和正文中的特殊字符，防止 shell 注入
+ *
+ * 各平台实际使用的逃逸：
+ * - Linux:  notify-send "${title}" — 只需转义 " $ ` \
+ * - macOS:  osascript -e JSON 序列化 — 全自动处理
+ * - Windows: PowerShell '${title}' — 只需转义单引号（win32.ts 内部处理）
  */
 function sanitize(
   title: string,
@@ -53,7 +60,6 @@ function sanitize(
 function escape(s: string): string {
   return s
     .replace(/"/g, '\\"')
-    .replace(/'/g, "\\'")
     .replace(/`/g, "\\`")
     .replace(/\$/g, "\\$")
     .replace(/\n/g, " ")

package/senders/system/win32.ts

@@ -1,28 +1,51 @@
 /**
  * Windows 系统通知
  *
- * 优先使用 BurntToast（需额外安装），失败时回退为 MessageBox。
- * 安装 BurntToast:
- *   Install-Module -Name BurntToast -Force
+ * 策略：
+ *   1. 通过注册表注册 opencode-notify 通知发送方
+ *   2. WinRT Native Toast — 使用 PowerShell UUID AppId（确认可弹窗）
+ *   3. NotifyIcon BalloonTip — 非阻塞式最终回退
  *
- * PowerShell script 使用单引号包裹字符串以避免扩展问题。
+ * 注册表路径: HKCU\SOFTWARE\Classes\AppUserModelId\opencode-notify
+ * 此注册使通知出现在 Windows 操作中心。
  */
 
 import { execSync } from "node:child_process"
 
 export async function notify(title: string, body: string): Promise<void> {
-  // PowerShell 脚本：优先 BurntToast，失败回退 MessageBox
-  const psScript = [
-    `try {`,
-    `  New-BurntToastNotification -Text '${title}', '${body}' -ErrorAction Stop`,
-    `} catch {`,
-    `  Add-Type -AssemblyName System.Windows.Forms`,
-    `  [System.Windows.Forms.MessageBox]::Show('${body}', '${title}')`,
-    `}`,
-  ].join("\n")
+  const t = title.replace(/'/g, "''")
+  const b = body.replace(/'/g, "''")
 
-  execSync(`powershell -NoProfile -Command ${JSON.stringify(psScript)}`, {
-    timeout: 10000,
+  const ps = `
+# 注册 opencode-notify 到操作中心
+New-Item -Path 'HKCU:\\SOFTWARE\\Classes\\AppUserModelId\\opencode-notify' -Force -ErrorAction Stop | Out-Null
+New-ItemProperty -Path 'HKCU:\\SOFTWARE\\Classes\\AppUserModelId\\opencode-notify' -Name 'DisplayName' -Value 'opencode-notify' -PropertyType String -Force -ErrorAction Stop | Out-Null
+New-ItemProperty -Path 'HKCU:\\SOFTWARE\\Classes\\AppUserModelId\\opencode-notify' -Name 'ShowInSettings' -Value 1 -PropertyType DWord -Force -ErrorAction Stop | Out-Null
+
+# 策略 1: WinRT Native Toast (PowerShell AppId)
+try {
+  [Windows.UI.Notifications.ToastNotificationManager,Windows.UI.Notifications,ContentType=WindowsRuntime] > \$null
+  [Windows.Data.Xml.Dom.XmlDocument,Windows.Data.Xml.Dom.XmlDocument,ContentType=WindowsRuntime] > \$null
+  \$t=[Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent('ToastText02')
+  \$t.SelectSingleNode('//text[@id=\"1\"]').InnerText='${t}'
+  \$t.SelectSingleNode('//text[@id=\"2\"]').InnerText='${b}'
+  [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe').Show(\$t)
+} catch {
+  # 策略 2: NotifyIcon 回退
+  try {
+    Add-Type -AssemblyName System.Windows.Forms,System.Drawing
+    \$n=New-Object System.Windows.Forms.NotifyIcon
+    \$n.Icon=[System.Drawing.SystemIcons]::Information
+    \$n.Visible=\$true
+    \$n.ShowBalloonTip(10000,'${t}','${b}',[System.Windows.Forms.TooltipIcon]::None)
+    Start-Sleep -Milliseconds 500
+    \$n.Dispose()
+  } catch {}
+}
+`.trim()
+
+  execSync(`powershell -NoProfile -Command ${JSON.stringify(ps)}`, {
+    timeout: 15000,
     stdio: "ignore",
   })
 }