@freely01/opencode-notify 0.4.1 → 0.4.2

package/config.ts

@@ -75,6 +75,7 @@ export interface PluginConfig {
    *   input_required       - Agent 等待用户输入
    *   run_completed        - 任务执行完成（技术预留，暂未实现）
    *   run_failed           - 任务执行失败
+   *   run_cancelled        - 用户主动中断任务
    */
   events?: string[]
   /** 去重时间窗口（秒），默认 60 */
@@ -259,7 +260,12 @@ channels:
 # =============================================================================
 # 只订阅你关心的事件类型，减少不必要通知。
 #
-# 可选事件（各渠道也可单独配置 events 覆盖此全局列表）:
+# ⚠️ 全局 events 是主闸门：只有在此列表中的事件才会生成通知消息。
+#    渠道级 events（channels.xxx.events）只能从全局列表中进一步收窄，
+#    无法新增全局列表之外的事件。例如全局无 run_cancelled 时，
+#    即使渠道配了 run_cancelled 也不会收到。
+#
+# 可选事件（各渠道也可单独配置 events，从全局列表中进一步筛选）:
 #   permission_required  - Agent 需要用户授权（如执行命令、读写文件）
 #                          触发: permission.asked / question.asked
 #   input_required       - Agent 等待用户输入
@@ -267,11 +273,14 @@ channels:
 #   run_completed        - 任务执行完成（技术预留，暂未实现）
 #   run_failed           - 任务执行失败
 #                          触发: session.error
+#   run_cancelled        - 用户主动中断任务（Ctrl+C 或点击中断按钮）
+#                          触发: session.error (MessageAbortedError)
 # ---------------------------------------------------------------------------
 events:
   - permission_required               # 权限请求通知（推荐开启）
   - input_required                    # 等待输入通知（推荐开启）
   - run_failed                        # 任务失败通知
+  - run_cancelled                     # 用户取消通知（推荐开启）
 
 
 # =============================================================================
@@ -300,7 +309,7 @@ dedupe_seconds: 60                   # 去重时间窗口（秒），0 或负数
 #
 # 抑制规则:
 #   permission_required / input_required: 活跃时抑制（屏上可见）
-#   run_failed / run_completed: 始终通知（异步结果，人可能走开）
+#   run_failed / run_completed / run_cancelled: 始终通知（异步结果，人可能走开）
 # ---------------------------------------------------------------------------
 suppress_when_active: true           # true=开启会话感知抑制, false=不抑制
 activity_timeout_ms: 15000           # 会话操作超时（毫秒）
@@ -309,7 +318,7 @@ activity_timeout_ms: 15000           # 会话操作超时（毫秒）
 suppress_events_when_active:         # 活跃时抑制哪些事件（不填继承默认）
   - permission_required
   - input_required
-  # run_failed / run_completed 不在列表中 → 始终通知
+  # run_failed / run_completed / run_cancelled 不在列表中 → 始终通知
 session_stale_timeout_ms: 600000     # 超时会话自动淘汰（毫秒）
                                      # 10 分钟无任何活动的会话从追踪 Map 移除
                                      # 防止长期运行导致内存泄漏
@@ -416,6 +425,7 @@ const DEFAULT_CONFIG: Required<Pick<PluginConfig, "suppress_when_active" | "acti
     "input_required",
     "run_completed",
     "run_failed",
+    "run_cancelled",
   ],
   dedupe_seconds: 60,
   suppress_when_active: true,

package/delayed-dispatcher.ts

@@ -1,6 +1,7 @@
 import type { Message } from "./message.js"
 import type { Sender } from "./senders/types.js"
 import { error, warn, info, debug } from "./log.js"
+import { isTerminalOccluded } from "./terminator-detect.js"
 
 /**
  * 远程延迟通知调度器
@@ -96,24 +97,46 @@ export class DelayedDispatcher {
     }
   }
 
+  /**
+   * 将毫秒转换为人类可读的间隔描述
+   * 例: 30_000 → "30秒", 120_000 → "2分钟", 3_600_000 → "60分钟"
+   */
+  private formatInterval(ms: number): string {
+    const sec = Math.round(ms / 1000)
+    if (sec < 60) return `${sec}秒`
+    const min = Math.round(sec / 60)
+    return `${min}分钟`
+  }
+
   /**
    * 在通知正文追加或替换延迟推送标记
    *
    * 清除正文末尾已有的旧标记行，追加最新标记。
    * 标记格式：
    *   ─────────────────
-   *   ⚠️ 延迟推送 第2/3次（下次约 15:31:00）
+   *   ⚠️ 延迟 第2/3次（下次约 15:31:00 / 2分钟后）
    */
