@freely01/opencode-notify 0.1.0

package/senders/screen-flash.ts

@@ -0,0 +1,42 @@
+/**
+ * 屏幕跑马灯发送器（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

@@ -0,0 +1,88 @@
+/**
+ * 系统通知发送器
+ *
+ * 平台适配：
+ * - 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, "")
+}

package/senders/types.ts

@@ -0,0 +1,32 @@
+import type { Message } from "../message.js"
+
+/** 通知发送器接口 */
+export interface Sender {
+  readonly name: string
+  send(msg: Message): Promise<void>
+}
+
+/**
+ * 带事件过滤的 Sender 包装器
+ *
+ * 包装一个 Sender，只有 msg.event 在 events 列表中时才转发。
+ * events 为 undefined/空时继承全局（不过滤）。
+ */
+export class FilteredSender implements Sender {
+  readonly name: string
+  private sender: Sender
+  private events: Set<string> | undefined
+
+  constructor(sender: Sender, events?: string[]) {
+    this.name = `${sender.name}[filtered]`
+    this.sender = sender
+    this.events = events && events.length > 0 ? new Set(events) : undefined
+  }
+
+  async send(msg: Message): Promise<void> {
+    if (this.events && !this.events.has(msg.event)) {
+      return // 事件不在该渠道订阅列表中，跳过
+    }
+    return this.sender.send(msg)
+  }
+}

package/senders/wechat-work.ts

@@ -0,0 +1,62 @@
+import type { Sender } from "./types.js"
+import type { Message } from "../message.js"
+import type { WechatWorkChannelConfig } from "../config.js"
+
+/**
+ * 企业微信 群机器人 Webhook 发送器
+ *
+ * 文档: https://developer.work.weixin.qq.com/document/path/99110
+ *
+ * 配置示例:
+ * ```json
+ * {
+ *   "enabled": true,
+ *   "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx"
+ * }
+ * ```
+ *
+ * 消息格式: Markdown
+ * 支持: # 标题、**粗体**、[链接](url)、> 引用、- 列表
+ */
+export class WechatWorkSender implements Sender {
+  readonly name = "wechat_work"
+  private config: WechatWorkChannelConfig
+
+  constructor(config: WechatWorkChannelConfig) {
+    this.config = config
+  }
+
+  async send(msg: Message): Promise<void> {
+    const { webhook_url } = this.config
+
+    if (!webhook_url) {
+      throw new Error("wechat_work: webhook_url not configured")
+    }
+
+    // 构造 markdown 内容
+    const content = [
+      `**${msg.title}**`,
+      "",
+      msg.body,
+      `> 会话: ${msg.sessionID}`,
+    ].join("\n")
+
+    const body = JSON.stringify({
+      msgtype: "markdown",
+      markdown: { content },
+    })
+
+    const response = await fetch(webhook_url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body,
+    })
+
+    if (!response.ok) {
+      const text = await response.text().catch(() => "")
+      throw new Error(
+        `wechat_work returned ${response.status}${text ? `: ${text.slice(0, 500)}` : ""}`,
+      )
+    }
+  }
+}

package/store.ts

@@ -0,0 +1,111 @@
+/**
+ * 去重状态存储
+ *
+ * 基于内存 Map + 可选 JSON 文件持久化。
+ * 使用 "预留发送" 机制：预占发送时隙，发送成功后才标记为已发送，
+ * 发送失败则释放预留，允许后续重试。
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"
+import { homedir } from "node:os"
+import { join } from "node:path"
+
+interface StoreData {
+  lastSent: Record<string, number> // key → unix timestamp (seconds)
+}
+
+export class FileStore {
+  private lastSent: Record<string, number> = {}
+  private reservations: Record<string, number> = {}
+  private path: string
+
+  constructor(path?: string) {
+    this.path =
+      path ?? join(homedir(), ".opencode-notify", "state.json")
+    this.load()
+  }
+
+  /**
+   * 检查是否可以发送（去重检查）
+   * 返回 true 表示允许发送
+   */
+  shouldSend(key: string, windowSec: number, now: number = Date.now()): boolean {
+    // 检查已发送记录
+    const last = this.lastSent[key]
+    if (last && now - last < windowSec * 1000) {
+      return false
+    }
+    // 检查是否已有预留
+    const reserved = this.reservations[key]
+    if (reserved && now - reserved < windowSec * 1000) {
+      return false
+    }
+    return true
+  }
+
+  /**
+   * 预留发送时隙
+   * 返回 true 表示预留成功，可以发送
+   */
+  reserveSend(key: string, windowSec: number, now: number = Date.now()): boolean {
+    // 检查已发送记录
+    const last = this.lastSent[key]
+    if (last && now - last < windowSec * 1000) {
+      return false
+    }
+    // 检查已有预留
+    const reserved = this.reservations[key]
+    if (reserved && now - reserved < windowSec * 1000) {
+      return false
+    }
+    // 创建新预留
+    this.reservations[key] = now
+    return true
+  }
+
+  /**
+   * 标记为已发送
+   */
+  markSent(key: string, now: number = Date.now()): void {
+    this.lastSent[key] = now
+    delete this.reservations[key]
+    this.save()
+  }
+
+  /**
+   * 清除预留（发送失败时调用，允许重试）
+   */
+  clearReservation(key: string): void {
+    delete this.reservations[key]
+  }
+
+  /** 构建去重 key */
+  buildKey(agent: string, event: string, sessionID: string): string {
+    return `${agent}:${event}:${sessionID}`
+  }
+
+  private load(): void {
+    try {
+      if (!existsSync(this.path)) return
+      const raw = readFileSync(this.path, "utf-8")
+      const data = JSON.parse(raw) as StoreData
+      this.lastSent = data.lastSent ?? {}
+    } catch {
+      // 文件损坏时使用空状态
+      this.lastSent = {}
+    }
+  }
+
+  private save(): void {
+    try {
+      const dir = this.path.substring(0, this.path.lastIndexOf("/"))
+      if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true })
+      }
+      const data: StoreData = { lastSent: this.lastSent }
+      writeFileSync(this.path, JSON.stringify(data, null, 2), "utf-8")
+    } catch {
+      // 持久化失败不应影响主流程
+    }
+  }
+}