dsh-screenshot-capture 0.2.0

package/config.mjs

@@ -0,0 +1,79 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+export const DEFAULT_CONFIG = Object.freeze({
+  enabled: true,
+  pollIntervalMs: 200,
+  cooldownMs: 2000,
+  // 默认库路径留空:未配置时采集功能自动停用并告警,绝不创建无关目录。
+  // 首次使用请在 Web 设置 / config.json 里配置你自己的 Obsidian 库路径。
+  vaultPath: "",
+  inboxFolder: "收件箱",
+  attachmentsFolder: "attachments",
+  knowledgeFolder: "知识库",
+  summaryFolder: "总结",
+  archiveFolder: "归档",
+  recycleFolder: "回收站",
+  ocr: {
+    mode: "qwen", // "qwen" | "off"
+    model: "qwen-vl-plus",
+    apiKey: "",
+    endpoint: "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
+    prompt: "请识别图片中的全部文字内容,原样输出;数学公式用 LaTeX 输出。只输出识别结果,不要任何解释。",
+  },
+  dialog: { offsetX: 16, offsetY: 16, previewMaxWidth: 320 },
+  organize: { addBacklinks: true },
+});
+
+export function configDir() {
+  return join(homedir(), ".dsh-screenshot-capture");
+}
+
+export function configPath() {
+  return join(configDir(), "config.json");
+}
+
+/** 合并默认配置 + 配置文件 + 运行时入参(DSh 插件配置覆盖最高) */
+export function resolveConfig(input = {}) {
+  let file = {};
+  try {
+    if (existsSync(configPath())) {
+      file = JSON.parse(readFileSync(configPath(), "utf8"));
+    }
+  } catch {
+    file = {};
+  }
+  const merged = mergeDeep(structuredClone(DEFAULT_CONFIG), file);
+  return mergeDeep(merged, input);
+}
+
+export function saveConfig(config) {
+  mkdirSync(configDir(), { recursive: true });
+  writeFileSync(configPath(), JSON.stringify(config, null, 2), "utf8");
+}
+
+function mergeDeep(base, patch) {
+  if (patch === undefined || patch === null) return base;
+  if (typeof patch !== "object" || Array.isArray(patch)) return patch;
+  const out = { ...base };
+  for (const [k, v] of Object.entries(patch)) {
+    out[k] = typeof v === "object" && v !== null && !Array.isArray(v) && typeof out[k] === "object" && out[k] !== null
+      ? mergeDeep(out[k], v)
+      : v;
+  }
+  return out;
+}
+
+export function ensureVault(config) {
+  const folders = [
+    join(config.vaultPath, config.inboxFolder),
+    join(config.vaultPath, config.inboxFolder, config.attachmentsFolder),
+    join(config.vaultPath, config.knowledgeFolder),
+    join(config.vaultPath, config.summaryFolder),
+    join(config.vaultPath, config.archiveFolder),
+    join(config.vaultPath, config.recycleFolder),
+  ];
+  for (const dir of folders) mkdirSync(dir, { recursive: true });
+  return folders;
+}

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-screenshot-capture bundle patch layer.
+# 安装本包到 profile 后,host 端加载主入口(剪贴板监听/悬浮窗/OCR/存储/整理工具)。
+- insert:
+    - id: dsh-screenshot-capture
+      name: dsh-screenshot-capture

package/core.mjs