-  private markDelayBody(body: string, current: number, total: number, delayMs: number): string {
+  private markDelayBody(body: string, current: number, total: number, nextDelayMs: number): string {
     // 移除旧标记（从末尾 ─── 分隔线到最后）
     const clean = body.replace(/\n─{3,}[\s\S]*$/, "")
     if (current < total) {
-      const next = new Date(Date.now() + delayMs)
+      const next = new Date(Date.now() + nextDelayMs)
       const t = `${String(next.getHours()).padStart(2, "0")}:${String(next.getMinutes()).padStart(2, "0")}:${String(next.getSeconds()).padStart(2, "0")}`
-      return `${clean}\n─────────────────\n⚠️ 延迟推送 第${current}/${total}次（下次约 ${t}）`
+      return `${clean}\n─────────────────\n⚠️ 延迟 第${current}/${total}次（下次约 ${t} / ${this.formatInterval(nextDelayMs)}后）`
     }
     // 最后一次推送，不显示下次时间
-    return `${clean}\n─────────────────\n⚠️ 延迟推送 第${current}/${total}次（最终）`
+    return `${clean}\n─────────────────\n⚠️ 延迟 第${current}/${total}次（最终）`
+  }
+
+  /**
+   * 根据已发送次数计算本次延迟
+   *
+   * 指数退避：base × 2^count，上限 10 分钟
+   * count=0 → base, count=1 → base×2, count=2 → base×4, ...
+   */
+  private getDelayMs(count: number): number {
+    const max = 600_000  // 10 分钟上限
+    return Math.min(this.delayMs * Math.pow(2, count), max)
   }
 
   /**
@@ -125,12 +148,22 @@ export class DelayedDispatcher {
     const entry = chMap.get(ch)
     if (!entry) return
 
+    const currentDelay = this.getDelayMs(entry.count)
+
     entry.timeoutId = setTimeout(() => {
       entry.timeoutId = null
 
-      // 在正文追加延迟标记（第几次 / 共几次 / 间隔秒数）
+      // 发送前检查：如果终端子屏可见（用户已回到电脑前），取消本会话的所有待发延迟
+      if (isTerminalOccluded() === false) {
+        info(`远程延迟: 用户已回到终端，取消会话=${sid} 的延迟推送`)
+        this.cancelForSession(sid)
+        return
+      }
+
+      // 在正文追加延迟标记（第几次 / 共几次 / 下次时间）
       const sendCount = entry.count + 1  // 1-based
-      msg.body = this.markDelayBody(msg.body, sendCount, this.maxCount, this.delayMs)
+      const nextDelay = this.getDelayMs(entry.count + 1)
+      msg.body = this.markDelayBody(msg.body, sendCount, this.maxCount, nextDelay)
 
       // 发送延迟通知
       const sender = this.senders.get(ch)
@@ -145,7 +178,7 @@ export class DelayedDispatcher {
       entry.count++
       if (entry.count < this.maxCount) {
         this.scheduleOne(sid, ch, msg)
-        debug(`远程延迟: 重试 ${entry.count}/${this.maxCount} 会话=${sid} 渠道=${ch}`)
+        debug(`远程延迟: 重试 ${entry.count}/${this.maxCount} 会话=${sid} 渠道=${ch} 下次延迟=${this.getDelayMs(entry.count)}ms`)
       } else {
         // 达到最大次数，清理
         chMap.delete(ch)
@@ -154,6 +187,6 @@ export class DelayedDispatcher {
         }
         info(`远程延迟: 已完成 会话=${sid} 渠道=${ch} (推送${entry.count}次)`)
       }
-    }, this.delayMs)
+    }, currentDelay)
   }
 }

package/events.ts

@@ -71,14 +71,33 @@ export function route(
     )
   }
 
-  // 会话错误 → run_failed
-  if (type === "session.error" && enabled.has("run_failed")) {
+  // 会话错误 → run_cancelled / run_failed
+  // MessageAbortedError = 用户主动中断（Ctrl+C 或点击中断按钮）
+  // 其他错误类型 = 真实失败
+  if (type === "session.error") {
     const err = properties.error
-    const errMsg = err?.message ?? err?.name ?? defaultBody("run_failed")
-    return makeMsg(
-      "run_failed",
-      `错误: ${truncate(String(errMsg), 200)}`,
-    )
+
+    // 用户主动中断
+    if (err?.name === "MessageAbortedError") {
+      if (enabled.has("run_cancelled")) {
+        const msg = err?.data?.message ?? ""
+        return makeMsg(
+          "run_cancelled",
+          msg ? `用户中断: ${truncate(msg, 200)}` : defaultBody("run_cancelled"),
+        )
+      }
+      // run_cancelled 未启用 → 跳过，不降级为 run_failed
+      return null
+    }
+
+    // 真实失败
+    if (enabled.has("run_failed")) {
+      const errMsg = err?.data?.message ?? err?.name ?? defaultBody("run_failed")
+      return makeMsg(
+        "run_failed",
+        `错误: ${truncate(String(errMsg), 200)}`,
+      )
+    }
   }
 
   // 会话空闲 → input_required

package/index.ts

@@ -86,9 +86,14 @@ const plugin: Plugin = async (_input, options) => {
 
       // 会话生命周期事件
       if (type === "session.created") {
-        const title = properties.info?.title
-        tracker.register(sessionID, title)
-        debug(`→ 会话已创建, 会话=${sessionID}${title ? ` title="${title}"` : ""}`)
+        const userPrompt = properties.info?.title
+        tracker.register(sessionID, userPrompt)
+        debug(`→ 会话已创建, 会话=${sessionID}${userPrompt ? ` userPrompt="${userPrompt}"` : ""}`)
+      }
+      if (type === "session.updated") {
+        const topic = properties.info?.title
+        tracker.updateTopic(sessionID, topic)
+        debug(`→ 会话已更新, 会话=${sessionID}${topic ? ` topic="${topic}"` : ""}`)
       }
       if (type === "session.deleted") {
         tracker.remove(sessionID)
@@ -104,11 +109,12 @@ const plugin: Plugin = async (_input, options) => {
       const msg = route(event, cfg.events)
       if (!msg) return  // 不关心的事件
 
-      // 注入会话标题（任务描述），增强通知内容
-      const sessionTitle = tracker.getSessionTitle(sessionID)
-      enrich(msg, sessionTitle)
+      // 注入会话主题和任务描述，增强通知内容
+      const userPrompt = tracker.getUserPrompt(sessionID)
+      const sessionTopic = tracker.getSessionTopic(sessionID)
+      enrich(msg, userPrompt, sessionTopic)
 
-      debug(`→ 匹配通知: ${msg.event}${sessionTitle ? ` sessionTitle="${sessionTitle}"` : ""}`)
+      debug(`→ 匹配通知: ${msg.event} sessionTopic="${sessionTopic ?? ""}" userPrompt="${userPrompt ?? ""}"`)
 
       // 会话感知抑制判定
       let shouldSuppress = cfg.suppress_when_active && suppressEvents.includes(msg.event)

package/message.ts

@@ -20,6 +20,7 @@ const EVENT_LABELS: Record<string, string> = {
   input_required: "等待输入",
   run_completed: "任务完成",
   run_failed: "任务失败",
+  run_cancelled: "用户取消",
   session_idle: "会话空闲",
 }
 
@@ -54,6 +55,8 @@ export function defaultBody(event: string): string {
       return "任务执行完成"
     case "run_failed":
       return "任务执行失败"
+    case "run_cancelled":
+      return "用户主动中断了任务"
     default:
       return `事件: ${event}`
   }
@@ -88,21 +91,29 @@ function shortTitle(title: string, maxLen = 20): string {
 }
 
 /**
- * 增强通知消息：注入会话标题
+ * 增强通知消息：注入会话上下文
  *
- * - 标题：`[短标题] 事件标签`（替换 `opencode - 事件标签`）
- * - 正文：追加一行 `任务：完整标题`
+ * - 标题：`[主题] 事件标签`（替换 `opencode - 事件标签`）
+ * - 正文：用 `主题` / `任务` 行替换 `详情` 行
  *
  * @param msg 原始通知消息
- * @param sessionTitle 会话标题（用户输入的问题/任务描述），为空则不增强
+ * @param userPrompt 用户输入的问题/任务描述（创建时捕获）
+ * @param sessionTopic opencode 自动生成的会话主题
  * @returns 增强后的消息（原地修改并返回）
  */
-export function enrich(msg: Message, sessionTitle?: string): Message {
-  if (!sessionTitle) return msg
+export function enrich(msg: Message, userPrompt?: string, sessionTopic?: string): Message {
+  if (!userPrompt && !sessionTopic) return msg
 
+  // 标题优先用主题（更简洁），无主题则用用户提示词
+  const title = sessionTopic ?? userPrompt
   const label = EVENT_LABELS[msg.event] ?? msg.event
-  msg.title = `[${shortTitle(sessionTitle)}] ${label}`
-  // 用"任务"行替换"详情"行（详情的事件细节在会话标题下显得冗余）
-  msg.body = msg.body.replace(/^详情：.*$/m, `任务：${sessionTitle}`)
+  msg.title = `[${shortTitle(title!)}] ${label}`
+
+  // 替换"详情"行，按可用字段生成上下文行
+  const lines: string[] = []
+  if (sessionTopic) lines.push(`主题：${sessionTopic}`)
+  if (userPrompt) lines.push(`任务：${userPrompt}`)
+  // 如果两者都为空（前面 return 了）不可能到这里
+  msg.body = msg.body.replace(/^详情：.*$/m, lines.join("\n"))
   return msg
 }

package/package.json

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

package/session-tracker.ts

@@ -20,8 +20,10 @@ export interface SessionInfo {
   lastActivity: number
   /** 会话创建时间 */
   createdAt: number
-  /** 会话标题（用户输入的问题/任务描述） */
-  title?: string
+  /** 用户输入的问题/任务描述（创建时捕获） */
+  userPrompt?: string
+  /** opencode 自动生成的会话主题（session.updated 时更新） */
+  sessionTopic?: string
 }
 
 const CLEANUP_INTERVAL_MS = 5 * 60 * 1000  // 5 分钟
@@ -71,24 +73,45 @@ export class SessionTracker {
   }
 
   /** 注册新会话 */
-  register(sessionID: string, title?: string): void {
+  register(sessionID: string, userPrompt?: string): void {
     if (sessionID === "unknown") return
     const existing = this.sessions.get(sessionID)
     if (existing) {
-      if (title) existing.title = title
+      if (userPrompt) existing.userPrompt = userPrompt
     } else {
       this.sessions.set(sessionID, {
         sessionID,
         lastActivity: Date.now(),
         createdAt: Date.now(),
-        title,
+        userPrompt,
       })
     }
   }
 
-  /** 获取会话标题 */
-  getSessionTitle(sessionID: string): string | undefined {
-    return this.sessions.get(sessionID)?.title
+  /** 更新会话主题（opencode 自动生成，来自 session.updated） */
+  updateTopic(sessionID: string, topic: string): void {
+    if (sessionID === "unknown" || !topic) return
+    const existing = this.sessions.get(sessionID)
+    if (existing) {
+      existing.sessionTopic = topic
+    } else {
+      this.sessions.set(sessionID, {
+        sessionID,
+        lastActivity: Date.now(),
+        createdAt: Date.now(),
+        sessionTopic: topic,
+      })
+    }
+  }
+
+  /** 获取用户提示词 */
+  getUserPrompt(sessionID: string): string | undefined {
+    return this.sessions.get(sessionID)?.userPrompt
+  }
+
+  /** 获取会话主题 */
+  getSessionTopic(sessionID: string): string | undefined {
+    return this.sessions.get(sessionID)?.sessionTopic
   }
 
   /** 移除会话 */