@yoooclaw/phone-notifications 1.12.0 → 1.12.2

package/dist/bin/ntf.cjs

@@ -2592,6 +2592,34 @@ function readRecordingIndex(dir) {
     return [];
   }
 }
+function resolveImagesDir(ctx) {
+  if (ctx.stateDir) {
+    const dir = import_node_path4.join(ctx.stateDir, "plugins", "phone-notifications", "images");
+    if (import_node_fs3.existsSync(dir))
+      return dir;
+  }
+  if (ctx.workspaceDir) {
+    const dir = import_node_path4.join(ctx.workspaceDir, "images");
+    if (import_node_fs3.existsSync(dir))
+      return dir;
+  }
+  return null;
+}
+function readImageIndex(dir) {
+  const indexPath = import_node_path4.join(dir, "index.json");
+  if (!import_node_fs3.existsSync(indexPath))
+    return [];
+  try {
+    const raw = JSON.parse(import_node_fs3.readFileSync(indexPath, "utf-8"));
+    const images = Array.isArray(raw?.images) ? raw.images : [];
+    return images.sort((a, b) => b.metadata.created_at.localeCompare(a.metadata.created_at));
+  } catch {
+    return [];
+  }
+}
+function resolveImageFile(dir, relative) {
+  return import_node_path4.isAbsolute(relative) ? relative : import_node_path4.join(dir, relative);
+}
 
 // src/auth/credentials.ts
 var import_node_fs4 = require("node:fs");
@@ -2808,27 +2836,43 @@ function matchesNotificationQuery(item, opts) {
   return true;
 }
 async function collectMatchingNotifications(dir, opts) {
+  const result = await collectMatchingNotificationsWithStats(dir, opts);
+  return result.notifications;
+}
+async function collectMatchingNotificationsWithStats(dir, opts) {
   const keys = await listDateKeysAsync(dir);
   const results = [];
-  const canStopAfterLimit = opts.fromTs === null && opts.toTs === null;
+  const stats = {
+    daysScanned: 0,
+    itemsScanned: 0,
+    matched: 0,
+    stoppedAfterLimit: false
+  };
   for (const dateKey of keys) {
     if (opts.fromDateKey && dateKey < opts.fromDateKey)
       continue;
     if (opts.toDateKey && dateKey > opts.toDateKey)
       continue;
+    stats.daysScanned += 1;
     const items = sortNotificationsByTimestampDesc([
       ...await readDateFileAsync(dir, dateKey)
     ]);
     for (const item of items) {
+      stats.itemsScanned += 1;
       if (!matchesNotificationQuery(item, opts))
         continue;
+      stats.matched += 1;
       results.push(item);
-      if (canStopAfterLimit && results.length >= opts.limit) {
-        return results;
+      if (results.length >= opts.limit) {
+        stats.stoppedAfterLimit = true;
+        return { notifications: results, stats };
       }
     }
   }
-  return sortNotificationsByTimestampDesc(results).slice(0, opts.limit);
+  return {
+    notifications: sortNotificationsByTimestampDesc(results).slice(0, opts.limit),
+    stats
+  };
 }
 
 // src/cli/ntf-search.ts
@@ -2914,7 +2958,10 @@ function registerNtfSummary(ntf, ctx) {
     const sampleLimit = parsePositiveIntegerOption(opts.sample, 30, "--sample", "INVALID_SAMPLE");
     const topLimit = parsePositiveIntegerOption(opts.top, 10, "--top", "INVALID_TOP");
     const maxContent = parsePositiveIntegerOption(opts.maxContent, 80, "--max-content", "INVALID_MAX_CONTENT");
-    const notifications = await collectMatchingNotifications(dir, query);
+    const startedAtMs = Date.now();
+    const queryResult = await collectMatchingNotificationsWithStats(dir, query);
+    const elapsedMs = Date.now() - startedAtMs;
+    const { notifications, stats } = queryResult;
     const byApp = new Map;
     const bySender = new Map;
     const byConversation = new Map;
@@ -2946,6 +2993,13 @@ function registerNtfSummary(ntf, ctx) {
         newest: notifications[0]?.timestamp ?? null,
         oldest: notifications[notifications.length - 1]?.timestamp ?? null
       },
+      scan: {
+        daysScanned: stats.daysScanned,
+        itemsScanned: stats.itemsScanned,
+        matched: stats.matched,
+        stoppedAfterLimit: stats.stoppedAfterLimit,
+        elapsedMs
+      },
       byApp: topRows(byApp, topLimit),
       bySender: senderRows,
       byConversation: topRows(byConversation, topLimit),
@@ -2956,6 +3010,555 @@ function registerNtfSummary(ntf, ctx) {
   });
 }
 