@@ -0,0 +1,65 @@
+import { unlinkSync } from "node:fs";
+import { ocrImage } from "./ocr.mjs";
+import {
+  appendEntry,
+  KIND,
+  saveAttachment,
+  stampParts,
+  updateEntryOcr,
+} from "./storage.mjs";
+
+/**
+ * 悬浮窗选择处理(插件与独立测试共用):
+ *   copy → 剪贴板原样不动,仅清理临时图
+ *   doc  → 图片入附件 + 当天笔记立即追加(#文档,OCR 占位)→ 后台 OCR → 回填文字
+ *   img  → 图片入附件 + 当天笔记追加(#图片,无 OCR)
+ * note/isKey 来自悬浮窗:用户注释 + 「重点」标记(标题一 # **重点**)。
+ */
+export async function handleChoice(config, { action, path, note = "", isKey = false }) {
+  const now = new Date();
+  const { date, fileStamp, time } = stampParts(now);
+
+  if (action === "copy") {
+    try { unlinkSync(path); } catch { /* ignore */ }
+    return { action, date, time, note: "已忽略(剪贴板原样保留,可直接粘贴)" };
+  }
+
+  const kind = action === "doc" ? KIND.DOC : KIND.IMG;
+  const imageRel = saveAttachment(config, path, date, fileStamp, kind);
+
+  if (kind === KIND.IMG) {
+    try { unlinkSync(path); } catch { /* ignore */ }
+    const notePath = appendEntry(config, { date, time, kind, imageRel, note, isKey });
+    return { action, date, time, imageRel, notePath, note: `已存图片:${imageRel}` };
+  }
+
+  // 文档:先占位落笔记,后台 OCR 后回填
+  const notePath = appendEntry(config, { date, time, kind, imageRel, ocrText: null, note, isKey });
+  let ocrText = "";
+  let ocrError = "";
+  try {
+    ocrText = await ocrImage(config, path);
+  } catch (err) {
+    ocrError = err.message;
+  } finally {
+    try { unlinkSync(path); } catch { /* ignore */ }
+  }
+  if (!ocrError) {
+    updateEntryOcr(config, { date, time, imageRel, ocrText });
+  } else {
+    // OCR 失败时也把占位替换为失败说明
+    updateEntryOcr(config, { date, time, imageRel, ocrText: `（识别失败:${ocrError}）` });
+  }
+  return {
+    action,
+    date,
+    time,
+    imageRel,
+    notePath,
+    ocrText: ocrText || null,
+    ocrError: ocrError || null,
+    note: ocrError
+      ? `图片已存,但 OCR 失败:${ocrError}`
+      : `已存文档(含 OCR 文字,${ocrText.length} 字)`,
+  };
+}

package/index.mjs

