@freely01/opencode-notify 0.1.1 → 0.2.0

package/senders/system/linux.ts

@@ -0,0 +1,16 @@
+/**
+ * Linux 系统通知
+ *
+ * 使用 notify-send（来自 libnotify）。
+ * 桌面发行版通常预装，如缺失可:
+ *   apt install libnotify-bin / yum install libnotify
+ */
+
+import { execSync } from "node:child_process"
+
+export async function notify(title: string, body: string): Promise<void> {
+  execSync(`notify-send "${title}" "${body}"`, {
+    timeout: 5000,
+    stdio: "ignore",
+  })
+}

package/senders/system/win32.ts

@@ -0,0 +1,28 @@
+/**
+ * Windows 系统通知
+ *
+ * 优先使用 BurntToast（需额外安装），失败时回退为 MessageBox。
+ * 安装 BurntToast:
+ *   Install-Module -Name BurntToast -Force
+ *
+ * PowerShell script 使用单引号包裹字符串以避免扩展问题。
+ */
+
+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")
+
+  execSync(`powershell -NoProfile -Command ${JSON.stringify(psScript)}`, {
+    timeout: 10000,
+    stdio: "ignore",
+  })
+}

package/session-tracker.ts

@@ -0,0 +1,133 @@
+/**
+ * 会话状态追踪器
+ *
+ * 跟踪 opencode 每个会话的用户活跃状态，
+ * 用于会话感知的通知抑制（用户在操作某会话时跳过部分通知）。
+ *
+ * 状态更新事件：
+ *   message.updated / permission.replied / question.replied
+ *   command.executed / tui.command.execute
+ *
+ * 生命周期事件：
+ *   session.created / session.deleted
+ */
+
+import { warn } from "./log.js"
+
+export interface SessionInfo {
+  sessionID: string
+  /** 用户最后操作时间戳 */
+  lastActivity: number
+  /** 会话创建时间 */
+  createdAt: number
+}
+
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000  // 5 分钟
+
+export class SessionTracker {
+  private sessions = new Map<string, SessionInfo>()
+  private staleTimeoutMs: number
+  private cleanupTimer: ReturnType<typeof setInterval> | null = null
+
+  /**
+   * @param staleTimeoutMs 会话无操作自动淘汰阈值（默认 10 分钟）
+   */
+  constructor(staleTimeoutMs = 600_000) {
+    this.staleTimeoutMs = staleTimeoutMs
+    this.startCleanupTimer()
+  }
+
+  // ============ 对外接口 ============
+
+  /**
+   * 检查某会话在指定超时窗口内是否有用户活动
+   * @returns true = 用户正在操作，应抑制可抑制事件
+   */
+  isSessionActive(sessionID: string, activityTimeoutMs: number): boolean {
+    if (sessionID === "unknown") return false
+    const info = this.sessions.get(sessionID)
+    if (!info) return false
+    return Date.now() - info.lastActivity < activityTimeoutMs
+  }
+
+  // ============ 事件更新 ============
+
+  /** 标记用户在该会话中有操作 */
+  markActivity(sessionID: string): void {
+    if (sessionID === "unknown") return
+    this.lazyCleanup()
+    const existing = this.sessions.get(sessionID)
+    if (existing) {
+      existing.lastActivity = Date.now()
+    } else {
+      this.sessions.set(sessionID, {
+        sessionID,
+        lastActivity: Date.now(),
+        createdAt: Date.now(),
+      })
+    }
+  }
+
+  /** 注册新会话 */
+  register(sessionID: string): void {
+    if (sessionID === "unknown") return
+    if (!this.sessions.has(sessionID)) {
+      this.sessions.set(sessionID, {
+        sessionID,
+        lastActivity: Date.now(),
+        createdAt: Date.now(),
+      })
+    }
+  }
+
+  /** 移除会话 */
+  remove(sessionID: string): void {
+    this.sessions.delete(sessionID)
+  }
+
+  // ============ 内部 ============
+
+  /** 惰性清除 — 每次操作时顺带清理少数过期条目 */
+  private lazyCleanup(): void {
+    const cutoff = Date.now() - this.staleTimeoutMs
+    // 每次随机检查最多 8 条（避免大 Map 遍历性能开销）
+    let checked = 0
+    for (const [id, info] of this.sessions) {
+      if (checked >= 8) break
+      if (info.lastActivity < cutoff) this.sessions.delete(id)
+      checked++
+    }
+  }
+
+  /** 全量清理 */
+  private fullCleanup(): void {
+    const cutoff = Date.now() - this.staleTimeoutMs
+    for (const [id, info] of this.sessions) {
+      if (info.lastActivity < cutoff) this.sessions.delete(id)
+    }
+  }
+
+  /** 启动定时清理 */
+  private startCleanupTimer(): void {
+    this.cleanupTimer = setInterval(() => this.fullCleanup(), CLEANUP_INTERVAL_MS)
+    this.cleanupTimer.unref()
+  }
+
+  /** 销毁（进程退出时调用） */
+  destroy(): void {
+    if (this.cleanupTimer) {
+      clearInterval(this.cleanupTimer)
+      this.cleanupTimer = null
+    }
+    const count = this.sessions.size
+    this.sessions.clear()
+    if (count > 0) {
+      warn(`会话追踪器销毁，清理 ${count} 个未过期会话`)
+    }
+  }
+
+  /** 当前追踪的会话数（用于调试） */
+  get size(): number {
+    return this.sessions.size
+  }
+}