+// src/cli/ntf-summary-job.ts
+var import_node_crypto = require("node:crypto");
+var import_node_fs6 = require("node:fs");
+var import_node_path6 = require("node:path");
+var SUMMARY_ROOT = ".summaries";
+var JOBS_DIR = "jobs";
+var CHUNKS_DIR = "chunks";
+var SUMMARIES_DIR = "summaries";
+var RESULT_FILE = "result.md";
+var DEFAULT_JOB_LIMIT = 1000;
+var DEFAULT_CHUNK_SIZE = 150;
+var DEFAULT_MAX_CONTENT = 120;
+var DEFAULT_RUN_MAX_CHUNKS = 20;
+var ATTENTION_KEYWORDS = [
+  "待办",
+  "需要",
+  "麻烦",
+  "确认",
+  "回复",
+  "审批",
+  "开会",
+  "会议",
+  "安排",
+  "截止",
+  "紧急",
+  "异常",
+  "失败",
+  "风险",
+  "todo",
+  "deadline",
+  "urgent",
+  "error",
+  "failed"
+];
+function truncate2(value, maxLength = 120) {
+  if (value.length <= maxLength)
+    return value;
+  return `${value.slice(0, maxLength - 1)}…`;
+}
+function compactNotification2(item, maxContent) {
+  const result = {
+    appName: item.appName,
+    title: truncate2(item.title, maxContent),
+    content: truncate2(item.content, maxContent),
+    timestamp: item.timestamp
+  };
+  if (item.appDisplayName)
+    result.appDisplayName = item.appDisplayName;
+  if (item.senderName)
+    result.senderName = item.senderName;
+  if (item.conversationType)
+    result.conversationType = item.conversationType;
+  if (item.conversationName)
+    result.conversationName = item.conversationName;
+  return result;
+}
+function notificationSender(item) {
+  return item.senderName?.trim() || item.conversationName?.trim() || item.title.trim() || "(unknown)";
+}
+function notificationApp(item) {
+  return item.appDisplayName?.trim() || item.appName.trim() || "(unknown)";
+}
+function increment2(map, key, seed) {
+  const existing = map.get(key);
+  if (existing) {
+    existing.count += 1;
+    return;
+  }
+  map.set(key, { ...seed, count: 1 });
+}
+function topRows2(map, limit) {
+  return [...map.values()].sort((a, b) => b.count - a.count).slice(0, limit);
+}
+function formatTopRows(rows, labelKey) {
+  if (rows.length === 0)
+    return "无";
+  return rows.map((row) => `${String(row[labelKey])} ${row.count}`).join("；");
+}
+function compactLine(item) {
+  const app = notificationApp(item);
+  const sender = notificationSender(item);
+  return `[${item.timestamp}] ${app} · ${sender}: ${item.content}`;
+}
+function isAttentionCandidate(item) {
+  const text = `${item.title}
+${item.content}`.toLowerCase();
+  return ATTENTION_KEYWORDS.some((keyword) => text.includes(keyword.toLowerCase()));
+}
+function buildExtractiveChunkSummary(chunk, notifications) {
+  const byApp = new Map;
+  const bySender = new Map;
+  for (const item of notifications) {
+    const app = notificationApp(item);
+    const sender = notificationSender(item);
+    increment2(byApp, app, { app });
+    increment2(bySender, sender, { sender });
+  }
+  const latest = notifications.slice(0, 5).map(compactLine);
+  const attention = notifications.filter(isAttentionCandidate).slice(0, 5).map(compactLine);
+  const lines = [
+    `## 分片 ${chunk.id}`,
+    "",
+    `- 数量: ${chunk.count}`,
+    `- 时间范围: ${chunk.range.oldest ?? "-"} 至 ${chunk.range.newest ?? "-"}`,
+    `- 主要 App: ${formatTopRows(topRows2(byApp, 5), "app")}`,
+    `- 主要发送人/会话: ${formatTopRows(topRows2(bySender, 8), "sender")}`,
+    "",
+    "### 可能需要关注",
+    ...attention.length > 0 ? attention.map((line) => `- ${line}`) : ["- 无明显待办、风险或异常样例"],
+    "",
+    "### 最近样例",
+    ...latest.length > 0 ? latest.map((line) => `- ${line}`) : ["- 无"],
+    ""
+  ];
+  return lines.join(`
+`).trimEnd() + `
+`;
+}
+function nowIso() {
+  return new Date().toISOString();
+}
+function createJobId() {
+  const stamp = new Date().toISOString().replace(/[-:.TZ]/g, "").slice(0, 14);
+  return `${stamp}-${import_node_crypto.randomUUID().slice(0, 8)}`;
+}
+function assertJobId(id) {
+  if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,100}$/.test(id)) {
+    exitError("INVALID_JOB_ID", "summary job id 不合法");
+  }
+}
+function summaryJobsDir(notificationsDir) {
+  return import_node_path6.join(notificationsDir, SUMMARY_ROOT, JOBS_DIR);
+}
+function summaryJobDir(notificationsDir, id) {
+  assertJobId(id);
+  return import_node_path6.join(summaryJobsDir(notificationsDir), id);
+}
+function metaPath(jobDir) {
+  return import_node_path6.join(jobDir, "meta.json");
+}
+function chunkPath(jobDir, chunkId) {
+  return import_node_path6.join(jobDir, CHUNKS_DIR, `${chunkId}.json`);
+}
+function writeJson(path, value) {
+  import_node_fs6.writeFileSync(path, JSON.stringify(value, null, 2), "utf-8");
+}
+function readJson(path) {
+  try {
+    return JSON.parse(import_node_fs6.readFileSync(path, "utf-8"));
+  } catch {
+    exitError("READ_FAILED", `无法读取 JSON: ${path}`);
+  }
+}
+function readMeta(notificationsDir, id) {
+  const dir = summaryJobDir(notificationsDir, id);
+  const path = metaPath(dir);
+  if (!import_node_fs6.existsSync(path)) {
+    exitError("JOB_NOT_FOUND", `summary job 不存在: ${id}`);
+  }
+  const meta = readJson(path);
+  if (!isSummaryJobMeta(meta)) {
+    exitError("INVALID_JOB", `summary job 元数据损坏: ${id}`);
+  }
+  return meta;
+}
+function saveMeta(notificationsDir, meta) {
+  meta.updatedAt = nowIso();
+  writeJson(metaPath(summaryJobDir(notificationsDir, meta.id)), meta);
+}
+function isSummaryJobMeta(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const obj = value;
+  return obj.schemaVersion === 1 && typeof obj.id === "string" && Array.isArray(obj.chunks) && typeof obj.total === "number";
+}
+function refreshStatus(meta) {
+  if (meta.status === "cancelled" || meta.status === "complete") {
+    return meta.status;
+  }
+  if (meta.chunks.every((chunk) => chunk.status === "done")) {
+    return "ready";
+  }
+  if (meta.chunks.some((chunk) => chunk.status === "in_progress")) {
+    return "in_progress";
+  }
+  return "pending";
+}
+function progressFor(meta) {
+  const doneChunks = meta.chunks.filter((chunk) => chunk.status === "done");
+  const doneNotifications = doneChunks.reduce((sum, chunk) => sum + chunk.count, 0);
+  return {
+    totalChunks: meta.chunks.length,
+    doneChunks: doneChunks.length,
+    totalNotifications: meta.total,
+    doneNotifications,
+    remainingChunks: meta.chunks.length - doneChunks.length
+  };
+}
+function toPublicStatus(meta) {
+  return {
+    ok: true,
+    id: meta.id,
+    status: meta.status,
+    createdAt: meta.createdAt,
+    updatedAt: meta.updatedAt,
+    query: meta.query,
+    total: meta.total,
+    chunkSize: meta.chunkSize,
+    range: meta.range,
+    scan: meta.scan,
+    progress: progressFor(meta),
+    resultFile: meta.resultFile ?? null,
+    chunks: meta.chunks.map((chunk) => ({
+      id: chunk.id,
+      index: chunk.index,
+      count: chunk.count,
+      status: chunk.status,
+      range: chunk.range,
+      summaryFile: chunk.summaryFile ?? null
+    }))
+  };
+}
+function readChunkNotifications(jobDir, chunkId) {
+  const chunk = readJson(chunkPath(jobDir, chunkId));
+  if (!chunk || typeof chunk !== "object" || !Array.isArray(chunk.notifications)) {
+    exitError("INVALID_CHUNK", `summary job 分片损坏: ${chunkId}`);
+  }
+  return chunk.notifications;
+}
+function buildCommitCommand(jobId, chunkId) {
+  return `ntf summary-job commit ${jobId} --chunk-id ${chunkId} --summary-file <path>`;
+}
+function buildResultCommand(jobId) {
+  return `ntf summary-job result ${jobId}`;
+}
+function resolveSummaryText(opts) {
+  const hasSummary = typeof opts.summary === "string" && opts.summary.length > 0;
+  const hasSummaryFile = typeof opts.summaryFile === "string" && opts.summaryFile.length > 0;
+  if (hasSummary && hasSummaryFile) {
+    exitError("INVALID_COMMIT", "--summary 和 --summary-file 只能二选一");
+  }
+  if (!hasSummary && !hasSummaryFile) {
+    exitError("INVALID_COMMIT", "必须提供 --summary 或 --summary-file");
+  }
+  const text = hasSummary ? opts.summary : import_node_fs6.readFileSync(import_node_path6.resolve(opts.summaryFile), "utf-8");
+  if (!text.trim()) {
+    exitError("INVALID_COMMIT", "分片摘要不能为空");
+  }
+  return text.trimEnd() + `
+`;
+}
+function buildResultMarkdown(meta, jobDir) {
+  const lines = [
+    `# 通知总结任务 ${meta.id}`,
+    "",
+    `- 通知数: ${meta.total}`,
+    `- 时间范围: ${meta.range.oldest ?? "-"} 至 ${meta.range.newest ?? "-"}`,
+    `- 分片数: ${meta.chunks.length}`,
+    "",
+    "## 分片摘要",
+    ""
+  ];
+  for (const chunk of meta.chunks) {
+    lines.push(`### ${chunk.id} · ${chunk.count} 条 · ${chunk.range.oldest ?? "-"} 至 ${chunk.range.newest ?? "-"}`, "");
+    if (!chunk.summaryFile) {
+      lines.push("(未提交摘要)", "");
+      continue;
+    }
+    lines.push(import_node_fs6.readFileSync(import_node_path6.join(jobDir, chunk.summaryFile), "utf-8").trim(), "");
+  }
+  return lines.join(`
+`).trimEnd() + `
+`;
+}
+function writeChunkSummary(notificationsDir, meta, chunk, text) {
+  const jobDir = summaryJobDir(notificationsDir, meta.id);
+  const relativeSummaryFile = import_node_path6.join(SUMMARIES_DIR, `${chunk.id}.md`);
+  import_node_fs6.writeFileSync(import_node_path6.join(jobDir, relativeSummaryFile), text, "utf-8");
+  chunk.status = "done";
+  chunk.completedAt = nowIso();
+  chunk.summaryFile = relativeSummaryFile;
+}
+function finalizeResultIfReady(notificationsDir, meta) {
+  meta.status = refreshStatus(meta);
+  if (meta.status !== "ready" && meta.status !== "complete") {
+    return null;
+  }
+  const jobDir = summaryJobDir(notificationsDir, meta.id);
+  const markdown = buildResultMarkdown(meta, jobDir);
+  import_node_fs6.writeFileSync(import_node_path6.join(jobDir, RESULT_FILE), markdown, "utf-8");
+  meta.status = "complete";
+  meta.resultFile = RESULT_FILE;
+  return markdown;
+}
+function registerNtfSummaryJob(ntf, ctx) {
+  const summaryJob = ntf.command("summary-job").description("分片通知总结任务管理");
+  summaryJob.command("create").description("创建分片通知总结任务").option("--from <time>", "开始时间 ISO 8601").option("--to <time>", "结束时间 ISO 8601").option("--app <name>", "按应用名过滤").option("--sender <name>", "按发送人过滤").option("--conversation-type <type>", "按会话类型过滤（group/private）").option("--keyword <text>", "在标题和内容中搜索关键词").option("--limit <n>", "纳入任务的最大通知条数", String(DEFAULT_JOB_LIMIT)).option("--chunk-size <n>", "每个分片的通知条数", String(DEFAULT_CHUNK_SIZE)).option("--max-content <n>", "分片中单条通知标题/正文最大字数", String(DEFAULT_MAX_CONTENT)).action(async (opts) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "通知存储目录不可用");
+    progress("正在创建分片通知总结任务...");
+    const query = parseNotificationQueryOptions(opts, DEFAULT_JOB_LIMIT);
+    const chunkSize = parsePositiveIntegerOption(opts.chunkSize, DEFAULT_CHUNK_SIZE, "--chunk-size", "INVALID_CHUNK_SIZE");
+    const maxContent = parsePositiveIntegerOption(opts.maxContent, DEFAULT_MAX_CONTENT, "--max-content", "INVALID_MAX_CONTENT");
+    const startedAtMs = Date.now();
+    const queryResult = await collectMatchingNotificationsWithStats(dir, query);
+    const elapsedMs = Date.now() - startedAtMs;
+    const notifications = queryResult.notifications;
+    const id = createJobId();
+    const createdAt = nowIso();
+    const jobDir = summaryJobDir(dir, id);
+    import_node_fs6.mkdirSync(import_node_path6.join(jobDir, CHUNKS_DIR), { recursive: true });
+    import_node_fs6.mkdirSync(import_node_path6.join(jobDir, SUMMARIES_DIR), { recursive: true });
+    const chunks = [];
+    for (let start = 0;start < notifications.length; start += chunkSize) {
+      const rawChunk = notifications.slice(start, start + chunkSize);
+      const chunkNotifications = rawChunk.map((item) => compactNotification2(item, maxContent));
+      const index = chunks.length;
+      const chunkId = String(index + 1).padStart(4, "0");
+      const end = start + chunkNotifications.length - 1;
+      writeJson(chunkPath(jobDir, chunkId), {
+        id: chunkId,
+        index,
+        start,
+        end,
+        notifications: chunkNotifications
+      });
+      chunks.push({
+        id: chunkId,
+        index,
+        start,
+        end,
+        count: chunkNotifications.length,
+        status: "pending",
+        range: {
+          newest: chunkNotifications[0]?.timestamp ?? null,
+          oldest: chunkNotifications[chunkNotifications.length - 1]?.timestamp ?? null
+        }
+      });
+    }
+    const meta = {
+      schemaVersion: 1,
+      id,
+      status: chunks.length === 0 ? "ready" : "pending",
+      createdAt,
+      updatedAt: createdAt,
+      query: {
+        ...query.from ? { from: query.from } : {},
+        ...query.to ? { to: query.to } : {},
+        ...query.app ? { app: query.app } : {},
+        ...query.sender ? { sender: query.sender } : {},
+        ...query.conversationType ? { conversationType: query.conversationType } : {},
+        ...query.keyword ? { keyword: query.keyword } : {},
+        limit: query.limit
+      },
+      chunkSize,
+      maxContent,
+      total: notifications.length,
+      range: {
+        newest: notifications[0]?.timestamp ?? null,
+        oldest: notifications[notifications.length - 1]?.timestamp ?? null
+      },
+      scan: {
+        daysScanned: queryResult.stats.daysScanned,
+        itemsScanned: queryResult.stats.itemsScanned,
+        matched: queryResult.stats.matched,
+        stoppedAfterLimit: queryResult.stats.stoppedAfterLimit,
+        elapsedMs
+      },
+      chunks
+    };
+    writeJson(metaPath(jobDir), meta);
+    output({
+      ...toPublicStatus(meta),
+      nextCommand: `ntf summary-job next ${id}`,
+      resultCommand: buildResultCommand(id)
+    });
+  });
+  summaryJob.command("status <id>").description("查看分片通知总结任务状态").action((id) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "通知存储目录不可用");
+    const meta = readMeta(dir, id);
+    meta.status = refreshStatus(meta);
+    saveMeta(dir, meta);
+    output(toPublicStatus(meta));
+  });
+  summaryJob.command("next <id>").description("领取或重试下一个待总结分片").action((id) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "通知存储目录不可用");
+    const meta = readMeta(dir, id);
+    if (meta.status === "cancelled") {
+      exitError("JOB_CANCELLED", `summary job 已取消: ${id}`);
+    }
+    const jobDir = summaryJobDir(dir, id);
+    let chunk = meta.chunks.find((item) => item.status === "in_progress");
+    if (!chunk) {
+      chunk = meta.chunks.find((item) => item.status === "pending");
+      if (chunk) {
+        chunk.status = "in_progress";
+        chunk.claimedAt = nowIso();
+      }
+    }
+    if (!chunk) {
+      meta.status = refreshStatus(meta);
+      saveMeta(dir, meta);
+      output({
+        ok: true,
+        id,
+        done: true,
+        status: meta.status,
+        progress: progressFor(meta),
+        resultCommand: buildResultCommand(id)
+      });
+      return;
+    }
+    meta.status = refreshStatus(meta);
+    saveMeta(dir, meta);
+    output({
+      ok: true,
+      id,
+      done: false,
+      status: meta.status,
+      chunk: {
+        id: chunk.id,
+        index: chunk.index,
+        start: chunk.start,
+        end: chunk.end,
+        count: chunk.count,
+        range: chunk.range
+      },
+      progress: progressFor(meta),
+      commitCommand: buildCommitCommand(id, chunk.id),
+      notifications: readChunkNotifications(jobDir, chunk.id)
+    });
+  });
+  summaryJob.command("commit <id>").description("提交分片摘要并标记分片完成").requiredOption("--chunk-id <id>", "next 返回的分片 id").option("--summary <text>", "直接传入分片摘要文本").option("--summary-file <path>", "读取文件内容作为分片摘要").action((id, opts) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "通知存储目录不可用");
+    const meta = readMeta(dir, id);
+    if (meta.status === "cancelled") {
+      exitError("JOB_CANCELLED", `summary job 已取消: ${id}`);
+    }
+    const chunk = meta.chunks.find((item) => item.id === opts.chunkId);
+    if (!chunk) {
+      exitError("CHUNK_NOT_FOUND", `summary job 分片不存在: ${opts.chunkId}`);
+    }
+    const text = resolveSummaryText(opts);
+    writeChunkSummary(dir, meta, chunk, text);
+    meta.status = refreshStatus(meta);
+    saveMeta(dir, meta);
+    output({
+      ok: true,
+      id,
+      chunkId: chunk.id,
+      status: meta.status,
+      progress: progressFor(meta),
+      nextCommand: meta.status === "ready" ? null : `ntf summary-job next ${id}`,
+      resultCommand: meta.status === "ready" ? buildResultCommand(id) : null
+    });
+  });
+  summaryJob.command("run <id>").description("自动处理待总结分片并在完成后生成结果").option("--max-chunks <n>", "本次最多自动处理的分片数", String(DEFAULT_RUN_MAX_CHUNKS)).option("--include-result", "完成时在输出中包含 markdown 结果").action((id, opts) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "通知存储目录不可用");
+    const meta = readMeta(dir, id);
+    if (meta.status === "cancelled") {
+      exitError("JOB_CANCELLED", `summary job 已取消: ${id}`);
+    }
+    const maxChunks = parsePositiveIntegerOption(opts.maxChunks, DEFAULT_RUN_MAX_CHUNKS, "--max-chunks", "INVALID_MAX_CHUNKS");
+    const jobDir = summaryJobDir(dir, id);
+    const processed = [];
+    for (const chunk of meta.chunks) {
+      if (processed.length >= maxChunks)
+        break;
+      if (chunk.status === "done")
+        continue;
+      chunk.status = "in_progress";
+      chunk.claimedAt = nowIso();
+      const notifications = readChunkNotifications(jobDir, chunk.id);
+      const summary = buildExtractiveChunkSummary(chunk, notifications);
+      writeChunkSummary(dir, meta, chunk, summary);
+      processed.push({ chunkId: chunk.id, count: chunk.count });
+    }
+    const markdown = finalizeResultIfReady(dir, meta);
+    if (!markdown) {
+      meta.status = refreshStatus(meta);
+    }
+    saveMeta(dir, meta);
+    output({
+      ok: true,
+      id,
+      status: meta.status,
+      processed,
+      progress: progressFor(meta),
+      nextCommand: meta.status === "complete" ? null : `ntf summary-job run ${id}`,
+      resultCommand: meta.status === "complete" ? buildResultCommand(id) : null,
+      resultFile: meta.resultFile ?? null,
+      ...opts.includeResult && markdown ? { markdown } : {}
+    });
+  });
+  summaryJob.command("result <id>").description("合并已提交的分片摘要并返回结果").action((id) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "通知存储目录不可用");
+    const meta = readMeta(dir, id);
+    meta.status = refreshStatus(meta);
+    if (meta.status !== "ready" && meta.status !== "complete") {
+      saveMeta(dir, meta);
+      output({
+        ok: true,
+        id,
+        done: false,
+        status: meta.status,
+        progress: progressFor(meta),
+        nextCommand: `ntf summary-job next ${id}`
+      });
+      return;
+    }
+    const jobDir = summaryJobDir(dir, id);
+    const markdown = finalizeResultIfReady(dir, meta) ?? buildResultMarkdown(meta, jobDir);
+    saveMeta(dir, meta);
+    output({
+      ok: true,
+      id,
+      done: true,
+      status: meta.status,
+      resultFile: RESULT_FILE,
+      markdown
+    });
+  });
+  summaryJob.command("cancel <id>").description("取消分片通知总结任务").action((id) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "通知存储目录不可用");
+    const meta = readMeta(dir, id);
+    meta.status = "cancelled";
+    saveMeta(dir, meta);
+    output({
+      ok: true,
+      id,
+      status: meta.status,
+      progress: progressFor(meta)
+    });
+  });
+}
+
 // src/cli/ntf-stats.ts
 function registerNtfStats(ntf, ctx) {
   ntf.command("stats").description("通知统计分析（按日期/应用/发送人/时段聚合）").option("--from <date>", "开始日期 YYYY-MM-DD", daysAgo(7)).option("--to <date>", "结束日期 YYYY-MM-DD", today()).option("--app <name>", "只统计指定应用").option("--dim <dimension>", "统计维度：date/app/sender/hour/all", "all").action((opts) => {
@@ -3013,24 +3616,25 @@ function registerNtfStats(ntf, ctx) {
 }
 
 // src/cli/ntf-sync.ts
-var import_node_fs6 = require("node:fs");
-var import_node_path6 = require("node:path");
+var import_node_child_process = require("node:child_process");
+var import_node_fs7 = require("node:fs");
+var import_node_path7 = require("node:path");
 var SYNC_FETCH_LIMIT = 100;
 function checkpointPath(dir) {
-  return import_node_path6.join(dir, ".checkpoint.json");
+  return import_node_path7.join(dir, ".checkpoint.json");
 }
 function readCheckpoint(dir) {
   const p = checkpointPath(dir);
-  if (!import_node_fs6.existsSync(p))
+  if (!import_node_fs7.existsSync(p))
     return {};
   try {
-    return JSON.parse(import_node_fs6.readFileSync(p, "utf-8"));
+    return JSON.parse(import_node_fs7.readFileSync(p, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeCheckpoint(dir, data) {
-  import_node_fs6.writeFileSync(checkpointPath(dir), JSON.stringify(data, null, 2), "utf-8");
+  import_node_fs7.writeFileSync(checkpointPath(dir), JSON.stringify(data, null, 2), "utf-8");
 }
 function validateDateKey(value, optionName) {
   const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
@@ -3081,6 +3685,28 @@ function isDateInScope(dateKey, scope) {
     return false;
   return true;
 }
+var MEMORY_PLUGIN_KEYWORD = "memory-lancedb-ultra";
+function detectMemoryBackend() {
+  try {
+    const out = import_node_child_process.execFileSync("openclaw", ["plugins", "list"], {
+      encoding: "utf-8",
+      timeout: 15000,
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    const matched = out.split(`
+`).filter((line) => line.toLowerCase().includes(MEMORY_PLUGIN_KEYWORD));
+    if (matched.length > 0 && !matched.some((line) => /disabled/i.test(line))) {
+      return {
+        backend: "lancedb-plugin",
+        promptFile: "skills/notification-to-memory/references/write-memory-lancedb-plugin.md"
+      };
+    }
+  } catch {}
+  return {
+    backend: "openclaw-native",
+    promptFile: "skills/notification-to-memory/references/write-memory-openclaw-native.md"
+  };
+}
 function registerNtfSync(ntf, ctx) {
   const sync = ntf.command("sync").description("同步通知到记忆系统");
   sync.command("scan").description("扫描未处理的通知，默认只返回本地当天的待同步摘要").option("--all", "扫描 checkpoint 之后所有日期的未处理通知").option("--date <date>", "只扫描指定日期 YYYY-MM-DD").option("--from-date <date>", "只扫描该日期及之后的数据 YYYY-MM-DD").option("--to-date <date>", "只扫描该日期及之前的数据 YYYY-MM-DD").action((opts) => {
@@ -3117,6 +3743,67 @@ function registerNtfSync(ntf, ctx) {
       allDatesTotalPending: totalPending + outsideScopePending
     });
   });
+  sync.command("next").description("返回范围内下一批待同步通知（≤100 条）及记忆写入提示词路径；全部处理完时返回 done=true").option("--all", "处理 checkpoint 之后所有日期的未处理通知").option("--date <date>", "只处理指定日期 YYYY-MM-DD").option("--from-date <date>", "只处理该日期及之后的数据 YYYY-MM-DD").option("--to-date <date>", "只处理该日期及之前的数据 YYYY-MM-DD").action((opts) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "通知存储目录不可用");
+    const scope = resolveScanScope(opts);
+    const checkpoint = readCheckpoint(dir);
+    const keys = listDateKeys(dir);
+    let totalPending = 0;
+    let outsideScopePending = 0;
+    let nextDate = null;
+    let nextItems = [];
+    let nextStartIndex = 0;
+    for (const dateKey of keys) {
+      const items = readDateFile(dir, dateKey);
+      const lastIndex = checkpoint[dateKey]?.lastIndex ?? -1;
+      const unprocessed = items.length - (lastIndex + 1);
+      if (unprocessed <= 0)
+        continue;
+      if (!isDateInScope(dateKey, scope)) {
+        outsideScopePending += unprocessed;
+        continue;
+      }
+      totalPending += unprocessed;
+      if (!nextDate) {
+        nextDate = dateKey;
+        nextItems = items;
+        nextStartIndex = lastIndex + 1;
+      }
+    }
+    if (!nextDate) {
+      output({
+        ok: true,
+        done: true,
+        scope,
+        totalPending: 0,
+        outsideScopePending,
+        allDatesTotalPending: outsideScopePending
+      });
+      return;
+    }
+    const notifications = nextItems.slice(nextStartIndex, nextStartIndex + SYNC_FETCH_LIMIT);
+    const endIndex = nextStartIndex + notifications.length - 1;
+    const unprocessedInDate = nextItems.length - nextStartIndex;
+    const memory = detectMemoryBackend();
+    output({
+      ok: true,
+      done: false,
+      scope,
+      date: nextDate,
+      startIndex: nextStartIndex,
+      endIndex,
+      returned: notifications.length,
+      hasMoreInDate: unprocessedInDate > notifications.length,
+      remainingInScope: totalPending - notifications.length,
+      outsideScopePending,
+      memoryBackend: memory.backend,
+      memoryPromptFile: memory.promptFile,
+      commitCommand: `ntf sync commit --date ${nextDate} --end-index ${endIndex}`,
+      notifications
+    });
+  });
   sync.command("fetch").description("获取指定日期的未处理通知详情").requiredOption("--date <date>", "目标日期 YYYY-MM-DD").option("--max-end-index <index>", "本次同步快照允许读取的最大 endIndex").action((opts) => {
     const dir = resolveNotificationsDir(ctx);
     if (!dir)
@@ -3218,8 +3905,8 @@ function registerNtfSync(ntf, ctx) {
 }
 
 // src/cli/ntf-monitor.ts
-var import_node_fs7 = require("node:fs");
-var import_node_path7 = require("node:path");
+var import_node_fs8 = require("node:fs");
+var import_node_path8 = require("node:path");
 
 // src/monitor/fetch-gen.ts
 function generateFetchPy(name, matchRules) {
@@ -3306,20 +3993,20 @@ function tasksDir(ctx) {
   const base = ctx.workspaceDir || ctx.stateDir;
   if (!base)
     throw new Error("workspaceDir and stateDir both unavailable");
-  return import_node_path7.join(base, "tasks");
+  return import_node_path8.join(base, "tasks");
 }
-function readMeta(taskDir) {
-  const metaPath = import_node_path7.join(taskDir, "meta.json");
-  if (!import_node_fs7.existsSync(metaPath))
+function readMeta2(taskDir) {
+  const metaPath2 = import_node_path8.join(taskDir, "meta.json");
+  if (!import_node_fs8.existsSync(metaPath2))
     return null;
   try {
-    return JSON.parse(import_node_fs7.readFileSync(metaPath, "utf-8"));
+    return JSON.parse(import_node_fs8.readFileSync(metaPath2, "utf-8"));
   } catch {
     return null;
   }
 }
 function writeMeta(taskDir, meta) {
-  import_node_fs7.writeFileSync(import_node_path7.join(taskDir, "meta.json"), JSON.stringify(meta, null, 2), "utf-8");
+  import_node_fs8.writeFileSync(import_node_path8.join(taskDir, "meta.json"), JSON.stringify(meta, null, 2), "utf-8");
 }
 function generateReadme(name, description) {
   return `# Monitor Task: ${name}
@@ -3338,30 +4025,30 @@ function registerNtfMonitor(ntf, ctx) {
   const monitor = ntf.command("monitor").description("通知监控任务管理");
   monitor.command("list").description("列出所有监控任务").action(() => {
     const dir = tasksDir(ctx);
-    if (!import_node_fs7.existsSync(dir)) {
+    if (!import_node_fs8.existsSync(dir)) {
       output({ ok: true, tasks: [] });
       return;
     }
     const tasks = [];
-    for (const entry of import_node_fs7.readdirSync(dir, { withFileTypes: true })) {
+    for (const entry of import_node_fs8.readdirSync(dir, { withFileTypes: true })) {
       if (!entry.isDirectory())
         continue;
-      const meta = readMeta(import_node_path7.join(dir, entry.name));
+      const meta = readMeta2(import_node_path8.join(dir, entry.name));
       if (meta)
         tasks.push(meta);
     }
     output({ ok: true, tasks });
   });
   monitor.command("show <name>").description("查看监控任务详情").action((name) => {
-    const taskDir = import_node_path7.join(tasksDir(ctx), name);
-    const meta = readMeta(taskDir);
+    const taskDir = import_node_path8.join(tasksDir(ctx), name);
+    const meta = readMeta2(taskDir);
     if (!meta)
       exitError("NOT_FOUND", `监控任务 '${name}' 不存在`);
-    const checkpointPath2 = import_node_path7.join(taskDir, "checkpoint.json");
+    const checkpointPath2 = import_node_path8.join(taskDir, "checkpoint.json");
     let checkpoint = {};
-    if (import_node_fs7.existsSync(checkpointPath2)) {
+    if (import_node_fs8.existsSync(checkpointPath2)) {
       try {
-        checkpoint = JSON.parse(import_node_fs7.readFileSync(checkpointPath2, "utf-8"));
+        checkpoint = JSON.parse(import_node_fs8.readFileSync(checkpointPath2, "utf-8"));
       } catch {}
     }
     output({
@@ -3374,8 +4061,8 @@ function registerNtfMonitor(ntf, ctx) {
   });
   monitor.command("create <name>").description("创建监控任务").requiredOption("--description <text>", "任务描述").requiredOption("--match-rules <json>", "匹配规则 JSON").requiredOption("--schedule <cron>", "cron 表达式").action((name, opts) => {
     const dir = tasksDir(ctx);
-    const taskDir = import_node_path7.join(dir, name);
-    if (import_node_fs7.existsSync(taskDir)) {
+    const taskDir = import_node_path8.join(dir, name);
+    if (import_node_fs8.existsSync(taskDir)) {
       exitError("ALREADY_EXISTS", `监控任务 '${name}' 已存在`);
     }
     let matchRules;
@@ -3384,7 +4071,7 @@ function registerNtfMonitor(ntf, ctx) {
     } catch {
       exitError("VALIDATION_FAILED", "match-rules 必须是合法的 JSON");
     }
-    import_node_fs7.mkdirSync(taskDir, { recursive: true });
+    import_node_fs8.mkdirSync(taskDir, { recursive: true });
     const meta = {
       name,
       description: opts.description,
@@ -3394,8 +4081,8 @@ function registerNtfMonitor(ntf, ctx) {
       createdAt: new Date().toISOString()
     };
     writeMeta(taskDir, meta);
-    import_node_fs7.writeFileSync(import_node_path7.join(taskDir, "fetch.py"), generateFetchPy(name, matchRules), "utf-8");
-    import_node_fs7.writeFileSync(import_node_path7.join(taskDir, "README.md"), generateReadme(name, opts.description), "utf-8");
+    import_node_fs8.writeFileSync(import_node_path8.join(taskDir, "fetch.py"), generateFetchPy(name, matchRules), "utf-8");
+    import_node_fs8.writeFileSync(import_node_path8.join(taskDir, "README.md"), generateReadme(name, opts.description), "utf-8");
     output({
       ok: true,
       name,
@@ -3419,8 +4106,8 @@ function registerNtfMonitor(ntf, ctx) {
     });
   });
   monitor.command("delete <name>").description("删除监控任务").option("--yes", "跳过确认").action((name, opts) => {
-    const taskDir = import_node_path7.join(tasksDir(ctx), name);
-    if (!import_node_fs7.existsSync(taskDir)) {
+    const taskDir = import_node_path8.join(tasksDir(ctx), name);
+    if (!import_node_fs8.existsSync(taskDir)) {
       exitError("NOT_FOUND", `监控任务 '${name}' 不存在`);
     }
     if (!opts.yes) {
@@ -3433,7 +4120,7 @@ function registerNtfMonitor(ntf, ctx) {
       });
       process.exit(1);
     }
-    import_node_fs7.rmSync(taskDir, { recursive: true, force: true });
+    import_node_fs8.rmSync(taskDir, { recursive: true, force: true });
     output({
       ok: true,
       name,
@@ -3445,8 +4132,8 @@ function registerNtfMonitor(ntf, ctx) {
     });
   });
   monitor.command("enable <name>").description("启用监控任务").action((name) => {
-    const taskDir = import_node_path7.join(tasksDir(ctx), name);
-    const meta = readMeta(taskDir);
+    const taskDir = import_node_path8.join(tasksDir(ctx), name);
+    const meta = readMeta2(taskDir);
     if (!meta)
       exitError("NOT_FOUND", `监控任务 '${name}' 不存在`);
     meta.enabled = true;
@@ -3454,8 +4141,8 @@ function registerNtfMonitor(ntf, ctx) {
     output({ ok: true, name, enabled: true });
   });
   monitor.command("disable <name>").description("暂停监控任务").action((name) => {
-    const taskDir = import_node_path7.join(tasksDir(ctx), name);
-    const meta = readMeta(taskDir);
+    const taskDir = import_node_path8.join(tasksDir(ctx), name);
+    const meta = readMeta2(taskDir);
     if (!meta)
       exitError("NOT_FOUND", `监控任务 '${name}' 不存在`);
     meta.enabled = false;
@@ -3465,7 +4152,7 @@ function registerNtfMonitor(ntf, ctx) {
 }
 
 // src/light/sender.ts
-var import_node_crypto2 = require("node:crypto");
+var import_node_crypto3 = require("node:crypto");
 
 // src/light/repeat.ts
 function normalizeRepeatTimes(input) {
@@ -3971,9 +4658,9 @@ function quantizeWindow(value) {
 }
 
 // src/env.ts
-var import_node_crypto = require("node:crypto");
-var import_node_fs8 = require("node:fs");
-var import_node_path8 = require("node:path");
+var import_node_crypto2 = require("node:crypto");
+var import_node_fs9 = require("node:fs");
+var import_node_path9 = require("node:path");
 function parseEnvContent(content) {
   const entries = new Map;
   const tokens = content.split(/\r?\n/).flatMap((line) => line.split(/(?<![A-Z0-9_])(?=[A-Z_][A-Z0-9_]*=)/));
@@ -3993,20 +4680,20 @@ function parseEnvContent(content) {
 }
 function writeDotEnv(key, value) {
   const path = resolveStateFile(".env");
-  import_node_fs8.mkdirSync(import_node_path8.dirname(path), { recursive: true });
-  const existing = import_node_fs8.existsSync(path) ? import_node_fs8.readFileSync(path, "utf-8") : "";
+  import_node_fs9.mkdirSync(import_node_path9.dirname(path), { recursive: true });
+  const existing = import_node_fs9.existsSync(path) ? import_node_fs9.readFileSync(path, "utf-8") : "";
   const entries = parseEnvContent(existing);
   entries.set(key, value);
   const output2 = Array.from(entries, ([k, v]) => `${k}=${v}`).join(`
 `) + `
 `;
-  const tmpPath = `${path}.tmp.${process.pid}.${import_node_crypto.randomBytes(4).toString("hex")}`;
+  const tmpPath = `${path}.tmp.${process.pid}.${import_node_crypto2.randomBytes(4).toString("hex")}`;
   try {
-    import_node_fs8.writeFileSync(tmpPath, output2, { encoding: "utf-8", mode: 384 });
-    import_node_fs8.renameSync(tmpPath, path);
+    import_node_fs9.writeFileSync(tmpPath, output2, { encoding: "utf-8", mode: 384 });
+    import_node_fs9.renameSync(tmpPath, path);
   } catch (error) {
     try {
-      import_node_fs8.rmSync(tmpPath, { force: true });
+      import_node_fs9.rmSync(tmpPath, { force: true });
     } catch {}
     throw error;
   }
@@ -4016,6 +4703,10 @@ var DEFAULT_ENV_HOSTS = {
   test: "openclaw-service-test.yoooclaw.com",
   production: "openclaw-service.yoooclaw.com"
 };
+var NOTIFICATION_INTELLIGENCE_LIGHT_RULES_PLUGIN_PATH = "/api/plugin/notification-intelligence/light-rules";
+var NOTIFICATION_INTELLIGENCE_LIGHT_RULES_APP_PATH = "/api/notification-intelligence/light-rules";
+var NOTIFICATION_INTELLIGENCE_PLUGIN_BASE_PATH = "/api/plugin/notification-intelligence";
+var NOTIFICATION_INTELLIGENCE_APP_BASE_PATH = "/api/notification-intelligence";
 function normalizeHost(host) {
   const trimmed = host?.trim();
   if (!trimmed)
@@ -4037,11 +4728,36 @@ function getEnvHost(env) {
   }
   return normalizeHost(host) ?? DEFAULT_ENV_HOSTS[env];
 }
+function normalizeNotificationIntelligenceLightRulesPluginUrl(url) {
+  const trimmed = url.trim().replace(/\/+$/, "");
+  if (!trimmed)
+    return trimmed;
+  if (trimmed.endsWith(NOTIFICATION_INTELLIGENCE_LIGHT_RULES_PLUGIN_PATH)) {
+    return trimmed;
+  }
+  if (trimmed.endsWith(NOTIFICATION_INTELLIGENCE_LIGHT_RULES_APP_PATH)) {
+    const origin = trimmed.slice(0, -NOTIFICATION_INTELLIGENCE_LIGHT_RULES_APP_PATH.length);
+    return `${origin}${NOTIFICATION_INTELLIGENCE_LIGHT_RULES_PLUGIN_PATH}`;
+  }
+  if (trimmed.endsWith(NOTIFICATION_INTELLIGENCE_PLUGIN_BASE_PATH)) {
+    return `${trimmed}/light-rules`;
+  }
+  if (trimmed.endsWith(NOTIFICATION_INTELLIGENCE_APP_BASE_PATH)) {
+    const origin = trimmed.slice(0, -NOTIFICATION_INTELLIGENCE_APP_BASE_PATH.length);
+    return `${origin}${NOTIFICATION_INTELLIGENCE_LIGHT_RULES_PLUGIN_PATH}`;
+  }
+  if (/^https?:\/\/[^/]+$/i.test(trimmed)) {
+    return `${trimmed}${NOTIFICATION_INTELLIGENCE_LIGHT_RULES_PLUGIN_PATH}`;
+  }
+  return trimmed;
+}
 function buildEnvUrls(host) {
   const https = `https://${host}`;
   const wss = `wss://${host}`;
+  const lightRulesUrl = normalizeNotificationIntelligenceLightRulesPluginUrl(process.env.NOTIFICATION_INTELLIGENCE_LIGHT_RULES_URL || `${https}${NOTIFICATION_INTELLIGENCE_LIGHT_RULES_PLUGIN_PATH}`);
   return {
     lightApiUrl: `${https}/api/message/tob/sendMessage`,
+    notificationIntelligenceLightRulesPluginUrl: lightRulesUrl,
     relayTunnelUrl: `${wss}/message/messages/ws/plugin`,
     appNameMapUrl: `${https}/api/application-config/app-package/config-all`,
     modelProxyLongRecordingSubmitTaskUrl: `${https}/api/model-proxy/long-recording/submit-task`,
@@ -4057,9 +4773,9 @@ var VALID_ENVS = new Set([
 ]);
 function readDotEnv() {
   const path = resolveStateFile(".env");
-  if (!import_node_fs8.existsSync(path))
+  if (!import_node_fs9.existsSync(path))
     return {};
-  return Object.fromEntries(parseEnvContent(import_node_fs8.readFileSync(path, "utf-8")));
+  return Object.fromEntries(parseEnvContent(import_node_fs9.readFileSync(path, "utf-8")));
 }
 function readPersistedEnvName() {
   const fromDotEnv = readDotEnv()["PHONE_NOTIFICATIONS_ENV"]?.trim();
@@ -4111,7 +4827,7 @@ async function sendLightEffect(apiKey, segments, logger, repeatInput, reason, ti
   } catch (error) {
     return { ok: false, error: error?.message ?? String(error) };
   }
-  const bizUniqueId = import_node_crypto2.randomUUID();
+  const bizUniqueId = import_node_crypto3.randomUUID();
   const requestBody = {
     appKey,
     bizMap: { noticeType: "APP_NOTIFICATION_IMPORTANT", title: resolvedTitle, reason },
@@ -4177,8 +4893,8 @@ function registerLightSend(light) {
 }
 
 // src/cli/light-setup-tools.ts
-var import_node_fs9 = require("node:fs");
-var import_node_path9 = require("node:path");
+var import_node_fs10 = require("node:fs");
+var import_node_path10 = require("node:path");
 
 // src/light-rules/names.ts
 var LIGHT_RULE_GATEWAY_METHODS = {
@@ -4252,8 +4968,8 @@ function upsertToolsForPolicy(policy, tools) {
 function resolveConfigPath2() {
   return resolveConfigPath();
 }
-var LIGHT_TOOLS = ["light_control", ...LIGHT_RULE_TOOL_NAME_LIST];
-function upsertLightControlAlsoAllow(cfg) {
+var LIGHT_TOOLS = [...LIGHT_RULE_TOOL_NAME_LIST];
+function upsertLightRuleToolsAlsoAllow(cfg) {
   if (!isObject(cfg.tools))
     cfg.tools = {};
   const globalChanged = upsertToolsForPolicy(cfg.tools, LIGHT_TOOLS);
@@ -4272,24 +4988,24 @@ function upsertLightControlAlsoAllow(cfg) {
   return { globalChanged, mainAgentChanged };
 }
 function registerLightSetupTools(light) {
-  light.command("setup").description("自动放行 light_control（兼容 tools.allow / tools.alsoAllow）").action(() => {
+  light.command("setup").description("自动放行云端灯效规则工具（兼容 tools.allow / tools.alsoAllow）").action(() => {
     const configPath = resolveConfigPath2();
-    if (!import_node_fs9.existsSync(configPath)) {
+    if (!import_node_fs10.existsSync(configPath)) {
       exitError("CONFIG_NOT_FOUND", `未找到配置文件: ${configPath}`);
     }
     let cfg = {};
     try {
-      const raw = import_node_fs9.readFileSync(configPath, "utf-8");
+      const raw = import_node_fs10.readFileSync(configPath, "utf-8");
       const parsed = JSON.parse(raw);
       if (isObject(parsed))
         cfg = parsed;
     } catch (err) {
       exitError("CONFIG_INVALID", `读取/解析配置失败: ${err?.message ?? String(err)}`);
     }
-    const result = upsertLightControlAlsoAllow(cfg);
+    const result = upsertLightRuleToolsAlsoAllow(cfg);
     try {
-      import_node_fs9.mkdirSync(import_node_path9.dirname(configPath), { recursive: true });
-      import_node_fs9.writeFileSync(configPath, JSON.stringify(cfg, null, 2) + `
+      import_node_fs10.mkdirSync(import_node_path10.dirname(configPath), { recursive: true });
+      import_node_fs10.writeFileSync(configPath, JSON.stringify(cfg, null, 2) + `
 `, "utf-8");
     } catch (err) {
       exitError("WRITE_FAILED", `写入配置失败: ${err?.message ?? String(err)}`);
@@ -4308,10 +5024,10 @@ function registerLightSetupTools(light) {
 }
 
 // src/tunnel/status.ts
-var import_node_fs10 = require("node:fs");
-var import_node_path10 = require("node:path");
-var TUNNEL_STATUS_REL_PATH = import_node_path10.join("plugins", "phone-notifications", "tunnel-status.json");
-var TUNNEL_LOCK_REL_PATH = import_node_path10.join("plugins", "phone-notifications", "relay-tunnel.lock");
+var import_node_fs11 = require("node:fs");
+var import_node_path11 = require("node:path");
+var TUNNEL_STATUS_REL_PATH = import_node_path11.join("plugins", "phone-notifications", "tunnel-status.json");
+var TUNNEL_LOCK_REL_PATH = import_node_path11.join("plugins", "phone-notifications", "relay-tunnel.lock");
 function isTunnelState(value) {
   return value === "connected" || value === "connecting" || value === "disconnected" || value === "stopped";
 }
@@ -4360,9 +5076,9 @@ function staleStatusMessage(status, lock) {
   return `${prefix}，但当前运行锁启动于 ${lock.startedAt}，晚于状态时间，说明状态未随新进程刷新。请重启 openclaw 主进程。`;
 }
 function assessTunnelStatus(stateDir) {
-  const statusFilePath = import_node_path10.join(stateDir, TUNNEL_STATUS_REL_PATH);
-  const lockFilePath = import_node_path10.join(stateDir, TUNNEL_LOCK_REL_PATH);
-  if (!import_node_fs10.existsSync(statusFilePath)) {
+  const statusFilePath = import_node_path11.join(stateDir, TUNNEL_STATUS_REL_PATH);
+  const lockFilePath = import_node_path11.join(stateDir, TUNNEL_LOCK_REL_PATH);
+  if (!import_node_fs11.existsSync(statusFilePath)) {
     return {
       status: null,
       issueCode: "STATUS_NOT_FOUND",
@@ -4370,7 +5086,7 @@ function assessTunnelStatus(stateDir) {
       statusFilePath,
       lockFilePath,
       lock: {
-        exists: import_node_fs10.existsSync(lockFilePath),
+        exists: import_node_fs11.existsSync(lockFilePath),
         pid: null,
         startedAt: null,
         active: null
@@ -4379,7 +5095,7 @@ function assessTunnelStatus(stateDir) {
   }
   let rawStatus;
   try {
-    rawStatus = JSON.parse(import_node_fs10.readFileSync(statusFilePath, "utf-8"));
+    rawStatus = JSON.parse(import_node_fs11.readFileSync(statusFilePath, "utf-8"));
   } catch {
     return {
       status: null,
@@ -4388,7 +5104,7 @@ function assessTunnelStatus(stateDir) {
       statusFilePath,
       lockFilePath,
       lock: {
-        exists: import_node_fs10.existsSync(lockFilePath),
+        exists: import_node_fs11.existsSync(lockFilePath),
         pid: null,
         startedAt: null,
         active: null
@@ -4403,7 +5119,7 @@ function assessTunnelStatus(stateDir) {
       statusFilePath,
       lockFilePath,
       lock: {
-        exists: import_node_fs10.existsSync(lockFilePath),
+        exists: import_node_fs11.existsSync(lockFilePath),
         pid: null,
         startedAt: null,
         active: null
@@ -4411,11 +5127,11 @@ function assessTunnelStatus(stateDir) {
     };
   }
   const status = rawStatus;
-  const lockExists = import_node_fs10.existsSync(lockFilePath);
+  const lockExists = import_node_fs11.existsSync(lockFilePath);
   let lockInfo = null;
   if (lockExists) {
     try {
-      lockInfo = parseTunnelLockInfo(JSON.parse(import_node_fs10.readFileSync(lockFilePath, "utf-8")));
+      lockInfo = parseTunnelLockInfo(JSON.parse(import_node_fs11.readFileSync(lockFilePath, "utf-8")));
     } catch {
       lockInfo = null;
     }
@@ -4518,12 +5234,12 @@ function registerNtfStoragePath(ntf, ctx) {
 }
 
 // src/cli/log-search.ts
-var import_node_fs11 = require("node:fs");
-var import_node_path11 = require("node:path");
+var import_node_fs12 = require("node:fs");
+var import_node_path12 = require("node:path");
 function resolveLogsDir(ctx) {
   if (ctx.stateDir) {
-    const dir = import_node_path11.join(ctx.stateDir, "plugins", "phone-notifications", "logs");
-    if (import_node_fs11.existsSync(dir))
+    const dir = import_node_path12.join(ctx.stateDir, "plugins", "phone-notifications", "logs");
+    if (import_node_fs12.existsSync(dir))
       return dir;
   }
   return null;
@@ -4531,7 +5247,7 @@ function resolveLogsDir(ctx) {
 function listLogDateKeys(dir) {
   const pattern = /^(\d{4}-\d{2}-\d{2})\.log$/;
   const keys = [];
-  for (const entry of import_node_fs11.readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of import_node_fs12.readdirSync(dir, { withFileTypes: true })) {
     if (!entry.isFile())
       continue;
     const m = pattern.exec(entry.name);
@@ -4541,10 +5257,10 @@ function listLogDateKeys(dir) {
   return keys.sort().reverse();
 }
 function collectLogLines(dir, dateKey, keyword, limit, collected) {
-  const filePath = import_node_path11.join(dir, `${dateKey}.log`);
-  if (!import_node_fs11.existsSync(filePath))
+  const filePath = import_node_path12.join(dir, `${dateKey}.log`);
+  if (!import_node_fs12.existsSync(filePath))
     return;
-  const content = import_node_fs11.readFileSync(filePath, "utf-8");
+  const content = import_node_fs12.readFileSync(filePath, "utf-8");
   const lowerKeyword = keyword?.toLowerCase();
   for (const line of content.split(`
 `)) {
@@ -4580,7 +5296,7 @@ function registerLogSearch(ntf, ctx) {
 }
 
 // src/cli/env.ts
-var import_node_child_process = require("node:child_process");
+var import_node_child_process2 = require("node:child_process");
 
 // src/update/restart.ts
 var DEFAULT_RESTART_GRACE_MS = 1500;
@@ -4704,7 +5420,7 @@ function triggerGatewayReloadAfterEnvSwitch(deps = {}) {
   }
   const hostCli = deps.hostCli?.trim() || process.env.HOST_CLI?.trim() || "openclaw";
   const command = `${hostCli} gateway restart`;
-  const run = deps.spawnSync ?? import_node_child_process.spawnSync;
+  const run = deps.spawnSync ?? import_node_child_process2.spawnSync;
   const result = run(hostCli, ["gateway", "restart"], {
     encoding: "utf-8",
     stdio: "pipe",
@@ -4758,11 +5474,11 @@ function registerEnvCli(ntf, deps = {}) {
 }
 
 // src/cli/doctor.ts
-var import_node_fs15 = require("node:fs");
+var import_node_fs16 = require("node:fs");
 var import_node_readline = require("node:readline");
 
 // src/cli/doctor/check-dangerous-flags.ts
-var import_node_fs12 = require("node:fs");
+var import_node_fs13 = require("node:fs");
 function isObject2(v) {
   return !!v && typeof v === "object" && !Array.isArray(v);
 }
@@ -4782,13 +5498,13 @@ var checkDangerousFlags = ({ cfg, configPath }) => {
     detail: "这会关闭 Control UI 的设备身份验证，任何人都可以访问控制面板。",
     fixDescription: "设为 false",
     fix: () => {
-      const raw = import_node_fs12.readFileSync(configPath, "utf-8");
+      const raw = import_node_fs13.readFileSync(configPath, "utf-8");
       const config = JSON.parse(raw);
       const gw = config.gateway;
       const cui = gw.controlUi;
       cui.dangerouslyDisableDeviceAuth = false;
-      import_node_fs12.copyFileSync(configPath, configPath + ".bak");
-      import_node_fs12.writeFileSync(configPath, JSON.stringify(config, null, 2) + `
+      import_node_fs13.copyFileSync(configPath, configPath + ".bak");
+      import_node_fs13.writeFileSync(configPath, JSON.stringify(config, null, 2) + `
 `, "utf-8");
     }
   };
@@ -4845,11 +5561,11 @@ function warnEmpty() {
 }
 
 // src/cli/doctor/check-state-dir-perms.ts
-var import_node_fs13 = require("node:fs");
+var import_node_fs14 = require("node:fs");
 var checkStateDirPerms = ({ stateDir }) => {
   let mode;
   try {
-    mode = import_node_fs13.statSync(stateDir).mode;
+    mode = import_node_fs14.statSync(stateDir).mode;
   } catch {
     return null;
   }
@@ -4864,7 +5580,7 @@ var checkStateDirPerms = ({ stateDir }) => {
     detail: "其他用户可以读取该目录下的凭证和配置文件。",
     fixDescription: "chmod 700 " + stateDir,
     fix: () => {
-      import_node_fs13.chmodSync(stateDir, 448);
+      import_node_fs14.chmodSync(stateDir, 448);
     }
   };
 };
@@ -5073,16 +5789,16 @@ function pickNewestVersion(versions) {
 }
 
 // src/version.ts
-var import_node_fs14 = require("node:fs");
+var import_node_fs15 = require("node:fs");
 function readBuildInjectedVersion() {
   if (false) {}
-  const version = "1.12.0".trim();
+  const version = "1.12.2".trim();
   return version || undefined;
 }
 function readPluginVersionFromPackageJson() {
   try {
     const packageJsonUrl = new URL("../package.json", "file:///home/runner/work/openclaw-plugin/openclaw-plugin/src/version.ts");
-    const packageJson = JSON.parse(import_node_fs14.readFileSync(packageJsonUrl, "utf-8"));
+    const packageJson = JSON.parse(import_node_fs15.readFileSync(packageJsonUrl, "utf-8"));
     const version = packageJson.version?.trim();
     return version || undefined;
   } catch {
@@ -5140,10 +5856,10 @@ function isObject5(v) {
   return !!v && typeof v === "object" && !Array.isArray(v);
 }
 function readConfig(configPath) {
-  if (!import_node_fs15.existsSync(configPath))
+  if (!import_node_fs16.existsSync(configPath))
     return {};
   try {
-    const parsed = JSON.parse(import_node_fs15.readFileSync(configPath, "utf-8"));
+    const parsed = JSON.parse(import_node_fs16.readFileSync(configPath, "utf-8"));
     return isObject5(parsed) ? parsed : {};
   } catch {
     return {};
@@ -5171,10 +5887,10 @@ function severityOrder(s) {
 }
 function confirm(question) {
   const rl = import_node_readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve(answer.trim().toLowerCase() === "y");
+      resolve2(answer.trim().toLowerCase() === "y");
     });
   });
 }
@@ -5354,9 +6070,9 @@ function registerRecStoragePath(rec, ctx) {
 
 // src/cli/rec-setup.ts
 var import_node_readline2 = require("node:readline");
-var import_node_fs16 = require("node:fs");
+var import_node_fs17 = require("node:fs");
 function ask(rl, question) {
-  return new Promise((resolve) => rl.question(question, resolve));
+  return new Promise((resolve2) => rl.question(question, resolve2));
 }
 async function askChoice(rl, prompt, choices, defaultIdx = 0) {
   choices.forEach((c, i) => {
@@ -5455,9 +6171,9 @@ async function setupLocal(rl) {
 function registerRecSetup(rec, ctx) {
   rec.command("setup").description("交互式配置 ASR 转写参数，保存到本地配置文件").action(async () => {
     const configPath = resolveAsrConfigPath(ctx);
-    if (import_node_fs16.existsSync(configPath)) {
+    if (import_node_fs17.existsSync(configPath)) {
       try {
-        const existing = JSON.parse(import_node_fs16.readFileSync(configPath, "utf-8"));
+        const existing = JSON.parse(import_node_fs17.readFileSync(configPath, "utf-8"));
         process.stderr.write(`当前已有配置：mode = ${existing.mode}`);
         if (existing.updatedAt)
           process.stderr.write(`，更新于 ${existing.updatedAt}`);
@@ -5473,7 +6189,7 @@ function registerRecSetup(rec, ctx) {
       const modeIdx = await askChoice(rl, "选择模式", ["api（云端 model-proxy 长录音）", "local（本地 Whisper）"]);
       const config = modeIdx === 0 ? await setupApi(rl) : await setupLocal(rl);
       const stored = { ...config, updatedAt: new Date().toISOString() };
-      import_node_fs16.writeFileSync(configPath, JSON.stringify(stored, null, 2), "utf-8");
+      import_node_fs17.writeFileSync(configPath, JSON.stringify(stored, null, 2), "utf-8");
       process.stderr.write(`
 ✓ 配置已保存到 ${configPath}
 
@@ -5485,10 +6201,93 @@ function registerRecSetup(rec, ctx) {
   });
 }
 
+// src/cli/image-list.ts
+function registerImageList(image, ctx) {
+  image.command("list").description("列出所有图片（可按状态/来源应用过滤）").option("--status <status>", "按状态过滤（syncing|synced|sync_failed）").option("--app <app>", "按来源应用过滤").action((opts) => {
+    const dir = resolveImagesDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "图片存储目录不可用");
+    let images = readImageIndex(dir);
+    if (opts.status) {
+      images = images.filter((e) => e.status === opts.status);
+    }
+    if (opts.app) {
+      images = images.filter((e) => e.metadata.source_app === opts.app);
+    }
+    const items = images.map((e) => ({
+      imageId: e.imageId,
+      status: e.status,
+      source_app: e.metadata.source_app ?? null,
+      caption: e.metadata.caption ?? null,
+      mime_type: e.metadata.mime_type ?? null,
+      size_bytes: e.metadata.size_bytes ?? null,
+      created_at: e.metadata.created_at,
+      has_file: !!e.localFile,
+      localFile: e.localFile ?? null,
+      syncedAt: e.syncedAt ?? null,
+      error: e.lastError ?? null
+    }));
+    output({ ok: true, total: items.length, images: items });
+  });
+}
+
+// src/cli/image-status.ts
+function registerImageStatus(image, ctx) {
+  image.command("status <id>").description("查看单张图片详情").action((id) => {
+    const dir = resolveImagesDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "图片存储目录不可用");
+    const entry = readImageIndex(dir).find((e) => e.imageId === id);
+    if (!entry) {
+      exitError("NOT_FOUND", `图片不存在: ${id}`);
+    }
+    output({
+      ok: true,
+      image: {
+        imageId: entry.imageId,
+        clientLabel: entry.clientLabel ?? null,
+        status: entry.status,
+        metadata: entry.metadata,
+        localFile: entry.localFile ?? null,
+        thumbnail: entry.thumbnail ?? null,
+        syncedAt: entry.syncedAt ?? null,
+        error: entry.lastError ?? null
+      }
+    });
+  });
+}
+
+// src/cli/image-path.ts
+function registerImagePath(image, ctx) {
+  image.command("path <id>").description("打印图片本地文件绝对路径").action((id) => {
+    const dir = resolveImagesDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "图片存储目录不可用");
+    const entry = readImageIndex(dir).find((e) => e.imageId === id);
+    if (!entry) {
+      exitError("NOT_FOUND", `图片不存在: ${id}`);
+    }
+    if (entry.status !== "synced" || !entry.localFile) {
+      exitError("IMAGE_NOT_READY", `图片 ${id} 尚未下载完成（status=${entry.status}${entry.lastError ? `, error=${entry.lastError}` : ""}）`);
+    }
+    output({ ok: true, path: resolveImageFile(dir, entry.localFile) });
+  });
+}
+
+// src/cli/image-storage-path.ts
+function registerImageStoragePath(image, ctx) {
+  image.command("storage-path").description("查询图片存储路径").action(() => {
+    const dir = resolveImagesDir(ctx);
+    if (!dir)
+      exitError("STORAGE_UNAVAILABLE", "图片存储目录不可用");
+    output({ ok: true, path: dir });
+  });
+}
+
 // src/cli/update.ts
-var import_node_child_process2 = require("node:child_process");
-var import_node_fs17 = require("node:fs");
-var import_node_path12 = require("node:path");
+var import_node_child_process3 = require("node:child_process");
+var import_node_fs18 = require("node:fs");
+var import_node_path13 = require("node:path");
 var import_node_os = __toESM(require("node:os"));
 async function fetchText(url) {
   const res = await fetch(url, { signal: AbortSignal.timeout(30000) });
@@ -5561,9 +6360,9 @@ async function runUpdate(ctx, opts) {
 `);
     process.exit(1);
   }
-  const tmpScript = import_node_path12.join(import_node_os.default.tmpdir(), `openclaw-install-${Date.now()}.mjs`);
+  const tmpScript = import_node_path13.join(import_node_os.default.tmpdir(), `openclaw-install-${Date.now()}.mjs`);
   try {
-    import_node_fs17.writeFileSync(tmpScript, installScript, "utf-8");
+    import_node_fs18.writeFileSync(tmpScript, installScript, "utf-8");
   } catch (err) {
     const msg = `写入临时文件失败: ${err?.message ?? String(err)}`;
     if (json) {
@@ -5575,9 +6374,9 @@ async function runUpdate(ctx, opts) {
     process.exit(1);
   }
   const stateDir = resolveStateDir(ctx.stateDir);
-  const result = import_node_child_process2.spawnSync(process.execPath, [tmpScript, "--version", latest, "--state-dir", stateDir], { stdio: "inherit" });
+  const result = import_node_child_process3.spawnSync(process.execPath, [tmpScript, "--version", latest, "--state-dir", stateDir], { stdio: "inherit" });
   try {
-    import_node_fs17.unlinkSync(tmpScript);
+    import_node_fs18.unlinkSync(tmpScript);
   } catch {}
   if (result.error) {
     const msg = `安装脚本执行失败: ${result.error.message}`;
@@ -5621,6 +6420,7 @@ function registerAllCli(program2, ctx, rootCommandName = "ntf") {
   registerAuthCli(ntf);
   registerNtfSearch(ntf, normalizedCtx);
   registerNtfSummary(ntf, normalizedCtx);
+  registerNtfSummaryJob(ntf, normalizedCtx);
   registerNtfStats(ntf, normalizedCtx);
   registerNtfSync(ntf, normalizedCtx);
   registerNtfMonitor(ntf, normalizedCtx);
@@ -5637,6 +6437,11 @@ function registerAllCli(program2, ctx, rootCommandName = "ntf") {
   registerRecStatus(rec, normalizedCtx);
   registerRecStoragePath(rec, normalizedCtx);
   registerRecSetup(rec, normalizedCtx);
+  const image = ntf.command("image").description("图片管理");
+  registerImageList(image, normalizedCtx);
+  registerImageStatus(image, normalizedCtx);
+  registerImagePath(image, normalizedCtx);
+  registerImageStoragePath(image, normalizedCtx);
   registerUpdate(ntf, normalizedCtx);
 }
 
@@ -5651,5 +6456,5 @@ program2.parseAsync(process.argv).catch((err) => {
   process.exit(1);
 });
 
-//# debugId=4B1B72A253EC571164756E2164756E21
+//# debugId=5548672AE9D3231064756E2164756E21
 //# sourceMappingURL=ntf.cjs.map