@@ -0,0 +1,272 @@
+import { defineTool } from "@deepseek-ai/dsh-tools";
+import z from "@deepseek-ai/schemastery";
+import { ClipboardWatcher } from "./clipboard.mjs";
+import { DEFAULT_CONFIG, ensureVault, resolveConfig } from "./config.mjs";
+import { handleChoice } from "./core.mjs";
+import { listEntriesForDate, organizeDay } from "./organize.mjs";
+import { readDailyNote, todayString } from "./storage.mjs";
+
+export const name = "dsh-screenshot-capture";
+export const inject = ["tools"];
+
+/**
+ * 设置命名空间:Web 配置界面读写它。用户层持久化在 settings.yaml,
+ * config.json 作为 base(旧配置自动继承)。配置变化实时生效。
+ */
+const SETTINGS_NS = "dsh-screenshot-capture";
+
+/**
+ * 扁平 schema:settings 客户端的 set(field, value) 只支持单段路径,
+ * 所以把嵌套的 ocr/dialog 拍平,host 侧再映射回插件结构。
+ */
+const settingsSchema = z.object({
+  enabled: z.boolean().default(true),
+  vaultPath: z.string().default(DEFAULT_CONFIG.vaultPath),
+  pollIntervalMs: z.number().min(50).max(60000).default(DEFAULT_CONFIG.pollIntervalMs),
+  cooldownMs: z.number().min(0).max(120000).default(DEFAULT_CONFIG.cooldownMs),
+  ocrMode: z.union([z.const("qwen"), z.const("off")]).default(DEFAULT_CONFIG.ocr.mode),
+  ocrModel: z.string().default(DEFAULT_CONFIG.ocr.model),
+  ocrApiKey: z.string().default(""),
+  ocrEndpoint: z.string().default(DEFAULT_CONFIG.ocr.endpoint),
+  ocrPrompt: z.string().default(DEFAULT_CONFIG.ocr.prompt),
+  dialogOffsetX: z.number().min(-1000).max(1000).default(DEFAULT_CONFIG.dialog.offsetX),
+  dialogOffsetY: z.number().min(-1000).max(1000).default(DEFAULT_CONFIG.dialog.offsetY),
+  dialogPreviewMaxWidth: z.number().min(100).max(2000).default(DEFAULT_CONFIG.dialog.previewMaxWidth),
+});
+
+/** 插件嵌套结构 → 扁平 settings 结构 */
+function toFlat(config) {
+  return {
+    enabled: config.enabled,
+    vaultPath: config.vaultPath,
+    pollIntervalMs: config.pollIntervalMs,
+    cooldownMs: config.cooldownMs,
+    ocrMode: config.ocr?.mode,
+    ocrModel: config.ocr?.model,
+    ocrApiKey: config.ocr?.apiKey ?? "",
+    ocrEndpoint: config.ocr?.endpoint,
+    ocrPrompt: config.ocr?.prompt,
+    dialogOffsetX: config.dialog?.offsetX,
+    dialogOffsetY: config.dialog?.offsetY,
+    dialogPreviewMaxWidth: config.dialog?.previewMaxWidth,
+  };
+}
+
+/** 扁平 settings 结构 → 插件嵌套结构 */
+function fromFlat(flat) {
+  return {
+    enabled: flat.enabled,
+    vaultPath: flat.vaultPath,
+    pollIntervalMs: flat.pollIntervalMs,
+    cooldownMs: flat.cooldownMs,
+    ocr: {
+      mode: flat.ocrMode,
+      model: flat.ocrModel,
+      apiKey: flat.ocrApiKey || "",
+      endpoint: flat.ocrEndpoint,
+      prompt: flat.ocrPrompt,
+    },
+    dialog: {
+      offsetX: flat.dialogOffsetX,
+      offsetY: flat.dialogOffsetY,
+      previewMaxWidth: flat.dialogPreviewMaxWidth,
+    },
+  };
+}
+
+export function apply(ctx, input = {}) {
+  // 初始配置:默认值 ← config.json ← 插件行 config
+  let liveConfig = resolveConfig(input);
+  if (!liveConfig.vaultPath) {
+    ctx.logger.warn("dsh-screenshot-capture: 未配置 vaultPath,采集功能已停用");
+  }
+  try {
+    ensureVault(liveConfig);
+  } catch (err) {
+    ctx.logger.warn(`dsh-screenshot-capture: vault 初始化失败:${err.message}`);
+  }
+
+  // ---- 剪贴板监听:单例 + 串行化重启 ----
+  // 全程只有一个 watcher。配置变化时先等旧 PowerShell 进程真正退出
+  // (stopAsync:kill + taskkill 兜底 + 超时),再起新的;配置没变就不重启,
+  // 避免残留多个监听导致一次截图弹多个窗。
+  let watcher = null;
+  let watcherKey = null; // 当前 watcher 所用配置的特征串
+  let disposed = false;
+  let restartChain = Promise.resolve();
+
+  const configKey = (cfg) => JSON.stringify({
+    enabled: cfg.enabled,
+    vaultPath: cfg.vaultPath,
+    pollIntervalMs: cfg.pollIntervalMs,
+    cooldownMs: cfg.cooldownMs,
+    dialogOffsetX: cfg.dialog?.offsetX,
+    dialogOffsetY: cfg.dialog?.offsetY,
+    dialogPreviewMaxWidth: cfg.dialog?.previewMaxWidth,
+  });
+
+  const scheduleRestart = () => {
+    const cfg = liveConfig;
+    const key = configKey(cfg);
+    restartChain = restartChain.then(async () => {
+      if (disposed || key === watcherKey) return;
+      watcherKey = key;
+      const old = watcher;
+      if (old) {
+        watcher = null;
+        await old.stopAsync();
+      }
+      if (!cfg.enabled || !cfg.vaultPath) return;
+      const w = new ClipboardWatcher(cfg);
+      w.on("choice", async ({ action, path, note = "", isKey = false }) => {
+        try {
+          const result = await handleChoice(cfg, { action, path, note, isKey });
+          ctx.logger.info(`dsh-screenshot-capture: ${result.note} (${action})`);
+        } catch (err) {
+          ctx.logger.warn(`dsh-screenshot-capture: 处理失败:${err.message}`);
+        }
+      });
+      w.on("err", (ev) => ctx.logger.warn(`dsh-screenshot-capture: ${ev.msg}`));
+      w.on("exit", (ev) => ctx.logger.info(`dsh-screenshot-capture: 监听助手退出 code=${ev.code}`));
+      watcher = w;
+      w.start();
+    });
+  };
+
+  const disposeWatcher = () => {
+    disposed = true;
+    if (watcher) {
+      watcher.stop();
+      watcher = null;
+    }
+  };
+
+  ctx.effect(
+    () => {
+      scheduleRestart();
+      return disposeWatcher;
+    },
+    "dsh-screenshot-capture.watcher",
+  );
+
+  // 设置命名空间:Web 配置界面的数据层。settings 服务由 dsh-settings-file
+  // 提供,apply 时未必已就绪,须用 ctx.inject 等它可用后再注册(直接
+  // ctx.get 会拿到 undefined,导致命名空间没注册、界面显示不可用)。
+  ctx.inject(["settings"], (settingsCtx) => {
+    try {
+      const scope = settingsCtx.settings.register(SETTINGS_NS, settingsSchema, {
+        base: toFlat(liveConfig),
+      });
+      const resolved = scope.get();
+      if (resolved) {
+        liveConfig = { ...liveConfig, ...fromFlat(resolved) };
+        scheduleRestart();
+      }
+      scope.watch((next) => {
+        if (!next) return;
+        liveConfig = { ...liveConfig, ...fromFlat(next) };
+        scheduleRestart();
+      });
+    } catch (err) {
+      ctx.logger.warn(`dsh-screenshot-capture: 设置命名空间注册失败,使用 JSON 配置:${err.message}`);
+    }
+  });
+
+  // 工具
+  ctx.tools.register(textTool({
+    name: "screenshot_status",
+    description:
+      "查询「截图入库」插件的状态:监听是否开启、vault 路径、今天的已收条目数。",
+    parameters: {},
+    async execute() {
+      const today = todayString();
+      const note = readDailyNote(liveConfig, today);
+      const count = (note.match(/^## /gm) || []).length;
+      return [
+        `监听:${watcher?.started ? "运行中" : "未运行"}`,
+        `vault:${liveConfig.vaultPath}`,
+        `OCR:${liveConfig.ocr?.mode ?? "off"}`,
+        `今日条目:${count}`,
+      ].join("\n");
+    },
+  }));
+
+  ctx.tools.register(textTool({
+    name: "screenshot_inbox_list",
+    description:
+      "列出某天「收件箱」里的全部截图条目(时间/类型/OCR文字)。晚间整理前调用,展示给用户选择保留哪些。",
+    parameters: {
+      date: { type: "string", description: "日期 YYYY-MM-DD,缺省今天" },
+    },
+    async execute(args) {
+      const date = args.date || todayString();
+      const entries = listEntriesForDate(liveConfig, date);
+      if (entries.length === 0) return `${date} 收件箱为空(还没有截图入库)`;
+      return entries
+        .map((e, i) => {
+          const lines = [`${i + 1}. [${e.time}] #${e.kind} ${e.imageRel ?? ""}`];
+          if (e.isKey) lines.push(`   重点:是`);
+          if (e.note) lines.push(`   注释:${e.note}`);
+          lines.push(`   OCR:${(e.ocrText || "无").slice(0, 120)}`);
+          return lines.join("\n");
+        })
+        .join("\n");
+    },
+  }));
+
+  ctx.tools.register(textTool({
+    name: "screenshot_inbox_organize",
+    description:
+      "晚间整理:对某天收件箱里【保留】的条目,按分类写入知识库并生成笔记、更新分类索引、写当日总结、加双链,然后把当天收件箱笔记移入归档。keep 传 'all' 表示全部保留。",
+    parameters: {
+      date: { type: "string", description: "日期 YYYY-MM-DD,缺省今天" },
+      keep: {
+        type: "array",
+        items: { type: "string" },
+        description: "保留条目的时间列表(如 ['14:30','15:02']),或 ['all'] 表示全部保留",
+      },
+      categories: {
+        type: "object",
+        additionalProperties: true,
+        description: "可选:时间→分类名 的映射(如 {'14:30':'数学'}),缺省归入『未分类』",
+      },
+      summaryTitle: { type: "string", description: "可选:当日总结标题" },
+    },
+    async execute(args) {
+      const date = args.date || todayString();
+      const keepRaw = Array.isArray(args.keep) ? args.keep : ["all"];
+      const keep = keepRaw.includes("all") ? null : keepRaw;
+      const result = organizeDay(liveConfig, {
+        date,
+        keep,
+        categories: args.categories ?? {},
+        summaryTitle: args.summaryTitle ?? "",
+      });
+      return [
+        `日期:${result.date}`,
+        `保留:${result.keptCount} 条,丢弃:${result.discardedCount} 条`,
+        `分类:${JSON.stringify(result.categories)}`,
+        `总结:${result.summaryPath}`,
+        `归档:${result.archived ?? "无"}`,
+        `生成笔记:`,
+        ...result.files.map((f) => `  ${f}`),
+      ].join("\n");
+    },
+  }));
+}
+
+function textTool(definition) {
+  return defineTool({
+    ...definition,
+    output: {
+      schema: { type: "string" },
+      render: (_args, value) => [{ type: "text", text: value }],
+    },
+    presentCall: (args) => ({
+      card: "generic",
+      kind: "text",
+      title: definition.name,
+      rawInput: args,
+    }),
+  });
+}

package/ocr.mjs

@@ -0,0 +1,55 @@
+import { readFileSync } from "node:fs";
+
+/** 通义千问多模态 OCR。key 优先取配置,其次环境变量 DASHSCOPE_API_KEY。 */
+export async function ocrImage(config, imagePath) {
+  const mode = config.ocr?.mode ?? "off";
+  if (mode === "off") return "";
+  if (mode === "qwen") return ocrQwen(config, imagePath);
+  throw new Error(`OCR: 未知模式 ${mode}`);
+}
+
+async function ocrQwen(config, imagePath) {
+  const apiKey = config.ocr?.apiKey || process.env.DASHSCOPE_API_KEY;
+  if (!apiKey) throw new Error("OCR: 未配置通义 API key(配置 config.json 或环境变量 DASHSCOPE_API_KEY)");
+
+  const b64 = readFileSync(imagePath).toString("base64");
+  const mime = imagePath.toLowerCase().endsWith(".png") ? "image/png" : "image/jpeg";
+  const endpoint = config.ocr?.endpoint ?? "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions";
+  const model = config.ocr?.model ?? "qwen-vl-plus";
+  const prompt = config.ocr?.prompt ?? "请识别图片中的全部文字内容,原样输出;数学公式用 LaTeX 输出。只输出识别结果,不要任何解释。";
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 60000);
+  try {
+    const res = await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+      },
+      body: JSON.stringify({
+        model,
+        messages: [
+          {
+            role: "user",
+            content: [
+              { type: "image_url", image_url: { url: `data:${mime};base64,${b64}` } },
+              { type: "text", text: prompt },
+            ],
+          },
+        ],
+      }),
+      signal: controller.signal,
+    });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      throw new Error(`OCR: 通义接口 ${res.status} ${body.slice(0, 300)}`);
+    }
+    const data = await res.json();
+    const text = data?.choices?.[0]?.message?.content;
+    if (typeof text !== "string") throw new Error("OCR: 通义返回格式异常");
+    return text.trim();
+  } finally {
+    clearTimeout(timer);
+  }
+}