package/store.ts

@@ -9,6 +9,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"
 import { homedir } from "node:os"
 import { join } from "node:path"
+import { warn, error } from "./log.js"
 
 interface StoreData {
   lastSent: Record<string, number> // key → unix timestamp (seconds)
@@ -90,8 +91,8 @@ export class FileStore {
       const raw = readFileSync(this.path, "utf-8")
       const data = JSON.parse(raw) as StoreData
       this.lastSent = data.lastSent ?? {}
-    } catch {
-      // 文件损坏时使用空状态
+    } catch (e) {
+      warn(`去重状态文件读取失败，使用空状态: ${e instanceof Error ? e.message : String(e)}`)
       this.lastSent = {}
     }
   }
@@ -104,8 +105,8 @@ export class FileStore {
       }
       const data: StoreData = { lastSent: this.lastSent }
       writeFileSync(this.path, JSON.stringify(data, null, 2), "utf-8")
-    } catch {
-      // 持久化失败不应影响主流程
+    } catch (e) {
+      error(`去重状态持久化失败: ${e instanceof Error ? e.message : String(e)}`)
     }
   }
 }

package/terminator-detect.ts

@@ -0,0 +1,164 @@
+/**
+ * Terminator 子屏幕最大化检测
+ *
+ * 当用户在 Terminator 中最大化某个子屏幕时（Ctrl+Shift+X），
+ * 其他子屏幕被遮挡。通过 DBus 查询焦点终端 UUID，
+ * 与本进程的 TERMINATOR_UUID 比较，判定本屏是否被遮挡。
+ *
+ * 检测策略（依次尝试）:
+ *   1. busctl（systemd 自带，Ubuntu 预装）
+ *   2. python3-dbus（备选）
+ *   3. gdbus（GLib 备选）
+ *   4. xdotool 窗口类检测（回退，仅判断是否在 Terminator 窗口中）
+ */
+
+import { execSync } from "node:child_process"
+import { warn, debug } from "./log.js"
+
+/** 当前进程的 TERMINATOR_UUID */
+const MY_UUID = process.env.TERMINATOR_UUID ?? null
+
+/** Terminator DBus 信息（每实例唯一） */
+const DBUS_NAME = process.env.TERMINATOR_DBUS_NAME ?? null
+const DBUS_PATH = process.env.TERMINATOR_DBUS_PATH ?? null
+
+/** 是否已确认在 Terminator 中 */
+let insideTerminator: boolean | null = null
+
+/**
+ * 检测当前子屏幕是否被遮挡（用户在其他子屏幕上操作）
+ *
+ * @returns true  → 本子屏幕被遮挡，不应抑制通知
+ *          false → 本子屏幕可见，正常抑制逻辑
+ *          null  → 无法确定（不在 Terminator 中或检测失败）
+ */
+export function isTerminalOccluded(): boolean | null {
+  if (!MY_UUID) {
+    if (insideTerminator === null) insideTerminator = false
+    return null
+  }
+
+  insideTerminator = true
+
+  // 如果没有 DBus 名称/路径信息，直接回退到 xdotool
+  if (!DBUS_NAME || !DBUS_PATH) {
+    debug(`Terminator DBus 环境变量不全: name=${DBUS_NAME} path=${DBUS_PATH}，回退到 xdotool`)
+    return callXdotool()
+  }
+
+  // 策略 1: busctl
+  try {
+    const focused = callBusctl()
+    if (focused !== null) {
+      const occluded = !uuidEqual(focused, MY_UUID)
+      debug(`Terminator 焦点检测(busctl): 本屏=${shortId(MY_UUID)} 焦点=${shortId(focused)} 遮挡=${occluded}`)
+      return occluded
+    }
+  } catch (e) {
+    debug(`Terminator busctl 失败: ${e instanceof Error ? e.message : String(e)}`)
+  }
+
+  // 策略 2: python3-dbus
+  try {
+    const focused = callPythonDBus()
+    if (focused !== null) {
+      const occluded = !uuidEqual(focused, MY_UUID)
+      debug(`Terminator 焦点检测(python): 本屏=${shortId(MY_UUID)} 焦点=${shortId(focused)} 遮挡=${occluded}`)
+      return occluded
+    }
+  } catch (e) {
+    debug(`Terminator python-dbus 失败: ${e instanceof Error ? e.message : String(e)}`)
+  }
+
+  // 策略 3: gdbus
+  try {
+    const focused = callGDBus()
+    if (focused !== null) {
+      const occluded = !uuidEqual(focused, MY_UUID)
+      debug(`Terminator 焦点检测(gdbus): 本屏=${shortId(MY_UUID)} 焦点=${shortId(focused)} 遮挡=${occluded}`)
+      return occluded
+    }
+  } catch (e) {
+    debug(`Terminator gdbus 失败: ${e instanceof Error ? e.message : String(e)}`)
+  }
+
+  // 策略 4: xdotool 窗口类检测（回退）
+  try {
+    const result = callXdotool()
+    debug(`Terminator 窗口检测(xdotool): ${result}`)
+    return result
+  } catch (e) {
+    warn(`Terminator 所有检测策略均失败，最后错误: ${e instanceof Error ? e.message : String(e)}`)
+    return null
+  }
+}
+
+/**
+ * 检查是否在 Terminator 环境中（基于环境变量）
+ */
+export function isInsideTerminator(): boolean {
+  if (insideTerminator !== null) return insideTerminator
+  insideTerminator = !!process.env.TERMINATOR_UUID
+  return insideTerminator
+}
+
+// ─── 工具函数 ───────────────────────────────────────────────────────────────
+
+/** 比较两个 UUID（忽略 urn:uuid: 前缀） */
+function uuidEqual(a: string, b: string): boolean {
+  const strip = (s: string) => s.replace(/^urn:uuid:/i, "")
+  return strip(a) === strip(b)
+}
+
+/** 取 UUID 前 8 位用于日志 */
+function shortId(uuid: string): string {
+  return uuid.replace(/^urn:uuid:/i, "").slice(0, 8)
+}
+
+// ─── 检测策略实现 ───────────────────────────────────────────────────────────
+
+/** 策略 1: busctl（systemd） */
+function callBusctl(): string | null {
+  const out = execSync(
+    `busctl --user call ${DBUS_NAME} ${DBUS_PATH} ${DBUS_NAME} get_focused_terminal`,
+    { encoding: "utf-8", timeout: 3000 },
+  ).trim()
+  // 输出格式: s "uuid-string"
+  const m = out.match(/s\s+"([^"]+)"/)
+  return m ? m[1] : null
+}
+
+/** 策略 2: python3-dbus */
+function callPythonDBus(): string | null {
+  const out = execSync(
+    `python3 -c "
+import dbus
+bus = dbus.SessionBus()
+proxy = bus.get_object('${DBUS_NAME}', '${DBUS_PATH}')
+focused = proxy.get_focused_terminal(dbus_interface='${DBUS_NAME}')
+print(focused)
+"`,
+    { encoding: "utf-8", timeout: 5000 },
+  ).trim()
+  return out || null
+}
+
+/** 策略 3: gdbus（GLib） */
+function callGDBus(): string | null {
+  const out = execSync(
+    `gdbus call --session --dest ${DBUS_NAME} --object-path ${DBUS_PATH} --method ${DBUS_NAME}.get_focused_terminal`,
+    { encoding: "utf-8", timeout: 3000 },
+  ).trim()
+  // 输出格式: ('uuid-string',)
+  const m = out.match(/\('([^']+)'/)
+  return m ? m[1] : null
+}
+
+/** 策略 4: xdotool 窗口类检测 */
+function callXdotool(): boolean | null {
+  const cls = execSync(
+    `xdotool getactivewindow getwindowclassname`,
+    { encoding: "utf-8", timeout: 3000 },
+  ).trim()
+  return cls === "Terminator" ? true : null
+}

