@freely01/opencode-notify 0.3.0 → 0.4.1

package/terminator-detect.ts

@@ -1,24 +1,29 @@
 /**
- * Terminator 子屏幕最大化检测
+ * Terminator 子屏幕遮挡检测
  *
- * 当用户在 Terminator 中最大化某个子屏幕时（Ctrl+Shift+X），
- * 其他子屏幕被遮挡。通过 DBus 查询焦点终端 UUID，
- * 与本进程的 TERMINATOR_UUID 比较，判定本屏是否被遮挡。
+ * 检测当前子屏幕是否被真正遮挡（不可见），用于判定是否需要
+ * 强制通知（即使用户在该会话中活跃）。
  *
- * 检测策略（依次尝试）:
- *   1. busctl（systemd 自带，Ubuntu 预装）
- *   2. python3-dbus（备选）
- *   3. gdbus（GLib 备选）
- *   4. xdotool 窗口类检测（回退，仅判断是否在 Terminator 窗口中）
+ * 检测策略（两级）：
+ *   1. X 窗口级别：Terminator 是否是当前活跃窗口（xdotool + xprop）
+ *      否 → 用户在别的应用中 → 遮挡
+ *   2. 子屏级别：用户当前聚焦的是哪个子屏（DBus get_focused_terminal）
+ *     聚焦 != 本屏 → 用户在另一个子屏上 → 遮挡
+ *
+ * 注意：此版本 Terminator 未暴露 get_maximized_terminal 接口，
+ * 无法区分"分屏可见"和"最大化遮挡"。两级结合覆盖核心场景：
+ *   - Terminator 不活跃（浏览器/IDE）：强制通知
+ *   - 本屏聚焦：不通知
+ *   - 另一子屏聚焦（分屏或最大化）：强制通知
  */
 
 import { execSync } from "node:child_process"
-import { warn, debug } from "./log.js"
+import { debug } from "./log.js"
 
 /** 当前进程的 TERMINATOR_UUID */
 const MY_UUID = process.env.TERMINATOR_UUID ?? null
 
-/** Terminator DBus 信息（每实例唯一） */
+/** Terminator DBus 信息 */
 const DBUS_NAME = process.env.TERMINATOR_DBUS_NAME ?? null
 const DBUS_PATH = process.env.TERMINATOR_DBUS_PATH ?? null
 
@@ -26,10 +31,10 @@ const DBUS_PATH = process.env.TERMINATOR_DBUS_PATH ?? null
 let insideTerminator: boolean | null = null
 
 /**
- * 检测当前子屏幕是否被遮挡（用户在其他子屏幕上操作）
+ * 检测当前子屏幕是否被遮挡（不可见）
  *
- * @returns true  → 本子屏幕被遮挡，不应抑制通知
- *          false → 本子屏幕可见，正常抑制逻辑
+ * @returns true  → 本子屏幕被遮挡（用户看不到，应强制通知）
+ *          false → 本子屏幕可见（正常抑制逻辑）
  *          null  → 无法确定（不在 Terminator 中或检测失败）
  */
 export function isTerminalOccluded(): boolean | null {
@@ -40,57 +45,38 @@ export function isTerminalOccluded(): boolean | null {
 
   insideTerminator = true
 
-  // 如果没有 DBus 名称/路径信息，直接回退到 xdotool
-  if (!DBUS_NAME || !DBUS_PATH) {
-    debug(`Terminator DBus 环境变量不全: name=${DBUS_NAME} path=${DBUS_PATH}，回退到 xdotool`)
-    return callXdotool()
-  }
+  // ─── 第一级：X 窗口级别 ────────────────────────────────────────────────
+  // Terminator 窗口是否是当前 X 活跃窗口？
+  const terminatorActive = isTerminatorWindowActive()
 
-  // 策略 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)}`)
+  if (terminatorActive === false) {
+    // 用户在其他应用中（浏览器、IDE 等），本屏不可见
+    debug(`Terminator 窗口非活跃（用户在其他应用中），判定为遮挡`)
+    return true
   }
 
-  // 策略 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)}`)
-  }
+  if (terminatorActive === true) {
+    // ─── 第二级：聚焦终端检测 ──────────────────────────────────────────
+    // Terminator 窗口活跃，检查用户聚焦的是不是本屏
+    const focused = queryFocusedTerminal()
 
-  // 策略 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
+      if (focused === MY_UUID) {
+        debug(`Terminator 本屏聚焦，判定为可见`)
+        return false
+      }
+      // 用户聚焦在另一个子屏上 → 本屏不可见（无论分屏还是最大化）
+      debug(`Terminator 用户聚焦在其他子屏(${shortId(focused)})，判定为遮挡`)
+      return true
     }
-  } 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
+    // 无法查询焦点状态，保守假设可见
+    debug(`Terminator 窗口活跃，无法查询焦点状态，保守假设不遮挡`)
+    return false
   }
+
+  // 无法确定 X 窗口状态
+  return null
 }
 
 /**
@@ -104,61 +90,62 @@ export function isInsideTerminator(): boolean {
 
 // ─── 工具函数 ───────────────────────────────────────────────────────────────
 
-/** 比较两个 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
-}
+// ─── 第一级：X 窗口检测 ──────────────────────────────────────────────────
 
-/** 策略 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
+/**
+ * 检测 Terminator 窗口是否是当前 X 活跃窗口
+ * @returns true=Terminator 是活跃窗口, false=不是, null=检测失败
+ */
+function isTerminatorWindowActive(): boolean | null {
+  try {
+    const out = execSync(
+      `xprop -id $(xdotool getactivewindow) WM_CLASS 2>/dev/null`,
+      { encoding: "utf-8", timeout: 5000 },
+    ).trim()
+    return out.includes('"Terminator"')
+  } catch (e) {
+    debug(`xprop/xdotool 检测 Terminator 窗口失败: ${e instanceof Error ? e.message : String(e)}`)
+    return 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
-}
+// ─── 第二级：聚焦终端检测 ───────────────────────────────────────────────
+
+/**
+ * 通过 DBus 查询当前聚焦的子屏 UUID
+ * @returns UUID 字符串，或 null（查询失败）
+ */
+function queryFocusedTerminal(): string | null {
+  if (!DBUS_NAME || !DBUS_PATH) return null
+
+  // 策略 1: busctl（无 stderr 输出，避免未知方法报错）
+  try {
+    const out = execSync(
+      `busctl --user call ${DBUS_NAME} ${DBUS_PATH} ${DBUS_NAME} get_focused_terminal 2>/dev/null`,
+      { encoding: "utf-8", timeout: 3000 },
+    ).trim()
+    const m = out.match(/s\s+"([^"]+)"/)
+    if (m) return m[1]
+  } catch {
+    // 静默忽略
+  }
+
+  // 策略 2: gdbus（备选）
+  try {
+    const out = execSync(
+      `gdbus call --session --dest ${DBUS_NAME} --object-path ${DBUS_PATH} --method ${DBUS_NAME}.get_focused_terminal 2>/dev/null`,
+      { encoding: "utf-8", timeout: 3000 },
+    ).trim()
+    const m = out.match(/\('([^']+)'/)
+    if (m) return m[1]
+  } catch {
+    // 静默忽略
+  }
 
-/** 策略 4: xdotool 窗口类检测 */
-function callXdotool(): boolean | null {
-  const cls = execSync(
-    `xdotool getactivewindow getwindowclassname`,
-    { encoding: "utf-8", timeout: 3000 },
-  ).trim()
-  return cls === "Terminator" ? true : null
+  return null
 }