package/organize.mjs

@@ -0,0 +1,155 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { ensureVault } from "./config.mjs";
+import { archiveDailyNote, parseEntries, readDailyNote } from "./storage.mjs";
+
+/**
+ * 晚间整理(MVP):
+ *   输入: 保留的条目列表 + 分类映射 + 当日总结标题
+ *   输出: 知识库/<分类>/<date>_<time>_<kind>.md(含图片/OCR/相关双链)
+ *         知识库/<分类>/INDEX.md 索引
+ *         总结/<date>.md 当日总结(链接全部保留条目 + 上一篇总结)
+ *         收件箱当天笔记移入归档
+ * 所有双链均为确定性生成(按文件名),不是 AI 自由文本。
+ */
+
+function escFilenamePart(s) {
+  return s.replace(/[\\/:*?"<>|]/g, "_").trim();
+}
+
+function noteTitleOf({ time, kind }) {
+  return `截图 ${time}${kind === "文档" ? "" : "（图片）"}`;
+}
+
+export function listEntriesForDate(config, date) {
+  const text = readDailyNote(config, date);
+  return parseEntries(text);
+}
+
+export function organizeDay(config, { date, keep, categories = {}, summaryTitle = "" }) {
+  ensureVault(config);
+  const entries = listEntriesForDate(config, date);
+  const kept = Array.isArray(keep)
+    ? entries.filter((e) => keep.includes(e.time))
+    : entries; // "all"
+
+  const written = [];
+  for (const entry of kept) {
+    const cat = escFilenamePart(categories[entry.time] || "未分类");
+    const file = `${date.replaceAll("-", "")}_${entry.time.replace(":", "")}_${entry.kind}.md`;
+    const notePath = join(config.vaultPath, config.knowledgeFolder, cat, file);
+
+    const prevLinks = previousNotesInCategory(config, cat, file);
+    const backlinks = [`[[${date} 总结]]`];
+    const keyBlock = (entry.note || entry.isKey)
+      ? [
+          "## 重点",
+          "",
+          ...(entry.isKey ? ["# **重点**", ""] : []),
+          ...(entry.note ? [entry.note, ""] : []),
+        ]
+      : [];
+    const body = [
+      "---",
+      `tags: [截图, ${entry.kind}, ${cat}]`,
+      `date: ${date} ${entry.time}`,
+      "---",
+      "",
+      `# ${summaryTitle && categories[entry.time] ? `${summaryTitle}` : noteTitleOf(entry)}`,
+      "",
+      `![[${entry.imageRel.split("/").pop()}]]`,
+      "",
+      ...keyBlock,
+      "## 文字",
+      "",
+      entry.ocrText ? entry.ocrText : "（无 OCR 文字）",
+      "",
+      "## 相关",
+      "",
+      ...prevLinks.map((p) => `- [[${p}]]`),
+      "- [[INDEX]]",
+      ...backlinks.map((b) => `- ${b}`),
+      "",
+    ].join("\n");
+
+    mkdirSync(join(config.vaultPath, config.knowledgeFolder, cat), { recursive: true });
+    writeFileSync(notePath, body, "utf8");
+    written.push({ cat, file, path: notePath, entry });
+    updateIndex(config, cat, file, entry);
+  }
+
+  const summaryPath = writeSummary(config, { date, written, summaryTitle });
+
+  // 收件箱当天笔记 → 归档
+  const archived = archiveDailyNote(config, date);
+
+  return {
+    date,
+    keptCount: kept.length,
+    discardedCount: entries.length - kept.length,
+    categories: Object.fromEntries(written.map((w) => [w.entry.time, w.cat])),
+    summaryPath,
+    archived,
+    files: written.map((w) => w.path),
+  };
+}
+
+function previousNotesInCategory(config, cat, excludeFile) {
+  const dir = join(config.vaultPath, config.knowledgeFolder, cat);
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir)
+    .filter((f) => f.endsWith(".md") && f !== "INDEX.md" && f !== excludeFile)
+    .sort()
+    .map((f) => f.replace(/\.md$/, ""));
+}
+
+function updateIndex(config, cat, file, entry) {
+  const dir = join(config.vaultPath, config.knowledgeFolder, cat);
+  const indexPath = join(dir, "INDEX.md");
+  const title = noteTitleOf(entry);
+  const line = `- [[${file.replace(/\.md$/, "")}]] — ${title}`;
+  let text = "";
+  if (existsSync(indexPath)) {
+    text = readFileSync(indexPath, "utf8");
+    if (!text.includes(`[[${file.replace(/\.md$/, "")}]]`)) text += line + "\n";
+  } else {
+    text = [`# ${cat}`, "", `> 该分类下的截图笔记索引(晚间整理自动生成)。`, "", line, ""].join("\n");
+  }
+  writeFileSync(indexPath, text, "utf8");
+}
+
+function writeSummary(config, { date, written, summaryTitle }) {
+  const dir = join(config.vaultPath, config.summaryFolder);
+  mkdirSync(dir, { recursive: true });
+  const path = join(dir, `${date}.md`);
+  const title = summaryTitle || `${date} 当日总结`;
+  const lines = [
+    "---",
+    "tags: [总结]",
+    "date: " + date,
+    "---",
+    "",
+    `# ${title}`,
+    "",
+    "## 今日留存",
+    "",
+    ...written.map((w) => `- [[${w.file.replace(/\.md$/, "")}]] — ${w.entry.time} ${w.entry.kind}（${w.cat}）`),
+    "",
+  ];
+  const prev = previousSummary(config, date);
+  if (prev.length > 0) {
+    lines.push("## 上一篇总结", "", ...prev.map((p) => `- [[${p}]]`), "");
+  }
+  writeFileSync(path, lines.join("\n"), "utf8");
+  return path;
+}
+
+function previousSummary(config, date) {
+  const dir = join(config.vaultPath, config.summaryFolder);
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir)
+    .filter((f) => f.endsWith(".md") && f !== `${date}.md`)
+    .sort()
+    .slice(-3)
+    .map((f) => f.replace(/\.md$/, ""));
+}