package/senders/screen-flash.ts

@@ -1,42 +0,0 @@
-/**
- * 屏幕跑马灯发送器（Linux X11 专用）
- *
- * 通知时在屏幕四边生成彩色高亮闪烁效果。
- * 使用 Python + PyGObject(GTK 3) 创建透明覆盖窗口。
- * Ubuntu GNOME 桌面内置依赖，无需额外安装。
- */
-
-import { spawn } from "node:child_process"
-import { join, dirname } from "node:path"
-import { fileURLToPath } from "node:url"
-import type { Message } from "../message.js"
-import type { Sender } from "./types.js"
-import type { ScreenFlashChannelConfig } from "../config.js"
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const MARQUEE_SCRIPT = join(__dirname, "..", "scripts", "marquee.py")
-
-export class ScreenFlashSender implements Sender {
-  readonly name = "screen_flash"
-  private config: ScreenFlashChannelConfig
-
-  constructor(config: ScreenFlashChannelConfig) {
-    this.config = config
-  }
-
-  async send(_msg: Message): Promise<void> {
-    if (process.platform !== "linux") return
-
-    const args = [
-      MARQUEE_SCRIPT,
-      String(this.config.duration ?? 3.0),
-      String(this.config.speed ?? 4.0),
-      String(this.config.intensity ?? 0.9),
-    ]
-    const child = spawn("python3", args, {
-      stdio: "ignore",
-      detached: true,
-    })
-    child.unref()
-  }
-}

