@tnotesjs/core 0.0.6 → 0.0.8

package/dist/{chunk-JDVN2QYW.js → chunk-JUMVJKWV.js}

@@ -3,40 +3,6 @@ import {
   getConfigManager
 } from "./chunk-NASIL5FY.js";
 
-// commands/models.ts
-var COMMAND_NAMES = {
-  BUILD: "build",
-  CREATE_NOTES: "create-notes",
-  DEV: "dev",
-  FIX_TIMESTAMPS: "fix-timestamps",
-  HELP: "help",
-  PREVIEW: "preview",
-  PULL: "pull",
-  PUSH: "push",
-  RENAME_NOTE: "rename-note",
-  UPDATE: "update",
-  UPDATE_COMPLETED_COUNT: "update-completed-count",
-  UPDATE_NOTE_CONFIG: "update-note-config"
-};
-var COMMAND_DESCRIPTIONS = {
-  [COMMAND_NAMES.DEV]: "\u542F\u52A8\u77E5\u8BC6\u5E93\u5F00\u53D1\u670D\u52A1",
-  [COMMAND_NAMES.BUILD]: "\u6784\u5EFA\u77E5\u8BC6\u5E93",
-  [COMMAND_NAMES.PREVIEW]: "\u9884\u89C8\u6784\u5EFA\u540E\u7684\u77E5\u8BC6\u5E93",
-  [COMMAND_NAMES.UPDATE]: "\u6839\u636E\u7B14\u8BB0\u5185\u5BB9\u66F4\u65B0\u77E5\u8BC6\u5E93",
-  [COMMAND_NAMES.UPDATE_COMPLETED_COUNT]: "\u66F4\u65B0\u5B8C\u6210\u7B14\u8BB0\u6570\u91CF\u5386\u53F2\u8BB0\u5F55\uFF08\u8FD1 1 \u5E74\uFF0C\u6700\u8FD1 12 \u4E2A\u6708\uFF09",
-  [COMMAND_NAMES.CREATE_NOTES]: "\u65B0\u5EFA\u7B14\u8BB0\uFF08\u652F\u6301\u6279\u91CF\u521B\u5EFA\uFF09",
-  [COMMAND_NAMES.PUSH]: "\u5C06\u77E5\u8BC6\u5E93\u63A8\u9001\u5230 GitHub",
-  [COMMAND_NAMES.PULL]: "\u5C06 GitHub \u7684\u77E5\u8BC6\u5E93\u62C9\u4E0B\u6765",
-  [COMMAND_NAMES.FIX_TIMESTAMPS]: "\u4FEE\u590D\u6240\u6709\u7B14\u8BB0\u7684\u65F6\u95F4\u6233\uFF08\u57FA\u4E8E git \u5386\u53F2\uFF09",
-  [COMMAND_NAMES.UPDATE_NOTE_CONFIG]: "\u66F4\u65B0\u7B14\u8BB0\u914D\u7F6E\u6587\u4EF6",
-  [COMMAND_NAMES.RENAME_NOTE]: "\u91CD\u547D\u540D\u7B14\u8BB0",
-  [COMMAND_NAMES.HELP]: "\u663E\u793A\u5E2E\u52A9\u4FE1\u606F"
-};
-var COMMAND_OPTIONS = {
-  QUIET: "quiet",
-  FORCE: "force"
-};
-
 // utils/errorHandler.ts
 var TNotesError = class _TNotesError extends Error {
   constructor(message, code = "UNKNOWN" /* UNKNOWN */, context) {
@@ -399,8 +365,8 @@ var genHierarchicalSidebar = (itemList, titles, titlesNotesCount, sidebarIsColla
 };
 
 // utils/getChangedIds.ts
-import path from "path";
 import { execSync } from "child_process";
+import path from "path";
 function getChangedIds() {
   const changedFiles = execSync(
     `git diff --name-only HEAD -- "notes/[0-9][0-9][0-9][0-9]*/README.md"`
@@ -419,7 +385,7 @@ function createAddNumberToTitle() {
   const titleNumbers = Array(7).fill(0);
   return function addNumberToTitle(title) {
     const match = title.match(
-      /^(\#+)\s*((\d+(\.\d*)?(\.\d*)?(\.\d*)?(\.\d*)?(\.\d*)?)\.\s*)?(.*)/
+      /^(#+)\s*((\d+(\.\d*)?(\.\d*)?(\.\d*)?(\.\d*)?(\.\d*)?)\.\s*)?(.*)/
     );
     const plainTitle = match ? match[9].trim() : title.trim();
     const level = title.indexOf(" ");
@@ -1006,7 +972,7 @@ function buildNoteLink(note, repoOwner, repoName2) {
 }
 function updateNoteStatus(note) {
   let status = " ";
-  let deprecatedMark = "";
+  const deprecatedMark = "";
   if (note.config) {
     if (note.config.done) {
       status = "x";
@@ -1140,6 +1106,40 @@ function validateNoteTitle(title) {
   return { valid: true };
 }
 
+// commands/models.ts
+var COMMAND_NAMES = {
+  BUILD: "build",
+  CREATE_NOTES: "create-notes",
+  DEV: "dev",
+  FIX_TIMESTAMPS: "fix-timestamps",
+  HELP: "help",
+  PREVIEW: "preview",
+  PULL: "pull",
+  PUSH: "push",
+  RENAME_NOTE: "rename-note",
+  UPDATE: "update",
+  UPDATE_COMPLETED_COUNT: "update-completed-count",
+  UPDATE_NOTE_CONFIG: "update-note-config"
+};
+var COMMAND_DESCRIPTIONS = {
+  [COMMAND_NAMES.DEV]: "\u542F\u52A8\u77E5\u8BC6\u5E93\u5F00\u53D1\u670D\u52A1",
+  [COMMAND_NAMES.BUILD]: "\u6784\u5EFA\u77E5\u8BC6\u5E93",
+  [COMMAND_NAMES.PREVIEW]: "\u9884\u89C8\u6784\u5EFA\u540E\u7684\u77E5\u8BC6\u5E93",
+  [COMMAND_NAMES.UPDATE]: "\u6839\u636E\u7B14\u8BB0\u5185\u5BB9\u66F4\u65B0\u77E5\u8BC6\u5E93",
+  [COMMAND_NAMES.UPDATE_COMPLETED_COUNT]: "\u66F4\u65B0\u5B8C\u6210\u7B14\u8BB0\u6570\u91CF\u5386\u53F2\u8BB0\u5F55\uFF08\u8FD1 1 \u5E74\uFF0C\u6700\u8FD1 12 \u4E2A\u6708\uFF09",
+  [COMMAND_NAMES.CREATE_NOTES]: "\u65B0\u5EFA\u7B14\u8BB0\uFF08\u652F\u6301\u6279\u91CF\u521B\u5EFA\uFF09",
+  [COMMAND_NAMES.PUSH]: "\u5C06\u77E5\u8BC6\u5E93\u63A8\u9001\u5230 GitHub",
+  [COMMAND_NAMES.PULL]: "\u5C06 GitHub \u7684\u77E5\u8BC6\u5E93\u62C9\u4E0B\u6765",
+  [COMMAND_NAMES.FIX_TIMESTAMPS]: "\u4FEE\u590D\u6240\u6709\u7B14\u8BB0\u7684\u65F6\u95F4\u6233\uFF08\u57FA\u4E8E git \u5386\u53F2\uFF09",
+  [COMMAND_NAMES.UPDATE_NOTE_CONFIG]: "\u66F4\u65B0\u7B14\u8BB0\u914D\u7F6E\u6587\u4EF6",
+  [COMMAND_NAMES.RENAME_NOTE]: "\u91CD\u547D\u540D\u7B14\u8BB0",
+  [COMMAND_NAMES.HELP]: "\u663E\u793A\u5E2E\u52A9\u4FE1\u606F"
+};
+var COMMAND_OPTIONS = {
+  QUIET: "quiet",
+  FORCE: "force"
+};
+
 // core/NoteIndexCache.ts
 import { join as join2 } from "path";
 var NoteIndexCache = class _NoteIndexCache {
@@ -1338,7 +1338,7 @@ var TocGenerator = class {
         titles.push(numberedTitle);
         lines[i] = numberedTitle;
       } else if (isUnnumberedHeader) {
-        const match = line.match(/^(\#+)\s*(\d+(\.\d+)*\.\s*)?(.*)/);
+        const match = line.match(/^(#+)\s*(\d+(\.\d+)*\.\s*)?(.*)/);
         if (match) {
           const headerSymbol = match[1];
           const plainTitle = match[4];
@@ -1373,7 +1373,7 @@ var TocGenerator = class {
         });
       }
       if (noteConfig.yuque.length > 0) {
-        noteConfig.yuque.forEach((slug, i) => {
+        noteConfig.yuque.forEach((slug) => {
           yuqueTOCItems.push(
             `  - [TNotes.yuque.${repoName2.replace(
               "TNotes.",
@@ -1416,9 +1416,9 @@ var TocGenerator = class {
    * 更新首页目录
    * @param lines - 首页内容行数组
    * @param titles - 标题数组
-   * @param titlesNotesCount - 每个标题下的笔记数量
+  * @param _titlesNotesCount - 每个标题下的笔记数量
    */
-  updateHomeToc(lines, titles, titlesNotesCount) {
+  updateHomeToc(lines, titles, _titlesNotesCount) {
     let startLineIdx = -1, endLineIdx = -1;
     lines.forEach((line, idx) => {
       if (line.startsWith(NOTES_TOC_START_TAG)) startLineIdx = idx;
@@ -1740,7 +1740,6 @@ var GitManager = class {
       didStash = await this.stash("Auto-stash before pull");
     }
     try {
-      const status = await this.getStatus();
       const beforeCommit = await runCommand("git rev-parse HEAD", this.dir);
       this.logger.info("\u6B63\u5728\u62C9\u53D6\u8FDC\u7A0B\u66F4\u65B0...");
       const cmd = `git pull ${rebase ? "--rebase" : ""} ${autostash ? "--autostash" : ""}`.trim();
@@ -2054,41 +2053,165 @@ var ProcessManager = class {
   }
 };
 
-// commands/BaseCommand.ts
-var BaseCommand = class {
-  constructor(name) {
-    this.name = name;
-    this.logger = logger.child(name);
+// services/file-watcher/configChangeHandler.ts
+var ConfigChangeHandler = class {
+  constructor(config2) {
+    this.config = config2;
   }
-  logger;
-  options = {};
-  /** 命令描述（从静态配置读取） */
-  get description() {
-    return COMMAND_DESCRIPTIONS[this.name];
+  async handle(events) {
+    if (events.length === 0) return [];
+    const changedIndexes = [];
+    const { state, noteService, noteIndexCache, logger: logger2 } = this.config;
+    for (const change of events) {
+      if (noteService.shouldIgnoreConfigChange(change.path)) {
+        logger2.debug(`\u5FFD\u7565 API \u5199\u5165\u7684\u914D\u7F6E\u6587\u4EF6: ${change.path}`);
+        continue;
+      }
+      const snapshot = state.readConfigSnapshot(change.path);
+      if (!snapshot) continue;
+      const cached = state.getConfigSnapshot(change.path);
+      state.setConfigSnapshot(change.path, snapshot);
+      noteIndexCache.updateConfig(change.noteIndex, snapshot);
+      if (!cached) continue;
+      const statusChanged = cached.done !== snapshot.done;
+      const otherChanged = cached.enableDiscussions !== snapshot.enableDiscussions || cached.description !== snapshot.description;
+      if (statusChanged) {
+        changedIndexes.push(change.noteIndex);
+        logger2.info(`\u68C0\u6D4B\u5230\u914D\u7F6E\u72B6\u6001\u53D8\u5316: done(${cached.done}\u2192${snapshot.done})`);
+      } else if (otherChanged) {
+        logger2.info("\u68C0\u6D4B\u5230\u914D\u7F6E\u975E\u72B6\u6001\u5B57\u6BB5\u53D8\u5316\uFF0C\u5DF2\u5237\u65B0\u7F13\u5B58\uFF08\u65E0\u9700\u5168\u5C40\u66F4\u65B0\uFF09");
+      }
+    }
+    return changedIndexes;
+  }
+};
+
+// services/file-watcher/eventScheduler.ts
+var DEFAULT_DEBOUNCE_MS = 1e3;
+var DEFAULT_BATCH_WINDOW_MS = 1e3;
+var DEFAULT_BATCH_THRESHOLD = 3;
+var DEFAULT_BATCH_BUFFER_MS = 2e3;
+var EventScheduler = class {
+  constructor(config2) {
+    this.config = config2;
+    this.debounceMs = config2.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    this.batchWindowMs = config2.batchWindowMs ?? DEFAULT_BATCH_WINDOW_MS;
+    this.batchThreshold = config2.batchThreshold ?? DEFAULT_BATCH_THRESHOLD;
+    this.batchBufferMs = config2.batchBufferMs ?? DEFAULT_BATCH_BUFFER_MS;
+  }
+  /** 待处理的文件变更事件队列 */
+  pendingEvents = /* @__PURE__ */ new Map();
+  /** 防抖定时器 */
+  updateTimer = null;
+  /** 批量更新恢复定时器 */
+  batchResumeTimer = null;
+  /** 记录最近的变更时间戳 */
+  recentChanges = [];
+  /** 标记是否正在更新，避免循环触发 - 类似一把更新行为锁 */
+  isUpdating = false;
+  debounceMs;
+  batchWindowMs;
+  batchThreshold;
+  batchBufferMs;
+  /**
+   * 设置更新状态锁，用于防止在执行耗时更新操作时被新的文件变更事件打断
+   *
+   * @param flag - true 表示正在更新（锁定），false 表示更新完成（解锁）
+   */
+  setUpdating(flag) {
+    this.isUpdating = flag;
   }
   /**
-   * 设置命令选项
+   * 获取当前是否处于更新锁定状态
+   *
+   * @returns true 表示正在执行更新操作（事件处理被暂停），false 表示空闲可处理新事件
    */
-  setOptions(options) {
-    this.options = { ...this.options, ...options };
+  getUpdating() {
+    return this.isUpdating;
   }
   /**
-   * 执行命令（带错误处理）
+   * 将文件变更事件加入待处理队列，并启动防抖定时器
+   *
+   * - 若同一文件路径的事件已存在，则忽略重复事件（去重）
+   * - 每次新事件都会重置防抖计时器，确保在变更停止后才触发处理
+   *
+   * @param event 文件变更事件
    */
-  async execute() {
-    const startTime = Date.now();
-    try {
-      this.logger.start(this.description);
-      await this.run();
-      const duration = Date.now() - startTime;
-      this.logger.done(`\u547D\u4EE4\u6267\u884C\u8017\u65F6\uFF1A${duration} ms`);
-    } catch (error) {
-      handleError(error);
-      throw error;
+  enqueue(event) {
+    if (this.pendingEvents.has(event.path)) return;
+    this.pendingEvents.set(event.path, event);
+    if (this.updateTimer) clearTimeout(this.updateTimer);
+    this.updateTimer = setTimeout(() => this.flush(), this.debounceMs);
+  }
+  /**
+   * 立即触发事件队列的处理（防抖到期或手动调用）
+   *
+   * - 若当前正在更新（isUpdating 为 true），则跳过以避免重复处理
+   * - 清空待处理事件队列，并通过 onFlush 回调交由上层服务处理
+   * - 处理开始后会锁定更新状态，防止处理过程中被新事件打断
+   */
+  flush() {
+    if (this.isUpdating) return;
+    if (this.pendingEvents.size === 0) return;
+    const events = Array.from(this.pendingEvents.values());
+    this.pendingEvents.clear();
+    this.isUpdating = true;
+    this.config.onFlush(events);
+  }
+  /**
+   * 记录当前变更时间并检测是否触发批量更新模式
+   *
+   * - 维护一个滑动时间窗口（BATCH_UPDATE_WINDOW_MS）内的变更记录
+   * - 若短时间内（1秒内）变更次数达到阈值（BATCH_UPDATE_THRESHOLD = 3），则判定为批量操作
+   * - 触发批量模式后：
+   *   1. 清空当前待处理事件队列，避免重复处理
+   *   2. 锁定更新状态（isUpdating = true）
+   *   3. 暂停监听服务，并在延迟（窗口 + 缓冲时间）后自动恢复
+   *
+   * @param now 当前时间戳（默认使用 Date.now()）
+   * @returns true 表示已触发批量更新模式，false 表示仍处于普通监听模式
+   */
+  recordChangeAndDetectBatch(now = Date.now()) {
+    this.recentChanges.push(now);
+    this.recentChanges = this.recentChanges.filter(
+      (t) => now - t < this.batchWindowMs
+    );
+    if (this.recentChanges.length < this.batchThreshold) return false;
+    this.pendingEvents.clear();
+    this.recentChanges = [];
+    this.isUpdating = true;
+    this.config.onPauseForBatch();
+    this.batchResumeTimer = setTimeout(() => {
+      this.batchResumeTimer = null;
+      this.isUpdating = false;
+      this.config.reinit();
+      this.config.onResumeAfterBatch();
+    }, this.batchWindowMs + this.batchBufferMs);
+    return true;
+  }
+  /**
+   * 清理所有定时器，释放资源
+   *
+   * 在服务停止时调用，防止定时器在服务销毁后仍然触发回调
+   */
+  clearTimers() {
+    if (this.updateTimer) {
+      clearTimeout(this.updateTimer);
+      this.updateTimer = null;
+    }
+    if (this.batchResumeTimer) {
+      clearTimeout(this.batchResumeTimer);
+      this.batchResumeTimer = null;
     }
+    this.pendingEvents.clear();
+    this.recentChanges = [];
   }
 };
 
+// services/file-watcher/folderChangeHandler.ts
+import { existsSync as existsSync3, promises as fsPromises } from "fs";
+import { join as join3 } from "path";
+
 // services/file-watcher/internal.ts
 var WATCH_EVENT_TYPES = {
   README: "readme",
@@ -2104,448 +2227,11 @@ async function safeExecute(label, fn, logger2) {
   }
 }
 
-// services/file-watcher/watchState.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync } from "fs";
-import { createHash } from "crypto";
-import { join as join3 } from "path";
-var WatchState = class {
-  constructor(config2) {
-    this.config = config2;
-  }
-  /** 文件哈希缓存 */
-  fileHashes = /* @__PURE__ */ new Map();
-  /** 笔记目录缓存 */
-  noteDirCache = /* @__PURE__ */ new Set();
-  /** 笔记配置缓存 */
-  configCache = /* @__PURE__ */ new Map();
-  /**
-   * 获取指定文件的 MD5 哈希值，若文件不存在或读取失败返回 null
-   *
-   * @param filePath 文件路径
-   * @returns 文件哈希
-   */
-  getFileHash(filePath) {
-    try {
-      if (!existsSync3(filePath)) return null;
-      const content = readFileSync3(filePath, "utf-8");
-      if (content.length === 0) return null;
-      return createHash("md5").update(content).digest("hex");
-    } catch {
-      return null;
-    }
-  }
-  /**
-   * 更新文件哈希缓存，只有当文件内容发生变化时才更新并返回 true
-   *
-   * @param filePath 文件路径
-   * @returns 是否发生变化
-   */
-  updateFileHash(filePath) {
-    const current = this.getFileHash(filePath);
-    if (!current) return false;
-    const prev = this.fileHashes.get(filePath);
-    if (prev === current) return false;
-    this.fileHashes.set(filePath, current);
-    return true;
-  }
-  /**
-   * 检查指定名称的笔记目录是否已存在于缓存中
-   *
-   * @param name 笔记目录名称
-   * @returns 若存在则返回 true，否则返回 false
-   */
-  hasNoteDir(name) {
-    return this.noteDirCache.has(name);
-  }
-  /**
-   * 将指定名称的笔记目录添加到缓存中
-   *
-   * @param name 笔记目录名称
-   */
-  addNoteDir(name) {
-    this.noteDirCache.add(name);
-  }
-  /**
-   * 从缓存中移除指定名称的笔记目录
-   *
-   * @param name 笔记目录名称
-   */
-  deleteNoteDir(name) {
-    this.noteDirCache.delete(name);
-  }
-  /**
-   * 清空所有缓存数据，包括文件哈希、笔记目录和配置快照
-   */
-  clearAll() {
-    this.fileHashes.clear();
-    this.noteDirCache.clear();
-    this.configCache.clear();
-  }
-  /**
-   * 清除指定笔记目录相关的缓存数据，包括 README.md 和 .tnotes.json 的文件哈希及配置快照
-   *
-   * @param noteDirName 笔记目录名称
-   */
-  clearNoteCaches(noteDirName) {
-    const readmePath = join3(this.config.notesDir, noteDirName, "README.md");
-    const configPath = join3(this.config.notesDir, noteDirName, ".tnotes.json");
-    this.fileHashes.delete(readmePath);
-    this.fileHashes.delete(configPath);
-    this.configCache.delete(configPath);
-  }
-  /**
-   * 获取指定配置文件路径对应的配置快照
-   *
-   * @param configPath 配置文件路径（通常为 .tnotes.json 的绝对路径）
-   * @returns 配置快照，若不存在则返回 undefined
-   */
-  getConfigSnapshot(configPath) {
-    return this.configCache.get(configPath);
-  }
-  /**
-   * 设置指定配置文件路径的配置快照到缓存中
-   *
-   * @param configPath 配置文件路径（通常为 .tnotes.json 的绝对路径）
-   * @param snapshot 配置快照对象
-   */
-  setConfigSnapshot(configPath, snapshot) {
-    this.configCache.set(configPath, snapshot);
-  }
-  /**
-   * 读取指定配置文件的快照
-   *
-   * 解析 .tnotes.json 配置文件，提取 done、enableDiscussions、description 字段。
-   *
-   * @param configPath 配置文件路径（通常为 .tnotes.json 的绝对路径）
-   * @returns 配置快照，若文件不存在或解析失败则返回 null
-   */
-  readConfigSnapshot(configPath) {
-    try {
-      if (!existsSync3(configPath)) return null;
-      const content = readFileSync3(configPath, "utf-8");
-      const config2 = JSON.parse(content);
-      return {
-        done: Boolean(config2.done),
-        enableDiscussions: Boolean(config2.enableDiscussions),
-        description: config2.description || ""
-      };
-    } catch (error) {
-      this.config.logger.error(`[\u8BFB\u53D6\u914D\u7F6E\u5FEB\u7167] ${error}`);
-      return null;
-    }
-  }
-  /**
-   * 从磁盘初始化监听状态缓存：
-   * 遍历笔记根目录下的所有子目录，将每个笔记目录的 README.md 和 .tnotes.json
-   * 的哈希值及配置快照加载到缓存中。
-   */
-  initializeFromDisk() {
-    try {
-      const noteDirs = readdirSync2(this.config.notesDir);
-      this.clearAll();
-      for (const noteDir of noteDirs) {
-        const noteDirPath = join3(this.config.notesDir, noteDir);
-        if (!statSync(noteDirPath).isDirectory()) continue;
-        this.noteDirCache.add(noteDir);
-        const readmePath = join3(noteDirPath, "README.md");
-        const readmeHash = this.getFileHash(readmePath);
-        if (readmeHash) this.fileHashes.set(readmePath, readmeHash);
-        const configPath = join3(noteDirPath, ".tnotes.json");
-        const configHash = this.getFileHash(configPath);
-        if (configHash) {
-          this.fileHashes.set(configPath, configHash);
-          const snapshot = this.readConfigSnapshot(configPath);
-          if (snapshot) this.configCache.set(configPath, snapshot);
-        }
-      }
-    } catch (error) {
-      this.config.logger.warn(
-        `[initializeFromDisk] \u521D\u59CB\u5316\u76D1\u542C\u72B6\u6001\u5931\u8D25: ${error}`
-      );
-    }
-  }
-};
-
-// services/file-watcher/eventScheduler.ts
-var DEFAULT_DEBOUNCE_MS = 1e3;
-var DEFAULT_BATCH_WINDOW_MS = 1e3;
-var DEFAULT_BATCH_THRESHOLD = 3;
-var DEFAULT_BATCH_BUFFER_MS = 2e3;
-var EventScheduler = class {
-  constructor(config2) {
-    this.config = config2;
-    this.debounceMs = config2.debounceMs ?? DEFAULT_DEBOUNCE_MS;
-    this.batchWindowMs = config2.batchWindowMs ?? DEFAULT_BATCH_WINDOW_MS;
-    this.batchThreshold = config2.batchThreshold ?? DEFAULT_BATCH_THRESHOLD;
-    this.batchBufferMs = config2.batchBufferMs ?? DEFAULT_BATCH_BUFFER_MS;
-  }
-  /** 待处理的文件变更事件队列 */
-  pendingEvents = /* @__PURE__ */ new Map();
-  /** 防抖定时器 */
-  updateTimer = null;
-  /** 批量更新恢复定时器 */
-  batchResumeTimer = null;
-  /** 记录最近的变更时间戳 */
-  recentChanges = [];
-  /** 标记是否正在更新，避免循环触发 - 类似一把更新行为锁 */
-  isUpdating = false;
-  debounceMs;
-  batchWindowMs;
-  batchThreshold;
-  batchBufferMs;
-  /**
-   * 设置更新状态锁，用于防止在执行耗时更新操作时被新的文件变更事件打断
-   *
-   * @param flag - true 表示正在更新（锁定），false 表示更新完成（解锁）
-   */
-  setUpdating(flag) {
-    this.isUpdating = flag;
-  }
-  /**
-   * 获取当前是否处于更新锁定状态
-   *
-   * @returns true 表示正在执行更新操作（事件处理被暂停），false 表示空闲可处理新事件
-   */
-  getUpdating() {
-    return this.isUpdating;
-  }
-  /**
-   * 将文件变更事件加入待处理队列，并启动防抖定时器
-   *
-   * - 若同一文件路径的事件已存在，则忽略重复事件（去重）
-   * - 每次新事件都会重置防抖计时器，确保在变更停止后才触发处理
-   *
-   * @param event 文件变更事件
-   */
-  enqueue(event) {
-    if (this.pendingEvents.has(event.path)) return;
-    this.pendingEvents.set(event.path, event);
-    if (this.updateTimer) clearTimeout(this.updateTimer);
-    this.updateTimer = setTimeout(() => this.flush(), this.debounceMs);
-  }
-  /**
-   * 立即触发事件队列的处理（防抖到期或手动调用）
-   *
-   * - 若当前正在更新（isUpdating 为 true），则跳过以避免重复处理
-   * - 清空待处理事件队列，并通过 onFlush 回调交由上层服务处理
-   * - 处理开始后会锁定更新状态，防止处理过程中被新事件打断
-   */
-  flush() {
-    if (this.isUpdating) return;
-    if (this.pendingEvents.size === 0) return;
-    const events = Array.from(this.pendingEvents.values());
-    this.pendingEvents.clear();
-    this.isUpdating = true;
-    this.config.onFlush(events);
-  }
-  /**
-   * 记录当前变更时间并检测是否触发批量更新模式
-   *
-   * - 维护一个滑动时间窗口（BATCH_UPDATE_WINDOW_MS）内的变更记录
-   * - 若短时间内（1秒内）变更次数达到阈值（BATCH_UPDATE_THRESHOLD = 3），则判定为批量操作
-   * - 触发批量模式后：
-   *   1. 清空当前待处理事件队列，避免重复处理
-   *   2. 锁定更新状态（isUpdating = true）
-   *   3. 暂停监听服务，并在延迟（窗口 + 缓冲时间）后自动恢复
-   *
-   * @param now 当前时间戳（默认使用 Date.now()）
-   * @returns true 表示已触发批量更新模式，false 表示仍处于普通监听模式
-   */
-  recordChangeAndDetectBatch(now = Date.now()) {
-    this.recentChanges.push(now);
-    this.recentChanges = this.recentChanges.filter(
-      (t) => now - t < this.batchWindowMs
-    );
-    if (this.recentChanges.length < this.batchThreshold) return false;
-    this.pendingEvents.clear();
-    this.recentChanges = [];
-    this.isUpdating = true;
-    this.config.onPauseForBatch();
-    this.batchResumeTimer = setTimeout(() => {
-      this.batchResumeTimer = null;
-      this.isUpdating = false;
-      this.config.reinit();
-      this.config.onResumeAfterBatch();
-    }, this.batchWindowMs + this.batchBufferMs);
-    return true;
-  }
-  /**
-   * 清理所有定时器，释放资源
-   *
-   * 在服务停止时调用，防止定时器在服务销毁后仍然触发回调
-   */
-  clearTimers() {
-    if (this.updateTimer) {
-      clearTimeout(this.updateTimer);
-      this.updateTimer = null;
-    }
-    if (this.batchResumeTimer) {
-      clearTimeout(this.batchResumeTimer);
-      this.batchResumeTimer = null;
-    }
-    this.pendingEvents.clear();
-    this.recentChanges = [];
-  }
-};
-
-// services/file-watcher/renameDetector.ts
-import { existsSync as existsSync4 } from "fs";
-import { join as join4 } from "path";
-var FOLDER_RENAME_DETECT_WINDOW_MS = 500;
-var RenameDetector = class {
-  constructor(config2) {
-    this.config = config2;
-  }
-  /** 待处理的文件夹重命名 */
-  pendingFolderRename = null;
-  /** 文件夹重命名检测定时器 */
-  folderRenameTimer = null;
-  handleFsRename(folderName) {
-    const { notesDir, dirCache, logger: logger2, onDelete, onRename } = this.config;
-    const folderPath = join4(notesDir, folderName);
-    const folderExists = existsSync4(folderPath);
-    const noteIndex = NoteManager.extractNoteIndex(folderName);
-    if (!noteIndex) {
-      logger2.warn(`\u65E0\u6CD5\u4ECE\u6587\u4EF6\u5939\u540D\u79F0\u63D0\u53D6\u7B14\u8BB0\u7D22\u5F15: ${folderName}`);
-      return;
-    }
-    if (!folderExists) {
-      if (dirCache.has(folderName)) {
-        logger2.info(`\u68C0\u6D4B\u5230\u6587\u4EF6\u5939\u5220\u9664/\u91CD\u547D\u540D: ${folderName}`);
-        this.pendingFolderRename = { oldName: folderName, time: Date.now() };
-        if (this.folderRenameTimer) clearTimeout(this.folderRenameTimer);
-        this.folderRenameTimer = setTimeout(() => {
-          if (this.pendingFolderRename) {
-            logger2.warn(`\u68C0\u6D4B\u5230\u7B14\u8BB0\u5220\u9664: ${this.pendingFolderRename.oldName}`);
-            onDelete(this.pendingFolderRename.oldName);
-          }
-          this.pendingFolderRename = null;
-          this.folderRenameTimer = null;
-        }, FOLDER_RENAME_DETECT_WINDOW_MS);
-      }
-      return;
-    }
-    if (!dirCache.has(folderName)) {
-      logger2.info(`\u68C0\u6D4B\u5230\u6587\u4EF6\u5939\u521B\u5EFA/\u91CD\u547D\u540D: ${folderName}`);
-      if (this.pendingFolderRename && Date.now() - this.pendingFolderRename.time < FOLDER_RENAME_DETECT_WINDOW_MS) {
-        const oldName = this.pendingFolderRename.oldName;
-        const oldNoteIndex = NoteManager.extractNoteIndex(oldName);
-        if (oldNoteIndex && oldNoteIndex === noteIndex) {
-          logger2.info(`\u68C0\u6D4B\u5230\u6587\u4EF6\u5939\u91CD\u547D\u540D: ${oldName} \u2192 ${folderName}`);
-          if (this.folderRenameTimer) {
-            clearTimeout(this.folderRenameTimer);
-            this.folderRenameTimer = null;
-          }
-          onRename(oldName, folderName);
-          this.pendingFolderRename = null;
-        } else if (oldNoteIndex && oldNoteIndex !== noteIndex) {
-          logger2.warn(`\u7D22\u5F15\u51B2\u7A81\uFF0C\u56DE\u9000: ${oldName} -> ${folderName}`);
-        }
-      }
-      dirCache.add(folderName);
-      if (this.pendingFolderRename) {
-        dirCache.delete(this.pendingFolderRename.oldName);
-      }
-    }
-  }
-  clearTimers() {
-    if (this.folderRenameTimer) {
-      clearTimeout(this.folderRenameTimer);
-      this.folderRenameTimer = null;
-    }
-    this.pendingFolderRename = null;
-  }
-};
-
-// services/file-watcher/configChangeHandler.ts
-var ConfigChangeHandler = class {
-  constructor(config2) {
-    this.config = config2;
-  }
-  async handle(events) {
-    if (events.length === 0) return [];
-    const changedIndexes = [];
-    const { state, noteService, noteIndexCache, logger: logger2 } = this.config;
-    for (const change of events) {
-      if (noteService.shouldIgnoreConfigChange(change.path)) {
-        logger2.debug(`\u5FFD\u7565 API \u5199\u5165\u7684\u914D\u7F6E\u6587\u4EF6: ${change.path}`);
-        continue;
-      }
-      const snapshot = state.readConfigSnapshot(change.path);
-      if (!snapshot) continue;
-      const cached = state.getConfigSnapshot(change.path);
-      state.setConfigSnapshot(change.path, snapshot);
-      noteIndexCache.updateConfig(change.noteIndex, snapshot);
-      if (!cached) continue;
-      const statusChanged = cached.done !== snapshot.done;
-      const otherChanged = cached.enableDiscussions !== snapshot.enableDiscussions || cached.description !== snapshot.description;
-      if (statusChanged) {
-        changedIndexes.push(change.noteIndex);
-        logger2.info(`\u68C0\u6D4B\u5230\u914D\u7F6E\u72B6\u6001\u53D8\u5316: done(${cached.done}\u2192${snapshot.done})`);
-      } else if (otherChanged) {
-        logger2.info("\u68C0\u6D4B\u5230\u914D\u7F6E\u975E\u72B6\u6001\u5B57\u6BB5\u53D8\u5316\uFF0C\u5DF2\u5237\u65B0\u7F13\u5B58\uFF08\u65E0\u9700\u5168\u5C40\u66F4\u65B0\uFF09");
-      }
-    }
-    return changedIndexes;
-  }
-};
-
-// services/file-watcher/readmeChangeHandler.ts
-var ReadmeChangeHandler = class {
-  constructor(config2) {
-    this.config = config2;
-  }
-  async handle(events) {
-    if (events.length === 0) return;
-    const indexes = [...new Set(events.map((c) => c.noteIndex))];
-    for (const noteIndex of indexes) {
-      const noteInfo = this.config.noteService.getNoteByIndex(noteIndex);
-      if (noteInfo) {
-        await this.config.noteService.fixNoteTitle(noteInfo);
-      }
-    }
-  }
-};
-
-// services/file-watcher/globalUpdateCoordinator.ts
-var GlobalUpdateCoordinator = class {
-  constructor(config2) {
-    this.config = config2;
-  }
-  async applyConfigUpdates(changedNoteIndexes) {
-    if (changedNoteIndexes.length === 0) return;
-    const { readmeService, noteIndexCache, logger: logger2 } = this.config;
-    logger2.info("\u68C0\u6D4B\u5230\u7B14\u8BB0\u72B6\u6001\u53D8\u5316\uFF0C\u589E\u91CF\u66F4\u65B0\u5168\u5C40\u6587\u4EF6...");
-    for (const noteIndex of changedNoteIndexes) {
-      await safeExecute(
-        `\u589E\u91CF\u66F4\u65B0 ${noteIndex}`,
-        async () => {
-          const item = noteIndexCache.getByNoteIndex(noteIndex);
-          await readmeService.updateNoteInReadme(
-            noteIndex,
-            item?.noteConfig || {}
-          );
-          logger2.info(`\u589E\u91CF\u66F4\u65B0 README \u4E2D\u7684\u7B14\u8BB0: ${noteIndex}`);
-        },
-        logger2
-      );
-    }
-    await readmeService.regenerateSidebar();
-  }
-  async updateNoteReadmesOnly(events) {
-    const noteIndexesToUpdate = [...new Set(events.map((c) => c.noteIndex))];
-    if (noteIndexesToUpdate.length === 0) return;
-    await this.config.readmeService.updateNoteReadmesOnly(noteIndexesToUpdate);
-  }
-};
-
-// services/file-watcher/folderChangeHandler.ts
-import { existsSync as existsSync5, promises as fsPromises } from "fs";
-import { join as join5 } from "path";
-var RENAME_REVERT_DELAY_MS = 2e3;
-var DELETE_REINIT_DELAY_MS = 1e3;
-var UPDATE_UNLOCK_DELAY_MS = 500;
-var FolderChangeHandler = class {
+// services/file-watcher/folderChangeHandler.ts
+var RENAME_REVERT_DELAY_MS = 2e3;
+var DELETE_REINIT_DELAY_MS = 1e3;
+var UPDATE_UNLOCK_DELAY_MS = 500;
+var FolderChangeHandler = class {
   constructor(config2) {
     this.config = config2;
   }
@@ -2672,104 +2358,396 @@ var FolderChangeHandler = class {
       logger2.error(`\u672A\u627E\u5230\u65B0\u7B14\u8BB0: ${newNoteIndex}`);
     }
   }
-  async revertFolderRename(oldName, newName) {
-    const { notesDir, scheduler, watchState, logger: logger2 } = this.config;
-    try {
-      const oldPath = join5(notesDir, oldName);
-      const newPath = join5(notesDir, newName);
-      if (existsSync5(newPath)) {
-        scheduler.setUpdating(true);
-        await fsPromises.rename(newPath, oldPath);
-        logger2.warn(`\u6587\u4EF6\u5939\u5DF2\u56DE\u9000: ${newName} \u2192 ${oldName}`);
-        this.scheduleTimer(() => {
-          scheduler.setUpdating(false);
-          watchState.initializeFromDisk();
-        }, RENAME_REVERT_DELAY_MS);
-      }
-    } catch (error) {
-      logger2.error(`\u56DE\u9000\u6587\u4EF6\u5939\u91CD\u547D\u540D\u5931\u8D25: ${error}`);
-    }
+  async revertFolderRename(oldName, newName) {
+    const { notesDir, scheduler, watchState, logger: logger2 } = this.config;
+    try {
+      const oldPath = join3(notesDir, oldName);
+      const newPath = join3(notesDir, newName);
+      if (existsSync3(newPath)) {
+        scheduler.setUpdating(true);
+        await fsPromises.rename(newPath, oldPath);
+        logger2.warn(`\u6587\u4EF6\u5939\u5DF2\u56DE\u9000: ${newName} \u2192 ${oldName}`);
+        this.scheduleTimer(() => {
+          scheduler.setUpdating(false);
+          watchState.initializeFromDisk();
+        }, RENAME_REVERT_DELAY_MS);
+      }
+    } catch (error) {
+      logger2.error(`\u56DE\u9000\u6587\u4EF6\u5939\u91CD\u547D\u540D\u5931\u8D25: ${error}`);
+    }
+  }
+  extractNoteIndexOrWarn(name) {
+    const noteIndex = name.match(/^(\d{4})/)?.[1] || null;
+    if (!noteIndex) {
+      this.config.logger.warn(`\u65E0\u6CD5\u4ECE\u6587\u4EF6\u5939\u540D\u79F0\u63D0\u53D6\u7B14\u8BB0\u7D22\u5F15: ${name}`);
+    }
+    return noteIndex;
+  }
+  // #endregion - 私有实现
+};
+
+// services/file-watcher/fsWatcherAdapter.ts
+import { watch } from "fs";
+import { basename, dirname, join as join4, sep } from "path";
+var FsWatcherAdapter = class {
+  constructor(config2) {
+    this.config = config2;
+  }
+  /** 文件系统监听器实例 */
+  watcher = null;
+  start() {
+    const { logger: logger2 } = this.config;
+    if (this.watcher) {
+      logger2.warn("\u6587\u4EF6\u76D1\u542C\u670D\u52A1\u5DF2\u542F\u52A8");
+      return;
+    }
+    this.watcher = watch(
+      this.config.notesDir,
+      { recursive: true },
+      (eventType, filename) => this.handleFsEvent(eventType, filename)
+    );
+    logger2.debug(`\u6587\u4EF6\u76D1\u542C\u5DF2\u542F\u52A8\uFF0C\u76D1\u542C\u76EE\u5F55\uFF1A${this.config.notesDir}`);
+  }
+  stop() {
+    if (!this.watcher) return;
+    this.watcher.close();
+    this.watcher = null;
+  }
+  isWatching() {
+    return this.watcher !== null;
+  }
+  handleFsEvent(eventType, filename) {
+    const { isUpdating, onRename, onNoteEvent } = this.config;
+    if (!filename || // 忽略无文件变更
+    isUpdating()) {
+      return;
+    }
+    if (eventType === "rename" && // 检测文件夹 rename 事件
+    !filename.includes(sep)) {
+      onRename(filename);
+      return;
+    }
+    const baseFilename = basename(filename);
+    if (baseFilename !== "README.md" && baseFilename !== ".tnotes.json") {
+      return;
+    }
+    const fullPath = join4(this.config.notesDir, filename);
+    const event = this.buildWatchEvent(fullPath, filename);
+    if (!event) {
+      return;
+    }
+    onNoteEvent(event);
+  }
+  buildWatchEvent(fullPath, filename) {
+    const noteDirName = basename(dirname(fullPath));
+    const noteIndex = NoteManager.extractNoteIndex(noteDirName);
+    if (!noteIndex) {
+      NoteManager.warnInvalidNoteIndex(noteDirName);
+      return null;
+    }
+    const fileType = filename.endsWith("README.md") ? WATCH_EVENT_TYPES.README : WATCH_EVENT_TYPES.CONFIG;
+    return {
+      path: fullPath,
+      type: fileType,
+      noteIndex,
+      noteDirName,
+      noteDirPath: dirname(fullPath)
+    };
+  }
+};
+
+// services/file-watcher/globalUpdateCoordinator.ts
+var GlobalUpdateCoordinator = class {
+  constructor(config2) {
+    this.config = config2;
+  }
+  async applyConfigUpdates(changedNoteIndexes) {
+    if (changedNoteIndexes.length === 0) return;
+    const { readmeService, noteIndexCache, logger: logger2 } = this.config;
+    logger2.info("\u68C0\u6D4B\u5230\u7B14\u8BB0\u72B6\u6001\u53D8\u5316\uFF0C\u589E\u91CF\u66F4\u65B0\u5168\u5C40\u6587\u4EF6...");
+    for (const noteIndex of changedNoteIndexes) {
+      await safeExecute(
+        `\u589E\u91CF\u66F4\u65B0 ${noteIndex}`,
+        async () => {
+          const item = noteIndexCache.getByNoteIndex(noteIndex);
+          await readmeService.updateNoteInReadme(
+            noteIndex,
+            item?.noteConfig || {}
+          );
+          logger2.info(`\u589E\u91CF\u66F4\u65B0 README \u4E2D\u7684\u7B14\u8BB0: ${noteIndex}`);
+        },
+        logger2
+      );
+    }
+    await readmeService.regenerateSidebar();
+  }
+  async updateNoteReadmesOnly(events) {
+    const noteIndexesToUpdate = [...new Set(events.map((c) => c.noteIndex))];
+    if (noteIndexesToUpdate.length === 0) return;
+    await this.config.readmeService.updateNoteReadmesOnly(noteIndexesToUpdate);
+  }
+};
+
+// services/file-watcher/readmeChangeHandler.ts
+var ReadmeChangeHandler = class {
+  constructor(config2) {
+    this.config = config2;
+  }
+  async handle(events) {
+    if (events.length === 0) return;
+    const indexes = [...new Set(events.map((c) => c.noteIndex))];
+    for (const noteIndex of indexes) {
+      const noteInfo = this.config.noteService.getNoteByIndex(noteIndex);
+      if (noteInfo) {
+        await this.config.noteService.fixNoteTitle(noteInfo);
+      }
+    }
+  }
+};
+
+// services/file-watcher/renameDetector.ts
+import { existsSync as existsSync4 } from "fs";
+import { join as join5 } from "path";
+var FOLDER_RENAME_DETECT_WINDOW_MS = 500;
+var RenameDetector = class {
+  constructor(config2) {
+    this.config = config2;
+  }
+  /** 待处理的文件夹重命名 */
+  pendingFolderRename = null;
+  /** 文件夹重命名检测定时器 */
+  folderRenameTimer = null;
+  handleFsRename(folderName) {
+    const { notesDir, dirCache, logger: logger2, onDelete, onRename } = this.config;
+    const folderPath = join5(notesDir, folderName);
+    const folderExists = existsSync4(folderPath);
+    const noteIndex = NoteManager.extractNoteIndex(folderName);
+    if (!noteIndex) {
+      logger2.warn(`\u65E0\u6CD5\u4ECE\u6587\u4EF6\u5939\u540D\u79F0\u63D0\u53D6\u7B14\u8BB0\u7D22\u5F15: ${folderName}`);
+      return;
+    }
+    if (!folderExists) {
+      if (dirCache.has(folderName)) {
+        logger2.info(`\u68C0\u6D4B\u5230\u6587\u4EF6\u5939\u5220\u9664/\u91CD\u547D\u540D: ${folderName}`);
+        this.pendingFolderRename = { oldName: folderName, time: Date.now() };
+        if (this.folderRenameTimer) clearTimeout(this.folderRenameTimer);
+        this.folderRenameTimer = setTimeout(() => {
+          if (this.pendingFolderRename) {
+            logger2.warn(`\u68C0\u6D4B\u5230\u7B14\u8BB0\u5220\u9664: ${this.pendingFolderRename.oldName}`);
+            onDelete(this.pendingFolderRename.oldName);
+          }
+          this.pendingFolderRename = null;
+          this.folderRenameTimer = null;
+        }, FOLDER_RENAME_DETECT_WINDOW_MS);
+      }
+      return;
+    }
+    if (!dirCache.has(folderName)) {
+      logger2.info(`\u68C0\u6D4B\u5230\u6587\u4EF6\u5939\u521B\u5EFA/\u91CD\u547D\u540D: ${folderName}`);
+      if (this.pendingFolderRename && Date.now() - this.pendingFolderRename.time < FOLDER_RENAME_DETECT_WINDOW_MS) {
+        const oldName = this.pendingFolderRename.oldName;
+        const oldNoteIndex = NoteManager.extractNoteIndex(oldName);
+        if (oldNoteIndex && oldNoteIndex === noteIndex) {
+          logger2.info(`\u68C0\u6D4B\u5230\u6587\u4EF6\u5939\u91CD\u547D\u540D: ${oldName} \u2192 ${folderName}`);
+          if (this.folderRenameTimer) {
+            clearTimeout(this.folderRenameTimer);
+            this.folderRenameTimer = null;
+          }
+          onRename(oldName, folderName);
+          this.pendingFolderRename = null;
+        } else if (oldNoteIndex && oldNoteIndex !== noteIndex) {
+          logger2.warn(`\u7D22\u5F15\u51B2\u7A81\uFF0C\u56DE\u9000: ${oldName} -> ${folderName}`);
+        }
+      }
+      dirCache.add(folderName);
+      if (this.pendingFolderRename) {
+        dirCache.delete(this.pendingFolderRename.oldName);
+      }
+    }
+  }
+  clearTimers() {
+    if (this.folderRenameTimer) {
+      clearTimeout(this.folderRenameTimer);
+      this.folderRenameTimer = null;
+    }
+    this.pendingFolderRename = null;
+  }
+};
+
+// services/file-watcher/watchState.ts
+import { createHash } from "crypto";
+import { existsSync as existsSync5, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync } from "fs";
+import { join as join6 } from "path";
+var WatchState = class {
+  constructor(config2) {
+    this.config = config2;
+  }
+  /** 文件哈希缓存 */
+  fileHashes = /* @__PURE__ */ new Map();
+  /** 笔记目录缓存 */
+  noteDirCache = /* @__PURE__ */ new Set();
+  /** 笔记配置缓存 */
+  configCache = /* @__PURE__ */ new Map();
+  /**
+   * 获取指定文件的 MD5 哈希值，若文件不存在或读取失败返回 null
+   *
+   * @param filePath 文件路径
+   * @returns 文件哈希
+   */
+  getFileHash(filePath) {
+    try {
+      if (!existsSync5(filePath)) return null;
+      const content = readFileSync3(filePath, "utf-8");
+      if (content.length === 0) return null;
+      return createHash("md5").update(content).digest("hex");
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 更新文件哈希缓存，只有当文件内容发生变化时才更新并返回 true
+   *
+   * @param filePath 文件路径
+   * @returns 是否发生变化
+   */
+  updateFileHash(filePath) {
+    const current = this.getFileHash(filePath);
+    if (!current) return false;
+    const prev = this.fileHashes.get(filePath);
+    if (prev === current) return false;
+    this.fileHashes.set(filePath, current);
+    return true;
+  }
+  /**
+   * 检查指定名称的笔记目录是否已存在于缓存中
+   *
+   * @param name 笔记目录名称
+   * @returns 若存在则返回 true，否则返回 false
+   */
+  hasNoteDir(name) {
+    return this.noteDirCache.has(name);
   }
-  extractNoteIndexOrWarn(name) {
-    const noteIndex = name.match(/^(\d{4})/)?.[1] || null;
-    if (!noteIndex) {
-      this.config.logger.warn(`\u65E0\u6CD5\u4ECE\u6587\u4EF6\u5939\u540D\u79F0\u63D0\u53D6\u7B14\u8BB0\u7D22\u5F15: ${name}`);
-    }
-    return noteIndex;
+  /**
+   * 将指定名称的笔记目录添加到缓存中
+   *
+   * @param name 笔记目录名称
+   */
+  addNoteDir(name) {
+    this.noteDirCache.add(name);
   }
-  // #endregion - 私有实现
-};
-
-// services/file-watcher/fsWatcherAdapter.ts
-import { watch } from "fs";
-import { basename, dirname, join as join6, sep } from "path";
-var FsWatcherAdapter = class {
-  constructor(config2) {
-    this.config = config2;
+  /**
+   * 从缓存中移除指定名称的笔记目录
+   *
+   * @param name 笔记目录名称
+   */
+  deleteNoteDir(name) {
+    this.noteDirCache.delete(name);
   }
-  /** 文件系统监听器实例 */
-  watcher = null;
-  start() {
-    const { logger: logger2 } = this.config;
-    if (this.watcher) {
-      logger2.warn("\u6587\u4EF6\u76D1\u542C\u670D\u52A1\u5DF2\u542F\u52A8");
-      return;
-    }
-    this.watcher = watch(
-      this.config.notesDir,
-      { recursive: true },
-      (eventType, filename) => this.handleFsEvent(eventType, filename)
-    );
-    logger2.debug(`\u6587\u4EF6\u76D1\u542C\u5DF2\u542F\u52A8\uFF0C\u76D1\u542C\u76EE\u5F55\uFF1A${this.config.notesDir}`);
+  /**
+   * 清空所有缓存数据，包括文件哈希、笔记目录和配置快照
+   */
+  clearAll() {
+    this.fileHashes.clear();
+    this.noteDirCache.clear();
+    this.configCache.clear();
   }
-  stop() {
-    if (!this.watcher) return;
-    this.watcher.close();
-    this.watcher = null;
+  /**
+   * 清除指定笔记目录相关的缓存数据，包括 README.md 和 .tnotes.json 的文件哈希及配置快照
+   *
+   * @param noteDirName 笔记目录名称
+   */
+  clearNoteCaches(noteDirName) {
+    const readmePath = join6(this.config.notesDir, noteDirName, "README.md");
+    const configPath = join6(this.config.notesDir, noteDirName, ".tnotes.json");
+    this.fileHashes.delete(readmePath);
+    this.fileHashes.delete(configPath);
+    this.configCache.delete(configPath);
   }
-  isWatching() {
-    return this.watcher !== null;
+  /**
+   * 获取指定配置文件路径对应的配置快照
+   *
+   * @param configPath 配置文件路径（通常为 .tnotes.json 的绝对路径）
+   * @returns 配置快照，若不存在则返回 undefined
+   */
+  getConfigSnapshot(configPath) {
+    return this.configCache.get(configPath);
   }
-  handleFsEvent(eventType, filename) {
-    const { isUpdating, onRename, onNoteEvent } = this.config;
-    if (!filename || // 忽略无文件变更
-    isUpdating()) {
-      return;
-    }
-    if (eventType === "rename" && // 检测文件夹 rename 事件
-    !filename.includes(sep)) {
-      onRename(filename);
-      return;
-    }
-    const baseFilename = basename(filename);
-    if (baseFilename !== "README.md" && baseFilename !== ".tnotes.json") {
-      return;
-    }
-    const fullPath = join6(this.config.notesDir, filename);
-    const event = this.buildWatchEvent(fullPath, filename);
-    if (!event) {
-      return;
-    }
-    onNoteEvent(event);
+  /**
+   * 设置指定配置文件路径的配置快照到缓存中
+   *
+   * @param configPath 配置文件路径（通常为 .tnotes.json 的绝对路径）
+   * @param snapshot 配置快照对象
+   */
+  setConfigSnapshot(configPath, snapshot) {
+    this.configCache.set(configPath, snapshot);
   }
-  buildWatchEvent(fullPath, filename) {
-    const noteDirName = basename(dirname(fullPath));
-    const noteIndex = NoteManager.extractNoteIndex(noteDirName);
-    if (!noteIndex) {
-      NoteManager.warnInvalidNoteIndex(noteDirName);
+  /**
+   * 读取指定配置文件的快照
+   *
+   * 解析 .tnotes.json 配置文件，提取 done、enableDiscussions、description 字段。
+   *
+   * @param configPath 配置文件路径（通常为 .tnotes.json 的绝对路径）
+   * @returns 配置快照，若文件不存在或解析失败则返回 null
+   */
+  readConfigSnapshot(configPath) {
+    try {
+      if (!existsSync5(configPath)) return null;
+      const content = readFileSync3(configPath, "utf-8");
+      const config2 = JSON.parse(content);
+      return {
+        done: Boolean(config2.done),
+        enableDiscussions: Boolean(config2.enableDiscussions),
+        description: config2.description || ""
+      };
+    } catch (error) {
+      this.config.logger.error(`[\u8BFB\u53D6\u914D\u7F6E\u5FEB\u7167] ${error}`);
       return null;
     }
-    const fileType = filename.endsWith("README.md") ? WATCH_EVENT_TYPES.README : WATCH_EVENT_TYPES.CONFIG;
-    return {
-      path: fullPath,
-      type: fileType,
-      noteIndex,
-      noteDirName,
-      noteDirPath: dirname(fullPath)
-    };
+  }
+  /**
+   * 从磁盘初始化监听状态缓存：
+   * 遍历笔记根目录下的所有子目录，将每个笔记目录的 README.md 和 .tnotes.json
+   * 的哈希值及配置快照加载到缓存中。
+   */
+  initializeFromDisk() {
+    try {
+      const noteDirs = readdirSync2(this.config.notesDir);
+      this.clearAll();
+      for (const noteDir of noteDirs) {
+        const noteDirPath = join6(this.config.notesDir, noteDir);
+        if (!statSync(noteDirPath).isDirectory()) continue;
+        this.noteDirCache.add(noteDir);
+        const readmePath = join6(noteDirPath, "README.md");
+        const readmeHash = this.getFileHash(readmePath);
+        if (readmeHash) this.fileHashes.set(readmePath, readmeHash);
+        const configPath = join6(noteDirPath, ".tnotes.json");
+        const configHash = this.getFileHash(configPath);
+        if (configHash) {
+          this.fileHashes.set(configPath, configHash);
+          const snapshot = this.readConfigSnapshot(configPath);
+          if (snapshot) this.configCache.set(configPath, snapshot);
+        }
+      }
+    } catch (error) {
+      this.config.logger.warn(
+        `[initializeFromDisk] \u521D\u59CB\u5316\u76D1\u542C\u72B6\u6001\u5931\u8D25: ${error}`
+      );
+    }
   }
 };
 
+// services/note/service.ts
+import { writeFileSync as writeFileSync4, readFileSync as readFileSync5 } from "fs";
+import { join as join7 } from "path";
+import { v4 as uuidv4 } from "uuid";
+
+// config/templates.ts
+function generateNoteTitle(noteIndex, title, repoUrl) {
+  const dirName = `${noteIndex}. ${title}`;
+  const encodedDirName = encodeURIComponent(dirName);
+  return `# [${dirName}](${repoUrl}/${encodedDirName})`;
+}
+
 // services/readme/service.ts
 import {
   existsSync as existsSync6,
@@ -3091,18 +3069,6 @@ var ReadmeService = class _ReadmeService {
   }
 };
 
-// services/note/service.ts
-import { writeFileSync as writeFileSync4, readFileSync as readFileSync5 } from "fs";
-import { join as join7 } from "path";
-import { v4 as uuidv4 } from "uuid";
-
-// config/templates.ts
-function generateNoteTitle(noteIndex, title, repoUrl) {
-  const dirName = `${noteIndex}. ${title}`;
-  const encodedDirName = encodeURIComponent(dirName);
-  return `# [${dirName}](${repoUrl}/${encodedDirName})`;
-}
-
 // services/note/service.ts
 var NEW_NOTES_README_MD_TEMPLATE = `
 <!-- region:toc -->
@@ -3626,6 +3592,7 @@ var GitService = class {
 };
 
 // services/timestamp/service.ts
+import { execSync as execSync3 } from "child_process";
 import {
   existsSync as existsSync7,
   readFileSync as readFileSync6,
@@ -3634,7 +3601,6 @@ import {
   statSync as statSync2
 } from "fs";
 import { join as join8 } from "path";
-import { execSync as execSync3 } from "child_process";
 var BIRTH_DATE = (/* @__PURE__ */ new Date("1999-06-29T00:00:00+08:00")).getTime();
 var TimestampService = class {
   noteManager;
@@ -4146,6 +4112,41 @@ var VitepressService = class _VitepressService {
   }
 };
 
+// commands/BaseCommand.ts
+var BaseCommand = class {
+  constructor(name) {
+    this.name = name;
+    this.logger = logger.child(name);
+  }
+  logger;
+  options = {};
+  /** 命令描述（从静态配置读取） */
+  get description() {
+    return COMMAND_DESCRIPTIONS[this.name];
+  }
+  /**
+   * 设置命令选项
+   */
+  setOptions(options) {
+    this.options = { ...this.options, ...options };
+  }
+  /**
+   * 执行命令（带错误处理）
+   */
+  async execute() {
+    const startTime = Date.now();
+    try {
+      this.logger.start(this.description);
+      await this.run();
+      const duration = Date.now() - startTime;
+      this.logger.done(`\u547D\u4EE4\u6267\u884C\u8017\u65F6\uFF1A${duration} ms`);
+    } catch (error) {
+      handleError(error);
+      throw error;
+    }
+  }
+};
+
 // commands/note/UpdateNoteConfigCommand.ts
 var UpdateNoteConfigCommand = class extends BaseCommand {
   noteService;
@@ -4295,20 +4296,16 @@ var RenameNoteCommand = class extends BaseCommand {
 };
 
 export {
-  COMMAND_NAMES,
-  COMMAND_DESCRIPTIONS,
-  COMMAND_OPTIONS,
+  ROOT_DIR_PATH,
+  ROOT_CONFIG_PATH,
   handleError,
   generateAnchor,
   logger,
   createLogger,
   parseArgs,
   parseReadmeCompletedNotes,
-  ROOT_DIR_PATH,
-  ROOT_CONFIG_PATH,
-  NoteManager,
   runCommand,
-  BaseCommand,
+  NoteManager,
   NoteIndexCache,
   ReadmeService,
   NoteService,
@@ -4316,6 +4313,10 @@ export {
   GitService,
   TimestampService,
   VitepressService,
+  COMMAND_NAMES,
+  COMMAND_DESCRIPTIONS,
+  COMMAND_OPTIONS,
+  BaseCommand,
   UpdateNoteConfigCommand,
   RenameNoteCommand
 };