package/senders/system.ts

@@ -1,88 +0,0 @@
-/**
- * 系统通知发送器
- *
- * 平台适配：
- * - macOS: osascript（内置，无需额外安装）
- * - Linux: notify-send（需 libnotify）
- * - Windows: PowerShell Toast（需 BurntToast 模块）
- */
-
-import { execSync } from "node:child_process"
-import type { Message } from "../message.js"
-import type { Sender } from "./types.js"
-
-export class SystemSender implements Sender {
-  readonly name = "system_message"
-
-  async send(msg: Message): Promise<void> {
-    const { title, body } = escapeForShell(msg.title, msg.body)
-    const platform = process.platform
-
-    try {
-      if (platform === "darwin") {
-        this.sendMacOS(title, body)
-      } else if (platform === "linux") {
-        this.sendLinux(title, body)
-      } else if (platform === "win32") {
-        this.sendWindows(title, body)
-      }
-      // 其他平台静默忽略
-    } catch (err) {
-      throw new Error(`系统通知失败: ${err}`)
-    }
-  }
-
-  private sendMacOS(title: string, body: string): void {
-    // 使用 osascript 显示原生通知
-    const script = `display notification "${body}" with title "${title}" sound name "default"`
-    execSync(`osascript -e ${JSON.stringify(script)}`, {
-      timeout: 5000,
-      stdio: "ignore",
-    })
-  }
-
-  private sendLinux(title: string, body: string): void {
-    execSync(`notify-send "${title}" "${body}"`, {
-      timeout: 5000,
-      stdio: "ignore",
-    })
-  }
-
-  private sendWindows(title: string, body: string): void {
-    // 尝试使用 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}')
-}`
-    execSync(`powershell -NoProfile -Command ${JSON.stringify(psScript)}`, {
-      timeout: 10000,
-      stdio: "ignore",
-    })
-  }
-}
-
-/**
- * 转义标题和正文中的特殊字符，防止 shell 注入
- */
-function escapeForShell(
-  title: string,
-  body: string,
-): { title: string; body: string } {
-  return {
-    title: sanitize(title),
-    body: sanitize(body),
-  }
-}
-
-function sanitize(s: string): string {
-  return s
-    .replace(/"/g, '\\"')
-    .replace(/'/g, "\\'")
-    .replace(/`/g, "\\`")
-    .replace(/\$/g, "\\$")
-    .replace(/\n/g, " ")
-    .replace(/\r/g, "")
-}