@tnotesjs/core 0.1.14 → 0.1.16

package/dist/{chunk-FVKQPBPP.js → chunk-4MO7F7Q4.js}

@@ -1282,6 +1282,14 @@ var NoteIndexCache = class _NoteIndexCache {
   }
 };
 
+// services/readme/service.ts
+import {
+  existsSync as existsSync3,
+  readFileSync as readFileSync3,
+  writeFileSync as writeFileSync3,
+  promises as fsPromises
+} from "fs";
+
 // core/ReadmeGenerator.ts
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2 } from "fs";
 
@@ -1572,663 +1580,538 @@ var ReadmeGenerator = class {
   }
 };
 
-// core/GitManager.ts
-var GitManager = class {
-  logger;
-  dir;
-  constructor(dir, logger2) {
-    this.dir = dir;
-    this.logger = logger2?.child("git") || new Logger({ prefix: "git" });
-  }
-  /**
-   * 检查是否为有效的 Git 仓库
-   */
-  async isValidRepo() {
-    try {
-      const result = await runCommand(
-        "git rev-parse --is-inside-work-tree",
-        this.dir
-      );
-      return result.trim() === "true";
-    } catch {
-      return false;
-    }
+// services/readme/service.ts
+var ReadmeService = class _ReadmeService {
+  static instance;
+  noteManager;
+  readmeGenerator;
+  configManager;
+  noteIndexCache;
+  constructor() {
+    this.noteManager = NoteManager.getInstance();
+    this.readmeGenerator = new ReadmeGenerator();
+    this.configManager = ConfigManager.getInstance();
+    this.noteIndexCache = NoteIndexCache.getInstance();
   }
-  /**
-   * 确保是有效的 Git 仓库，否则抛出错误
-   */
-  async ensureValidRepo() {
-    if (!await this.isValidRepo()) {
-      throw createError.gitNotRepo(this.dir);
+  static getInstance() {
+    if (!_ReadmeService.instance) {
+      _ReadmeService.instance = new _ReadmeService();
     }
+    return _ReadmeService.instance;
   }
   /**
-   * 获取 Git 状态
+   * 更新所有笔记的 README
+   * @param options - 更新选项
    */
-  async getStatus() {
-    await this.ensureValidRepo();
-    const statusOutput = await runCommand(
-      "git -c core.quotePath=false status --porcelain",
-      this.dir
-    );
-    const lines = statusOutput.trim().split("\n").filter((line) => line);
-    const files = lines.map((line) => {
-      const statusCode = line.substring(0, 2);
-      let path2 = line.substring(3);
-      path2 = path2.replace(/^"(.*)"$/, "$1");
-      let status = "modified";
-      if (line.startsWith("??")) {
-        status = "untracked";
-      } else if (/^[MADRC]/.test(statusCode)) {
-        status = "staged";
-      } else if (/^.[MD]/.test(statusCode)) {
-        status = "unstaged";
-      }
-      return { path: path2, status, statusCode };
-    });
-    const staged = files.filter((f) => f.status === "staged").length;
-    const unstaged = files.filter((f) => f.status === "unstaged").length;
-    const untracked = files.filter((f) => f.status === "untracked").length;
-    const branch = await runCommand("git branch --show-current", this.dir);
-    let ahead = 0;
-    let behind = 0;
-    try {
-      const aheadBehind = await runCommand(
-        "git rev-list --left-right --count @{upstream}...HEAD",
-        this.dir
+  async updateAllReadmes(options = {}) {
+    const {
+      updateSidebar = true,
+      updateHome = true,
+      notes: providedNotes
+    } = options;
+    logger.info("\u5F00\u59CB\u66F4\u65B0\u77E5\u8BC6\u5E93...");
+    const notes = providedNotes ?? this.noteManager.scanNotes();
+    logger.info(`\u626B\u63CF\u5230 ${notes.length} \u7BC7\u7B14\u8BB0`);
+    const changedIndexes = await this.getChangedNoteIndexes();
+    const shouldIncrementalUpdate = changedIndexes.size > 0 && changedIndexes.size < notes.length * 0.3;
+    let notesToUpdate = notes;
+    if (shouldIncrementalUpdate) {
+      notesToUpdate = notes.filter((note) => changedIndexes.has(note.index));
+      logger.info(
+        `\u68C0\u6D4B\u5230 ${changedIndexes.size} \u7BC7\u7B14\u8BB0\u6709\u53D8\u66F4\uFF0C\u4F7F\u7528\u589E\u91CF\u66F4\u65B0\u6A21\u5F0F`
       );
-      const [behindStr, aheadStr] = aheadBehind.trim().split("	");
-      behind = parseInt(behindStr) || 0;
-      ahead = parseInt(aheadStr) || 0;
-    } catch {
+    } else {
+      logger.info("\u4F7F\u7528\u5168\u91CF\u66F4\u65B0\u6A21\u5F0F");
     }
-    return {
-      hasChanges: lines.length > 0,
-      changedFiles: lines.length,
-      staged,
-      unstaged,
-      untracked,
-      branch: branch.trim(),
-      ahead,
-      behind,
-      files
-    };
+    const startTime = Date.now();
+    await this.updateNoteReadmesInParallel(notesToUpdate);
+    const updateTime = Date.now() - startTime;
+    logger.info(`\u66F4\u65B0\u4E86 ${notesToUpdate.length} \u7BC7\u7B14\u8BB0 (\u8017\u65F6 ${updateTime}ms)`);
+    if (updateHome) {
+      await this.updateHomeReadme(notes);
+    }
+    if (updateSidebar) {
+      await this.updateSidebar(notes);
+    }
+    logger.info("\u77E5\u8BC6\u5E93\u66F4\u65B0\u5B8C\u6210\uFF01");
   }
   /**
-   * 获取远程仓库信息
+   * 只更新指定笔记的 README（不更新 sidebar、home）
+   * @param noteIndexes - 笔记索引数组，例如 ['0001', '0002']
    */
-  async getRemoteInfo() {
-    try {
-      await this.ensureValidRepo();
-      const remoteUrl = await runCommand(
-        "git config --get remote.origin.url",
-        this.dir
-      );
-      const url = remoteUrl.trim();
-      if (!url) return null;
-      const httpsMatch = url.match(
-        /https:\/\/(?:www\.)?github\.com\/([^/]+)\/(.+?)(?:\.git)?$/
-      );
-      if (httpsMatch) {
-        return {
-          url,
-          type: "https",
-          owner: httpsMatch[1],
-          repo: httpsMatch[2]
-        };
+  async updateNoteReadmesOnly(noteIndexes) {
+    if (noteIndexes.length === 0) return;
+    const notesToUpdate = [];
+    for (const noteIndex of noteIndexes) {
+      const note = this.noteManager.getNoteByIndex(noteIndex);
+      if (note) {
+        notesToUpdate.push(note);
+      } else {
+        logger.warn(`\u7B14\u8BB0\u672A\u627E\u5230: ${noteIndex}`);
       }
-      const sshMatch = url.match(/git@github\.com:([^/]+)\/(.+?)(?:\.git)?$/);
-      if (sshMatch) {
-        return {
-          url,
-          type: "ssh",
-          owner: sshMatch[1],
-          repo: sshMatch[2]
-        };
+    }
+    if (notesToUpdate.length === 0) {
+      logger.warn("\u6CA1\u6709\u627E\u5230\u9700\u8981\u66F4\u65B0\u7684\u7B14\u8BB0");
+      return;
+    }
+    for (const note of notesToUpdate) {
+      try {
+        this.readmeGenerator.updateNoteReadme(note);
+      } catch (error) {
+        logger.error(`\u66F4\u65B0\u7B14\u8BB0 ${note.dirName} \u5931\u8D25`, error);
       }
-      return { url, type: "unknown" };
-    } catch {
-      return null;
     }
   }
   /**
-   * 检查是否有未提交的更改
-   */
-  async hasUncommittedChanges() {
-    const status = await this.getStatus();
-    return status.hasChanges;
-  }
-  /**
-   * Stash 当前更改
+   * 获取变更的笔记索引集合
+   * @returns 变更的笔记索引集合
    */
-  async stash(message) {
+  async getChangedNoteIndexes() {
     try {
-      await this.ensureValidRepo();
-      const cmd = message ? `git stash push -m "${message}"` : "git stash push";
-      await runCommand(cmd, this.dir);
-      this.logger.info("Stashed uncommitted changes");
-      return true;
+      return getChangedIds();
     } catch (error) {
-      this.logger.warn("Failed to stash changes");
-      return false;
+      return /* @__PURE__ */ new Set();
     }
   }
   /**
-   * Pop stash
+   * 并行更新多个笔记的 README
+   * @param notes - 笔记信息数组
    */
-  async stashPop() {
-    try {
-      await this.ensureValidRepo();
-      await runCommand("git stash pop", this.dir);
-      this.logger.info("Restored stashed changes");
-      return true;
-    } catch (error) {
-      this.logger.warn("Failed to restore stashed changes");
-      return false;
+  async updateNoteReadmesInParallel(notes) {
+    const batchSize = 10;
+    const batches = [];
+    for (let i = 0; i < notes.length; i += batchSize) {
+      batches.push(notes.slice(i, i + batchSize));
+    }
+    let successCount = 0;
+    let failCount = 0;
+    for (const batch of batches) {
+      const results = await Promise.allSettled(
+        batch.map(
+          (note) => Promise.resolve().then(() => {
+            this.readmeGenerator.updateNoteReadme(note);
+          })
+        )
+      );
+      for (const result of results) {
+        if (result.status === "fulfilled") {
+          successCount++;
+        } else {
+          failCount++;
+          logger.error("\u66F4\u65B0\u7B14\u8BB0\u5931\u8D25", result.reason);
+        }
+      }
+    }
+    if (failCount > 0) {
+      logger.warn(`\u66F4\u65B0\u5B8C\u6210\uFF1A\u6210\u529F ${successCount} \u7BC7\uFF0C\u5931\u8D25 ${failCount} \u7BC7`);
     }
   }
   /**
-   * 拉取远程更新
+   * 更新侧边栏配置
+   * @param notes - 笔记信息数组
    */
-  async pull(options) {
-    await this.ensureValidRepo();
-    const { rebase = true, autostash = true } = options || {};
-    const hasChanges = await this.hasUncommittedChanges();
-    let didStash = false;
-    if (hasChanges && !autostash) {
-      this.logger.warn("Repository has uncommitted changes");
-      didStash = await this.stash("Auto-stash before pull");
+  async updateSidebar(notes) {
+    if (!existsSync3(ROOT_README_PATH)) {
+      logger.error("\u672A\u627E\u5230\u9996\u9875 README\uFF0C\u65E0\u6CD5\u751F\u6210\u4FA7\u8FB9\u680F");
+      return;
     }
-    try {
-      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();
-      await runCommand(cmd, this.dir);
-      const afterCommit = await runCommand("git rev-parse HEAD", this.dir);
-      if (beforeCommit.trim() !== afterCommit.trim()) {
-        try {
-          const diffOutput = await runCommand(
-            `git diff --name-only ${beforeCommit.trim()}..${afterCommit.trim()}`,
-            this.dir
-          );
-          const changedFiles = diffOutput.trim().split("\n").filter((f) => f);
-          if (changedFiles.length > 0) {
-            console.log(`  \u66F4\u65B0\u4E86 ${changedFiles.length} \u4E2A\u6587\u4EF6:`);
-            changedFiles.forEach((file, index) => {
-              console.log(`  ${index + 1}. ${file}`);
-            });
+    const content = readFileSync3(ROOT_README_PATH, "utf-8");
+    const lines = content.split("\n");
+    const itemList = [];
+    const titles = [];
+    const titlesNotesCount = [];
+    let currentNoteCount = 0;
+    let inTocRegion = false;
+    for (const line of lines) {
+      if (line.includes("<!-- region:toc -->")) {
+        inTocRegion = true;
+        continue;
+      }
+      if (line.includes("<!-- endregion:toc -->")) {
+        inTocRegion = false;
+        continue;
+      }
+      if (inTocRegion) {
+        continue;
+      }
+      const parsed = parseNoteLine(line);
+      if (parsed.isMatch && parsed.noteIndex) {
+        const note = notes.find((n) => n.index === parsed.noteIndex);
+        if (!note) {
+          logger.warn(`\u672A\u627E\u5230\u7B14\u8BB0\u7D22\u5F15: ${parsed.noteIndex}`);
+          continue;
+        }
+        let statusEmoji = "\u23F0 ";
+        if (note?.config) {
+          if (note.config.done) {
+            statusEmoji = "\u2705 ";
           }
-          this.logger.success(`\u62C9\u53D6\u6210\u529F: ${changedFiles.length} \u4E2A\u6587\u4EF6\u5DF2\u66F4\u65B0`);
-        } catch {
-          this.logger.success("\u62C9\u53D6\u6210\u529F");
         }
-      } else {
-        this.logger.info("\u5DF2\u662F\u6700\u65B0\uFF0C\u6CA1\u6709\u9700\u8981\u62C9\u53D6\u7684\u66F4\u65B0");
+        const sidebarShowNoteId2 = this.configManager.get("sidebarShowNoteId");
+        let displayText = note.dirName;
+        if (!sidebarShowNoteId2) {
+          displayText = note.dirName.replace(/^\d{4}\.\s/, "");
+        }
+        itemList.push({
+          text: statusEmoji + displayText,
+          link: `/notes/${note.dirName}/README`
+        });
+        currentNoteCount++;
+        continue;
       }
-    } catch (error) {
-      this.logger.error("\u62C9\u53D6\u5931\u8D25");
-      handleError(error);
-      throw error;
-    } finally {
-      if (didStash) {
-        await this.stashPop();
+      const titleMatch = line.match(/^(#{2,})\s+(.+)$/);
+      if (titleMatch) {
+        if (titles.length > 0) {
+          titlesNotesCount.push(currentNoteCount);
+        }
+        titles.push(line);
+        currentNoteCount = 0;
       }
     }
+    if (titles.length > 0) {
+      titlesNotesCount.push(currentNoteCount);
+    }
+    const sidebarIsCollapsed = true;
+    const hierarchicalSidebar = genHierarchicalSidebar(
+      itemList,
+      titles,
+      titlesNotesCount,
+      sidebarIsCollapsed
+    );
+    writeFileSync3(
+      VP_SIDEBAR_PATH,
+      JSON.stringify(hierarchicalSidebar, null, 2),
+      "utf-8"
+    );
+    logger.info("\u5DF2\u66F4\u65B0\u4FA7\u8FB9\u680F\u914D\u7F6E");
   }
   /**
-   * 提交更改
+   * 更新首页 README
+   * @param notes - 笔记信息数组
    */
-  async commit(message) {
-    await this.ensureValidRepo();
-    try {
-      await runCommand(`git commit -m "${message}"`, this.dir);
-      this.logger.success(`Committed: ${message}`);
-    } catch (error) {
-      handleError(error);
-      throw error;
-    }
+  async updateHomeReadme(notes) {
+    this.readmeGenerator.updateHomeReadme(notes, ROOT_README_PATH);
   }
   /**
-   * 添加文件到暂存区
+   * 增量更新首页 README 中的单个笔记
+   * @param noteIndex - 笔记索引
+   * @param updates - 需要更新的配置字段
    */
-  async add(files = ".") {
-    await this.ensureValidRepo();
-    const fileList = Array.isArray(files) ? files.join(" ") : files;
-    try {
-      await runCommand(`git add ${fileList}`, this.dir);
-      this.logger.info(`Staged changes: ${fileList}`);
-    } catch (error) {
-      handleError(error);
-      throw error;
+  async updateNoteInReadme(noteIndex, updates) {
+    const item = this.noteIndexCache.getByNoteIndex(noteIndex);
+    if (!item) {
+      logger.warn(`\u5C1D\u8BD5\u66F4\u65B0\u4E0D\u5B58\u5728\u7684\u7B14\u8BB0: ${noteIndex}`);
+      return;
+    }
+    const content = await fsPromises.readFile(ROOT_README_PATH, "utf-8");
+    const lines = content.split("\n");
+    const repoOwner = this.configManager.get("author");
+    const repoName2 = this.configManager.get("repoName");
+    const mergedConfig = { ...item.noteConfig, ...updates };
+    const tempNoteInfo = {
+      index: noteIndex,
+      dirName: item.folderName,
+      path: "",
+      readmePath: "",
+      configPath: "",
+      config: mergedConfig
+    };
+    let updated = false;
+    for (let i = 0; i < lines.length; i++) {
+      const parsed = parseNoteLine(lines[i]);
+      if (parsed.noteIndex === noteIndex) {
+        lines[i] = buildNoteLineMarkdown(tempNoteInfo, repoOwner, repoName2);
+        updated = true;
+      }
+    }
+    if (updated) {
+      await fsPromises.writeFile(ROOT_README_PATH, lines.join("\n"), "utf-8");
+      logger.info(`\u589E\u91CF\u66F4\u65B0 README.md \u4E2D\u7684\u7B14\u8BB0: ${noteIndex}`);
+    } else {
+      logger.warn(`README.md \u4E2D\u672A\u627E\u5230\u7B14\u8BB0: ${noteIndex}`);
     }
   }
   /**
-   * 推送到远程仓库
+   * 从首页 README 中删除笔记
+   * @param noteIndex - 笔记索引
    */
-  async push(options) {
-    await this.ensureValidRepo();
-    const { force = false, setUpstream = false } = options || {};
-    try {
-      const status = await this.getStatus();
-      this.logger.progress(`\u6B63\u5728\u63A8\u9001\u5230\u8FDC\u7A0B (${status.branch})...`);
-      let cmd = "git push";
-      if (force) cmd += " --force";
-      if (setUpstream) cmd += ` --set-upstream origin ${status.branch}`;
-      await runCommand(cmd, this.dir);
-      const remoteInfo = await this.getRemoteInfo();
-      if (remoteInfo) {
-        this.logger.success(`\u63A8\u9001\u6210\u529F \u2192 ${remoteInfo.owner}/${remoteInfo.repo}`);
-      } else {
-        this.logger.success("\u63A8\u9001\u6210\u529F");
+  async deleteNoteFromReadme(noteIndex) {
+    const content = await fsPromises.readFile(ROOT_README_PATH, "utf-8");
+    const lines = content.split("\n");
+    const linesToRemove = [];
+    for (let i = 0; i < lines.length; i++) {
+      const parsed = parseNoteLine(lines[i]);
+      if (parsed.noteIndex === noteIndex) {
+        linesToRemove.push(i);
       }
-    } catch (error) {
-      this.logger.error("\u63A8\u9001\u5931\u8D25");
-      handleError(error);
-      throw error;
+    }
+    if (linesToRemove.length > 0) {
+      for (let i = linesToRemove.length - 1; i >= 0; i--) {
+        lines.splice(linesToRemove[i], 1);
+      }
+      await fsPromises.writeFile(ROOT_README_PATH, lines.join("\n"), "utf-8");
+      logger.info(
+        `\u4ECE README.md \u4E2D\u5220\u9664\u7B14\u8BB0: ${noteIndex} (${linesToRemove.length} \u5904\u5F15\u7528)`
+      );
+    } else {
+      logger.warn(`README.md \u4E2D\u672A\u627E\u5230\u7B14\u8BB0: ${noteIndex}`);
     }
   }
   /**
-   * 完整的推送流程：检查 -> 添加 -> 提交 -> 推送
+   * 在首页 README 末尾添加新笔记
+   * @param noteIndex - 笔记索引
    */
-  async pushWithCommit(commitMessage, options) {
-    await this.ensureValidRepo();
-    const status = await this.getStatus();
-    if (!status.hasChanges) {
-      this.logger.info("\u6CA1\u6709\u9700\u8981\u63D0\u4EA4\u7684\u66F4\u6539");
+  async appendNoteToReadme(noteIndex) {
+    const item = this.noteIndexCache.getByNoteIndex(noteIndex);
+    if (!item) {
+      logger.warn(`\u5C1D\u8BD5\u6DFB\u52A0\u4E0D\u5B58\u5728\u7684\u7B14\u8BB0: ${noteIndex}`);
       return;
     }
-    try {
-      this.logger.info(`\u6B63\u5728\u63A8\u9001 ${status.changedFiles} \u4E2A\u6587\u4EF6...`);
-      status.files.forEach((file, index) => {
-        console.log(`  ${index + 1}. ${file.path}`);
-      });
-      await runCommand("git add .", this.dir);
-      const message = commitMessage || `update: ${status.changedFiles} files modified`;
-      await runCommand(`git commit -m "${message}"`, this.dir);
-      let cmd = "git push";
-      if (options?.force) cmd += " --force";
-      await runCommand(cmd, this.dir);
-      const remoteInfo = await this.getRemoteInfo();
-      if (remoteInfo) {
-        this.logger.success(
-          `\u63A8\u9001\u6210\u529F: ${status.changedFiles} \u4E2A\u6587\u4EF6 \u2192 https://github.com/${remoteInfo.owner}/${remoteInfo.repo}`
-        );
-      } else {
-        this.logger.success(`\u63A8\u9001\u6210\u529F: ${status.changedFiles} \u4E2A\u6587\u4EF6`);
-      }
-    } catch (error) {
-      this.logger.error(`\u63A8\u9001\u5931\u8D25`);
-      handleError(error);
-      throw error;
-    }
+    const content = await fsPromises.readFile(ROOT_README_PATH, "utf-8");
+    const lines = content.split("\n");
+    const repoOwner = this.configManager.get("author");
+    const repoName2 = this.configManager.get("repoName");
+    const tempNoteInfo = {
+      index: noteIndex,
+      dirName: item.folderName,
+      path: "",
+      readmePath: "",
+      configPath: "",
+      config: item.noteConfig
+    };
+    const noteLine = buildNoteLineMarkdown(tempNoteInfo, repoOwner, repoName2);
+    lines.push(noteLine);
+    await fsPromises.writeFile(ROOT_README_PATH, lines.join("\n"), "utf-8");
+    logger.info(`\u5728 README.md \u672B\u5C3E\u6DFB\u52A0\u7B14\u8BB0: ${noteIndex}`);
   }
   /**
-   * 完整的同步流程：拉取 -> 推送
+   * 重命名根 README 中的目录标题
    */
-  async sync(options) {
-    const { commitMessage, rebase = true } = options || {};
-    try {
-      await this.pull({ rebase, autostash: true });
-      await this.pushWithCommit(commitMessage);
-    } catch (error) {
-      this.logger.error("Sync failed");
-      handleError(error);
-      throw error;
+  async renameGroupInReadme(groupPath, newTitle) {
+    this.assertGroupPath(groupPath);
+    const cleanTitle = this.cleanHeadingTitle(newTitle);
+    const lines = await this.readHomeReadmeLines();
+    const block = this.findGroupBlock(lines, groupPath);
+    const headingMark = "#".repeat(block.level);
+    lines[block.headingIndex] = `${headingMark} ${cleanTitle}`;
+    await this.writeHomeReadmeLines(lines);
+    logger.info(`\u91CD\u547D\u540D\u76EE\u5F55: ${groupPath.join(" / ")} -> ${cleanTitle}`);
+  }
+  /**
+   * 删除根 README 中的目录块，返回块内所有笔记编号
+   */
+  async deleteGroupFromReadme(groupPath) {
+    this.assertGroupPath(groupPath);
+    const lines = await this.readHomeReadmeLines();
+    const block = this.findGroupBlock(lines, groupPath);
+    const noteIndexes = this.collectNoteIndexes(
+      lines,
+      block.headingIndex,
+      block.endIndex
+    );
+    lines.splice(block.headingIndex, block.endIndex - block.headingIndex);
+    await this.writeHomeReadmeLines(lines);
+    logger.info(
+      `\u5220\u9664\u76EE\u5F55: ${groupPath.join(" / ")} (${noteIndexes.length} \u7BC7\u7B14\u8BB0)`
+    );
+    return noteIndexes;
+  }
+  /**
+   * 在目录开头插入笔记链接
+   */
+  async insertNotesAtGroupStart(groupPath, notes) {
+    this.assertGroupPath(groupPath);
+    if (notes.length === 0) return;
+    const lines = await this.readHomeReadmeLines();
+    const block = this.findGroupBlock(lines, groupPath);
+    const noteLines = this.buildNoteLines(notes);
+    let insertIndex = block.headingIndex + 1;
+    while (insertIndex < block.endIndex && lines[insertIndex].trim() === "") {
+      insertIndex++;
     }
+    lines.splice(insertIndex, 0, ...noteLines);
+    await this.writeHomeReadmeLines(lines);
+    logger.info(
+      `\u5728\u76EE\u5F55\u5F00\u5934\u63D2\u5165\u7B14\u8BB0: ${groupPath.join(" / ")} (${notes.length} \u7BC7)`
+    );
   }
   /**
-   * 显示状态摘要
+   * 在指定笔记上方或下方插入笔记链接
    */
-  async showStatus(options) {
-    const { showFiles = true } = options || {};
-    const status = await this.getStatus();
-    const remoteInfo = await this.getRemoteInfo();
-    console.log("\n\u{1F4CA} Git \u72B6\u6001:");
-    console.log(`  \u5206\u652F: ${status.branch}`);
-    if (remoteInfo) {
-      console.log(
-        `  \u8FDC\u7A0B: ${remoteInfo.owner}/${remoteInfo.repo} (${remoteInfo.type})`
-      );
-    }
-    if (status.hasChanges) {
-      console.log(
-        `  \u53D8\u66F4: ${status.changedFiles} \u4E2A\u6587\u4EF6 (\u5DF2\u6682\u5B58 ${status.staged}, \u672A\u6682\u5B58 ${status.unstaged}, \u672A\u8DDF\u8E2A ${status.untracked})`
-      );
-      if (showFiles && status.files.length > 0) {
-        console.log("  \u53D8\u66F4\u6587\u4EF6\u5217\u8868:");
-        const stagedFiles = status.files.filter((f) => f.status === "staged");
-        const unstagedFiles = status.files.filter(
-          (f) => f.status === "unstaged"
-        );
-        const untrackedFiles = status.files.filter(
-          (f) => f.status === "untracked"
-        );
-        if (stagedFiles.length > 0) {
-          console.log("    \u5DF2\u6682\u5B58:");
-          stagedFiles.forEach((f) => console.log(`      \u2713 ${f.path}`));
-        }
-        if (unstagedFiles.length > 0) {
-          console.log("    \u672A\u6682\u5B58:");
-          unstagedFiles.forEach((f) => console.log(`      \u2022 ${f.path}`));
-        }
-        if (untrackedFiles.length > 0) {
-          console.log("    \u672A\u8DDF\u8E2A:");
-          untrackedFiles.forEach((f) => console.log(`      ? ${f.path}`));
-        }
-      }
-    } else {
-      console.log("  \u72B6\u6001: \u5DE5\u4F5C\u533A\u5E72\u51C0\uFF0C\u6CA1\u6709\u53D8\u66F4");
-    }
-    if (status.ahead > 0 || status.behind > 0) {
-      const syncInfo = [];
-      if (status.ahead > 0) syncInfo.push(`\u9886\u5148 ${status.ahead} \u4E2A\u63D0\u4EA4`);
-      if (status.behind > 0) syncInfo.push(`\u843D\u540E ${status.behind} \u4E2A\u63D0\u4EA4`);
-      console.log(`  \u540C\u6B65: ${syncInfo.join(", ")}`);
-    }
-    console.log();
-  }
-};
-
-// core/ProcessManager.ts
-import { spawn } from "child_process";
-var ProcessManager = class {
-  processes = /* @__PURE__ */ new Map();
-  logger;
-  constructor() {
-    this.logger = new Logger({ prefix: "process" });
-    process.on("exit", () => {
-      this.killAll();
-    });
-    process.on("SIGINT", () => {
-      this.killAll();
-      process.exit(0);
-    });
-    process.on("SIGTERM", () => {
-      this.killAll();
-      process.exit(0);
-    });
+  async insertNotesAroundNote(targetNoteIndex, notes, placement) {
+    if (notes.length === 0) return;
+    const lines = await this.readHomeReadmeLines();
+    const noteLineIndex = this.findNoteLineIndex(lines, targetNoteIndex);
+    const insertIndex = placement === "before" ? noteLineIndex : noteLineIndex + 1;
+    const noteLines = this.buildNoteLines(notes);
+    lines.splice(insertIndex, 0, ...noteLines);
+    await this.writeHomeReadmeLines(lines);
+    logger.info(
+      `\u5728\u7B14\u8BB0 ${targetNoteIndex} ${placement === "before" ? "\u4E0A\u65B9" : "\u4E0B\u65B9"}\u63D2\u5165 ${notes.length} \u7BC7\u7B14\u8BB0`
+    );
   }
   /**
-   * 启动进程
-   * @param id - 进程ID
-   * @param command - 命令
-   * @param args - 参数列表
-   * @param options - spawn 选项
-   * @returns ProcessInfo
+   * 移动笔记引用到目录开头，或移动到另一篇笔记前后
    */
-  spawn(id, command, args = [], options) {
-    if (this.processes.has(id)) {
-      this.logger.warn(`\u8FDB\u7A0B ${id} \u5DF2\u5B58\u5728\uFF0C\u5148\u505C\u6B62\u65E7\u8FDB\u7A0B`);
-      this.kill(id);
+  async moveNoteInReadme(noteIndex, options) {
+    const lines = await this.readHomeReadmeLines();
+    const sourceIndex = this.findNoteLineIndex(lines, noteIndex);
+    const [noteLine] = lines.splice(sourceIndex, 1);
+    if (options.targetGroupPath) {
+      const block = this.findGroupBlock(lines, options.targetGroupPath);
+      let insertIndex2 = block.headingIndex + 1;
+      while (insertIndex2 < block.endIndex && lines[insertIndex2].trim() === "") {
+        insertIndex2++;
+      }
+      lines.splice(insertIndex2, 0, noteLine);
+      await this.writeHomeReadmeLines(lines);
+      return;
     }
-    const proc = spawn(command, args, {
-      stdio: "inherit",
-      shell: true,
-      ...options
-    });
-    const processInfo = {
-      id,
-      pid: proc.pid,
-      command,
-      args,
-      startTime: Date.now(),
-      process: proc
-    };
-    this.processes.set(id, processInfo);
-    proc.on("exit", (code, signal) => {
-      this.logger.info(`\u8FDB\u7A0B ${id} \u5DF2\u9000\u51FA (code: ${code}, signal: ${signal})`);
-      this.processes.delete(id);
-    });
-    proc.on("error", (err) => {
-      this.logger.error(`\u8FDB\u7A0B ${id} \u51FA\u9519: ${err.message}`);
-      this.processes.delete(id);
-    });
-    return processInfo;
+    if (!options.targetNoteIndex) {
+      throw new Error("\u7F3A\u5C11\u76EE\u6807\u7B14\u8BB0\u6216\u76EE\u6807\u76EE\u5F55");
+    }
+    if (options.targetNoteIndex === noteIndex) {
+      throw new Error("\u4E0D\u80FD\u628A\u7B14\u8BB0\u79FB\u52A8\u5230\u81EA\u8EAB\u9644\u8FD1");
+    }
+    const targetIndex = this.findNoteLineIndex(lines, options.targetNoteIndex);
+    const insertIndex = options.placement === "after" ? targetIndex + 1 : targetIndex;
+    lines.splice(insertIndex, 0, noteLine);
+    await this.writeHomeReadmeLines(lines);
   }
   /**
-   * 停止进程
-   * @param id - 进程ID
-   * @param signal - 信号（默认为 SIGTERM）
-   * @returns 是否成功停止
+   * 移动目录块到同级目录前后
    */
-  kill(id, signal = "SIGTERM") {
-    const processInfo = this.processes.get(id);
-    if (!processInfo) {
-      this.logger.warn(`\u8FDB\u7A0B ${id} \u4E0D\u5B58\u5728`);
-      return false;
+  async moveGroupInReadme(groupPath, targetGroupPath, placement = "before") {
+    this.assertGroupPath(groupPath);
+    this.assertGroupPath(targetGroupPath);
+    if (this.isSamePath(groupPath, targetGroupPath)) {
+      throw new Error("\u4E0D\u80FD\u628A\u76EE\u5F55\u79FB\u52A8\u5230\u81EA\u8EAB\u9644\u8FD1");
     }
-    this.logger.info(`\u505C\u6B62\u8FDB\u7A0B: ${id} (PID: ${processInfo.pid})`);
-    try {
-      const killed = processInfo.process.kill(signal);
-      if (killed) {
-        this.processes.delete(id);
-        return true;
-      }
-      return false;
-    } catch (error) {
-      this.logger.error(`\u505C\u6B62\u8FDB\u7A0B ${id} \u5931\u8D25: ${error}`);
-      return false;
+    if (groupPath.length !== targetGroupPath.length) {
+      throw new Error("\u7B2C\u4E00\u7248\u62D6\u62FD\u4EC5\u652F\u6301\u540C\u7EA7\u76EE\u5F55\u6392\u5E8F");
     }
+    const lines = await this.readHomeReadmeLines();
+    const sourceBlock = this.findGroupBlock(lines, groupPath);
+    const movingLines = lines.splice(
+      sourceBlock.headingIndex,
+      sourceBlock.endIndex - sourceBlock.headingIndex
+    );
+    const targetBlock = this.findGroupBlock(lines, targetGroupPath);
+    const insertIndex = placement === "after" ? targetBlock.endIndex : targetBlock.headingIndex;
+    lines.splice(insertIndex, 0, ...movingLines);
+    await this.writeHomeReadmeLines(lines);
   }
   /**
-   * 检查进程是否存在
-   * @param id - 进程ID
-   * @returns 是否存在
+   * 更新根 README 和 sidebar，不重写每篇笔记 README
    */
-  has(id) {
-    return this.processes.has(id);
+  async refreshHomeReadmeAndSidebar(notes) {
+    const allNotes = notes ?? (this.noteIndexCache.isInitialized() ? this.noteIndexCache.toNoteInfoList() : this.noteManager.scanNotes());
+    await this.updateHomeReadme(allNotes);
+    await this.updateSidebar(allNotes);
   }
   /**
-   * 检查进程是否在运行
-   * @param id - 进程 ID
-   * @returns 是否在运行
+   * 重新生成 sidebar.json（基于当前 README.md）
+   * @param notes - 可选的笔记列表，不传则内部扫描
    */
-  isRunning(id) {
-    const processInfo = this.processes.get(id);
-    if (!processInfo) return false;
-    try {
-      return process.kill(processInfo.pid, 0);
-    } catch {
-      return false;
+  async regenerateSidebar(notes) {
+    const allNotes = notes ?? (this.noteIndexCache.isInitialized() ? this.noteIndexCache.toNoteInfoList() : this.noteManager.scanNotes());
+    await this.updateSidebar(allNotes);
+    logger.info("\u91CD\u65B0\u751F\u6210 sidebar.json");
+  }
+  async readHomeReadmeLines() {
+    const content = await fsPromises.readFile(ROOT_README_PATH, "utf-8");
+    return content.split("\n");
+  }
+  async writeHomeReadmeLines(lines) {
+    const content = processEmptyLines(lines).join("\n");
+    await fsPromises.writeFile(ROOT_README_PATH, content, "utf-8");
+  }
+  assertGroupPath(groupPath) {
+    if (!Array.isArray(groupPath) || groupPath.length === 0) {
+      throw new Error("\u76EE\u5F55\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A");
     }
   }
-  /**
-   * 停止所有进程
-   * @param signal - 信号（默认为 SIGTERM）
-   */
-  killAll(signal = "SIGTERM") {
-    if (this.processes.size === 0) {
-      return;
+  cleanHeadingTitle(title) {
+    const cleanTitle = title.trim().replace(/^#+\s*/, "");
+    if (!cleanTitle) {
+      throw new Error("\u76EE\u5F55\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A");
     }
-    this.logger.info(`\u505C\u6B62\u6240\u6709\u8FDB\u7A0B (${this.processes.size} \u4E2A)`);
-    for (const [id, processInfo] of this.processes) {
-      try {
-        processInfo.process.kill(signal);
-        this.logger.info(`\u5DF2\u505C\u6B62\u8FDB\u7A0B: ${id}`);
-      } catch (error) {
-        this.logger.error(`\u505C\u6B62\u8FDB\u7A0B ${id} \u5931\u8D25: ${error}`);
-      }
+    if (/\r|\n/.test(cleanTitle)) {
+      throw new Error("\u76EE\u5F55\u540D\u79F0\u4E0D\u80FD\u5305\u542B\u6362\u884C");
     }
-    this.processes.clear();
+    return cleanTitle;
   }
-};
-
-// services/file-watcher/service.ts
-import { request as httpRequest } from "http";
-
-// services/file-watcher/configChangeHandler.ts
-var ConfigChangeHandler = class {
-  constructor(config2) {
-    this.config = config2;
+  getHeadingInfo(line) {
+    const match = line.match(/^(#{2,})\s+(.+)$/);
+    if (!match) return null;
+    return {
+      level: match[1].length,
+      text: match[2].trim()
+    };
   }
-  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;
+  findGroupBlock(lines, groupPath) {
+    const stack = [];
+    for (let i = 0; i < lines.length; i++) {
+      const heading = this.getHeadingInfo(lines[i]);
+      if (!heading) continue;
+      while (stack.length > 0 && stack[stack.length - 1].level >= heading.level) {
+        stack.pop();
       }
-      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");
+      stack.push(heading);
+      const currentPath = stack.map((item) => item.text);
+      if (this.isSamePath(currentPath, groupPath)) {
+        return {
+          headingIndex: i,
+          endIndex: this.findGroupEndIndex(lines, i, heading.level),
+          level: heading.level
+        };
       }
     }
-    return changedIndexes;
+    throw new Error(`\u672A\u627E\u5230\u76EE\u5F55: ${groupPath.join(" / ")}`);
   }
-};
-
-// 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;
+  findGroupEndIndex(lines, headingIndex, level) {
+    for (let i = headingIndex + 1; i < lines.length; i++) {
+      const heading = this.getHeadingInfo(lines[i]);
+      if (heading && heading.level <= level) {
+        return i;
+      }
+    }
+    return lines.length;
   }
-  /** 待处理的文件变更事件队列 */
-  pendingEvents = /* @__PURE__ */ new Map();
-  /** 防抖定时器 */
-  updateTimer = null;
-  /** 批量更新恢复定时器 */
-  batchResumeTimer = null;
-  /** 记录最近的变更时间戳 */
-  recentChanges = [];
-  /** 标记是否正在更新，避免循环触发 - 类似一把更新行为锁 */
-  isUpdating = false;
-  debounceMs;
-  batchWindowMs;
-  batchThreshold;
-  batchBufferMs;
-  /**
-   * 设置更新状态锁，用于防止在执行耗时更新操作时被新的文件变更事件打断
-   *
-   * @param flag - true 表示正在更新（锁定），false 表示更新完成（解锁）
-   */
-  setUpdating(flag) {
-    this.isUpdating = flag;
+  isSamePath(left, right) {
+    if (left.length !== right.length) return false;
+    return left.every((item, index) => item === right[index]);
   }
-  /**
-   * 获取当前是否处于更新锁定状态
-   *
-   * @returns true 表示正在执行更新操作（事件处理被暂停），false 表示空闲可处理新事件
-   */
-  getUpdating() {
-    return this.isUpdating;
+  collectNoteIndexes(lines, startIndex, endIndex) {
+    const noteIndexes = [];
+    for (let i = startIndex; i < endIndex; i++) {
+      const parsed = parseNoteLine(lines[i]);
+      if (parsed.noteIndex) {
+        noteIndexes.push(parsed.noteIndex);
+      }
+    }
+    return [...new Set(noteIndexes)];
   }
-  /**
-   * 将文件变更事件加入待处理队列，并启动防抖定时器
-   *
-   * - 若同一文件路径的事件已存在，则忽略重复事件（去重）
-   * - 每次新事件都会重置防抖计时器，确保在变更停止后才触发处理
-   *
-   * @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;
+  findNoteLineIndex(lines, noteIndex) {
+    for (let i = 0; i < lines.length; i++) {
+      const parsed = parseNoteLine(lines[i]);
+      if (parsed.noteIndex === noteIndex) {
+        return i;
+      }
     }
-    this.pendingEvents.clear();
-    this.recentChanges = [];
+    throw new Error(`README.md \u4E2D\u672A\u627E\u5230\u7B14\u8BB0: ${noteIndex}`);
+  }
+  buildNoteLines(notes) {
+    const repoOwner = this.configManager.get("author");
+    const repoName2 = this.configManager.get("repoName");
+    return notes.map((note) => buildNoteLineMarkdown(note, repoOwner, repoName2));
   }
 };
 
-// services/file-watcher/folderChangeHandler.ts
-import { existsSync as existsSync3, promises as fsPromises } from "fs";
+// services/note/service.ts
+import { writeFileSync as writeFileSync4, readFileSync as readFileSync4, promises as fsPromises2 } from "fs";
 import { join as join3 } from "path";
-
-// services/file-watcher/internal.ts
-var WATCH_EVENT_TYPES = {
-  README: "readme",
-  CONFIG: "config"
-};
-async function safeExecute(label, fn, logger2) {
-  try {
-    await fn();
-    return true;
-  } catch (error) {
-    logger2.error(`[${label}] ${error}`);
-    return false;
-  }
-}
+import { v4 as uuidv4 } from "uuid";
 
 // config/templates.ts
 function generateNoteTitle(noteIndex, title, repoUrl) {
@@ -2237,1377 +2120,1730 @@ function generateNoteTitle(noteIndex, title, repoUrl) {
   return `# [${dirName}](${repoUrl}/${encodedDirName})`;
 }
 
-// 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;
+// services/note/service.ts
+var NEW_NOTES_README_MD_TEMPLATE = `
+<!-- region:toc -->
+
+- [1. \u{1F3AF} \u672C\u8282\u5185\u5BB9](#1--\u672C\u8282\u5185\u5BB9)
+- [2. \u{1FAE7} \u8BC4\u4EF7](#2--\u8BC4\u4EF7)
+
+<!-- endregion:toc -->
+
+## 1. \u{1F3AF} \u672C\u8282\u5185\u5BB9
+
+- todo
+
+## 2. \u{1FAE7} \u8BC4\u4EF7
+
+- todo
+`;
+var NoteService = class _NoteService {
+  static instance;
+  noteManager;
+  noteIndexCache;
+  ignoredConfigPaths = /* @__PURE__ */ new Set();
+  constructor() {
+    this.noteManager = NoteManager.getInstance();
+    this.noteIndexCache = NoteIndexCache.getInstance();
   }
-  /** 活跃的定时器 ID 集合，用于统一清理 */
-  activeTimers = /* @__PURE__ */ new Set();
-  /**
-   * 清理所有活跃定时器，释放资源
-   *
-   * 在服务停止时调用，防止定时器在服务销毁后仍然触发回调
-   */
-  clearTimers() {
-    for (const timer of this.activeTimers) {
-      clearTimeout(timer);
+  static getInstance() {
+    if (!_NoteService.instance) {
+      _NoteService.instance = new _NoteService();
     }
-    this.activeTimers.clear();
-  }
-  scheduleTimer(fn, delay) {
-    const timer = setTimeout(() => {
-      this.activeTimers.delete(timer);
-      fn();
-    }, delay);
-    this.activeTimers.add(timer);
+    return _NoteService.instance;
   }
-  async handleFolderDeletion(deletedFolderName) {
-    const { scheduler, watchState, noteIndexCache, readmeService, logger: logger2 } = this.config;
-    if (scheduler.getUpdating()) return;
-    scheduler.setUpdating(true);
-    try {
-      const noteIndex = this.extractNoteIndexOrWarn(deletedFolderName);
-      if (!noteIndex) return;
-      logger2.info(`\u6B63\u5728\u5904\u7406\u7B14\u8BB0\u5220\u9664: ${noteIndex} (${deletedFolderName})`);
-      watchState.deleteNoteDir(deletedFolderName);
-      watchState.clearNoteCaches(deletedFolderName);
-      noteIndexCache.delete(noteIndex);
-      await safeExecute(
-        `\u5220\u9664\u7B14\u8BB0 ${noteIndex}`,
-        async () => {
-          await readmeService.deleteNoteFromReadme(noteIndex);
-          await readmeService.regenerateSidebar();
-        },
-        logger2
-      );
-    } finally {
-      this.scheduleTimer(() => {
-        scheduler.setUpdating(false);
-        watchState.initializeFromDisk();
-      }, DELETE_REINIT_DELAY_MS);
-    }
+  /**
+   * 标记配置文件在下次变更时被忽略（防止 API 写入触发文件监听循环）
+   * @param configPath - 配置文件路径
+   */
+  ignoreNextConfigChange(configPath) {
+    this.ignoredConfigPaths.add(configPath);
   }
-  async handleFolderRenameUpdate(oldName, newName) {
-    const { scheduler, watchState, logger: logger2 } = this.config;
-    if (scheduler.getUpdating()) return;
-    scheduler.setUpdating(true);
-    try {
-      const { oldNoteIndex, newNoteIndex } = this.validateRenameIndexes(
-        oldName,
-        newName
-      );
-      if (!oldNoteIndex || !newNoteIndex) return;
-      logger2.info(`\u6B63\u5728\u5904\u7406\u6587\u4EF6\u5939\u91CD\u547D\u540D: ${oldName} \u2192 ${newName}`);
-      if (oldNoteIndex === newNoteIndex) {
-        await safeExecute(
-          `\u6807\u9898\u91CD\u547D\u540D ${newNoteIndex}`,
-          () => this.handleTitleOnlyRename(newNoteIndex, newName),
-          logger2
-        );
-      } else {
-        await safeExecute(
-          `\u7D22\u5F15\u53D8\u66F4 ${oldNoteIndex}\u2192${newNoteIndex}`,
-          () => this.handleIndexChangedRename(oldNoteIndex, newNoteIndex),
-          logger2
-        );
-      }
-      this.config.onRenameSuccess?.({
-        oldFolder: oldName,
-        newFolder: newName,
-        noteIndex: newNoteIndex
-      });
-    } finally {
-      this.scheduleTimer(() => {
-        scheduler.setUpdating(false);
-        watchState.initializeFromDisk();
-      }, UPDATE_UNLOCK_DELAY_MS);
+  /**
+   * 检查配置文件是否应该被忽略
+   * @param configPath - 配置文件路径
+   * @returns 是否应该忽略
+   */
+  shouldIgnoreConfigChange(configPath) {
+    if (this.ignoredConfigPaths.has(configPath)) {
+      this.ignoredConfigPaths.delete(configPath);
+      return true;
     }
+    return false;
   }
-  // #region - 私有实现
-  validateRenameIndexes(oldName, newName) {
-    const { noteIndexCache, logger: logger2 } = this.config;
-    const oldNoteIndex = this.extractNoteIndexOrWarn(oldName);
-    const newNoteIndex = this.extractNoteIndexOrWarn(newName);
-    if (!oldNoteIndex || !newNoteIndex) {
-      return { oldNoteIndex: null, newNoteIndex: null };
-    }
-    if (!/^\d{4}$/.test(newNoteIndex)) {
-      logger2.error(`\u65B0\u7B14\u8BB0\u7D22\u5F15\u683C\u5F0F\u975E\u6CD5: ${newNoteIndex}\uFF0C\u81EA\u52A8\u56DE\u9000`);
-      this.revertFolderRename(oldName, newName);
-      return { oldNoteIndex: null, newNoteIndex: null };
-    }
-    if (oldNoteIndex !== newNoteIndex && noteIndexCache.has(newNoteIndex)) {
-      logger2.error(`\u65B0\u7B14\u8BB0\u7D22\u5F15 ${newNoteIndex} \u5DF2\u5B58\u5728\uFF0C\u81EA\u52A8\u56DE\u9000`);
-      this.revertFolderRename(oldName, newName);
-      return { oldNoteIndex: null, newNoteIndex: null };
+  /**
+   * 获取所有笔记
+   * dev 模式下（缓存已初始化）从内存读取，其他模式回退到文件扫描
+   * @returns 笔记信息数组
+   */
+  getAllNotes() {
+    if (this.noteIndexCache.isInitialized()) {
+      return this.noteIndexCache.toNoteInfoList();
     }
-    return { oldNoteIndex, newNoteIndex };
+    return this.noteManager.scanNotes();
   }
-  async handleTitleOnlyRename(noteIndex, newName) {
-    const { noteIndexCache, readmeService, logger: logger2, notesDir } = this.config;
-    logger2.info(`\u7B14\u8BB0\u7D22\u5F15\u672A\u53D8 (${noteIndex})\uFF0C\u53EA\u66F4\u65B0\u6807\u9898`);
-    noteIndexCache.updateFolderName(noteIndex, newName);
-    await safeExecute(
-      `\u66F4\u65B0 README \u4E00\u7EA7\u6807\u9898 ${noteIndex}`,
-      () => this.rewriteNoteReadmeH1(notesDir, newName, noteIndex),
-      logger2
-    );
-    const item = noteIndexCache.getByNoteIndex(noteIndex);
-    if (item) {
-      await readmeService.updateNoteInReadme(noteIndex, item.noteConfig);
+  /**
+   * 获取笔记（通过索引）
+   * @param noteIndex - 笔记索引（文件夹前 4 位数字）
+   * @returns 笔记信息，未找到时返回 undefined
+   */
+  getNoteByIndex(noteIndex) {
+    return this.noteManager.getNoteByIndex(noteIndex);
+  }
+  /**
+   * 创建新笔记
+   * @param options - 创建选项
+   * @returns 新创建的笔记信息
+   */
+  async createNote(options = {}) {
+    const {
+      title = "new",
+      category,
+      enableDiscussions = false,
+      configId,
+      usedIndexes
+    } = options;
+    const noteIndex = this.generateNextNoteIndex(usedIndexes);
+    const dirName = `${noteIndex}. ${title}`;
+    const notePath = join3(NOTES_PATH, dirName);
+    await ensureDirectory(notePath);
+    const readmePath = join3(notePath, "README.md");
+    const noteTitle = generateNoteTitle(noteIndex, title, REPO_NOTES_URL);
+    const readmeContent = noteTitle + "\n" + NEW_NOTES_README_MD_TEMPLATE;
+    writeFileSync4(readmePath, readmeContent, "utf-8");
+    const configPath = join3(notePath, ".tnotes.json");
+    const config2 = {
+      id: configId || uuidv4(),
+      // 配置 ID 使用 UUID（跨知识库唯一）
+      bilibili: [],
+      tnotes: [],
+      yuque: [],
+      done: false,
+      category,
+      enableDiscussions
+      // created_at / updated_at 由 tn:push 时 fix-timestamps 自动写入
+    };
+    this.noteManager.writeNoteConfig(configPath, config2);
+    const noteInfo = {
+      index: noteIndex,
+      // 返回的 id 是笔记索引（目录前缀）
+      path: notePath,
+      dirName,
+      readmePath,
+      configPath,
+      config: config2
+    };
+    if (this.noteIndexCache.isInitialized()) {
+      this.noteIndexCache.add(noteInfo);
     }
-    await readmeService.regenerateSidebar();
-    logger2.success(`\u6807\u9898\u66F4\u65B0\u5B8C\u6210`);
+    logger.info(`Created new note: ${dirName}`);
+    return noteInfo;
   }
   /**
-   * 重写指定笔记目录下 README.md 的一级标题。
-   *
-   * 输入的 `folderName` 形如 `0003. 评论功能的技术实现`，
-   * 据此推导出新标题文本（去掉 `${noteIndex}. ` 前缀）。
+   * 删除笔记文件夹
+   * @param noteIndex - 笔记索引
+   * @returns 被删除的笔记信息
    */
-  async rewriteNoteReadmeH1(notesDir, folderName, noteIndex) {
-    const readmePath = join3(notesDir, folderName, "README.md");
-    if (!existsSync3(readmePath)) return;
-    const newTitle = folderName.replace(/^\d{4}\.\s*/, "").trim();
-    if (!newTitle) return;
-    const content = await fsPromises.readFile(readmePath, "utf-8");
-    const lines = content.split("\n");
-    let h1Index = -1;
-    for (let i = 0; i < lines.length; i++) {
-      if (lines[i].trim().startsWith("# ")) {
-        h1Index = i;
-        break;
+  async deleteNote(noteIndex) {
+    const note = this.getNoteByIndex(noteIndex);
+    if (!note) {
+      throw new Error(`\u7B14\u8BB0\u672A\u627E\u5230: ${noteIndex}`);
+    }
+    await fsPromises2.rm(note.path, { recursive: true, force: true });
+    if (this.noteIndexCache.isInitialized()) {
+      this.noteIndexCache.delete(noteIndex);
+    }
+    logger.info(`Deleted note: ${note.dirName}`);
+    return note;
+  }
+  /**
+   * 生成下一个笔记索引（填充空缺）
+   * @param usedIndexes - 可选的已使用编号集合，不传则内部扫描
+   * @returns 新的笔记索引（4位数字字符串，从 0001 到 9999）
+   */
+  generateNextNoteIndex(usedIndexes) {
+    if (!usedIndexes) {
+      const notes = this.getAllNotes();
+      usedIndexes = /* @__PURE__ */ new Set();
+      for (const note of notes) {
+        const id = parseInt(note.index, 10);
+        if (!isNaN(id) && id >= 1 && id <= 9999) {
+          usedIndexes.add(id);
+        }
       }
     }
-    if (h1Index === -1) {
-      this.config.logger.warn(
-        `\u672A\u5728 ${readmePath} \u627E\u5230\u4E00\u7EA7\u6807\u9898\uFF0C\u8DF3\u8FC7 README H1 \u66F4\u65B0`
-      );
-      return;
+    if (usedIndexes.size === 0) {
+      return "0001";
     }
-    const newH1 = generateNoteTitle(noteIndex, newTitle, REPO_NOTES_URL);
-    if (lines[h1Index] === newH1) return;
-    lines[h1Index] = newH1;
-    await fsPromises.writeFile(readmePath, lines.join("\n"), "utf-8");
+    for (let i = 1; i <= 9999; i++) {
+      if (!usedIndexes.has(i)) {
+        return i.toString().padStart(CONSTANTS.NOTE_INDEX_LENGTH, "0");
+      }
+    }
+    throw new Error("\u6240\u6709\u7B14\u8BB0\u7F16\u53F7 (0001-9999) \u5DF2\u88AB\u5360\u7528\uFF0C\u65E0\u6CD5\u521B\u5EFA\u65B0\u7B14\u8BB0");
   }
-  async handleIndexChangedRename(oldNoteIndex, newNoteIndex) {
-    const { noteService, noteIndexCache, readmeService, logger: logger2 } = this.config;
-    logger2.info(`\u7B14\u8BB0\u7D22\u5F15\u53D8\u66F4: ${oldNoteIndex} \u2192 ${newNoteIndex}`);
-    await readmeService.deleteNoteFromReadme(oldNoteIndex);
-    const newNote = noteService.getNoteByIndex(newNoteIndex);
-    if (newNote) {
-      noteIndexCache.delete(oldNoteIndex);
-      noteIndexCache.add(newNote);
-      await readmeService.appendNoteToReadme(newNoteIndex);
+  /**
+   * 更新笔记配置
+   * @param noteIndex - 笔记索引
+   * @param updates - 配置更新
+   */
+  async updateNoteConfig(noteIndex, updates) {
+    const note = this.getNoteByIndex(noteIndex);
+    if (!note || !note.config) {
+      throw new Error(`Note not found or no config: ${noteIndex}`);
+    }
+    const oldConfig = { ...note.config };
+    const updatedConfig = {
+      ...note.config,
+      ...updates
+    };
+    this.ignoreNextConfigChange(note.configPath);
+    this.noteManager.updateNoteConfig(note, updatedConfig);
+    this.noteIndexCache.updateConfig(noteIndex, updatedConfig);
+    const needsGlobalUpdate = this.checkNeedsGlobalUpdate(
+      oldConfig,
+      updatedConfig
+    );
+    if (needsGlobalUpdate) {
+      logger.info(`\u68C0\u6D4B\u5230\u5168\u5C40\u5B57\u6BB5\u53D8\u66F4 (${noteIndex})\uFF0C\u6B63\u5728\u589E\u91CF\u66F4\u65B0\u5168\u5C40\u6587\u4EF6...`);
+      const readmeService = ReadmeService.getInstance();
+      await readmeService.updateNoteInReadme(noteIndex, updates);
       await readmeService.regenerateSidebar();
-      logger2.success(`\u7B14\u8BB0\u7D22\u5F15\u53D8\u66F4\u5904\u7406\u5B8C\u6210`);
+      logger.info(`\u5168\u5C40\u6587\u4EF6\u589E\u91CF\u66F4\u65B0\u5B8C\u6210 (${noteIndex})`);
     } else {
-      logger2.error(`\u672A\u627E\u5230\u65B0\u7B14\u8BB0: ${newNoteIndex}`);
+      logger.debug(`\u914D\u7F6E\u66F4\u65B0\u4E0D\u5F71\u54CD\u5168\u5C40\u6587\u4EF6 (${noteIndex})`);
     }
   }
-  async revertFolderRename(oldName, newName) {
-    const { notesDir, scheduler, watchState, logger: logger2 } = this.config;
+  /**
+   * 检查配置更新是否需要触发全局更新
+   * @param oldConfig - 旧配置
+   * @param newConfig - 新配置
+   * @returns 是否需要全局更新
+   */
+  checkNeedsGlobalUpdate(oldConfig, newConfig) {
+    const globalFields = ["done"];
+    for (const field of globalFields) {
+      if (oldConfig[field] !== newConfig[field]) {
+        return true;
+      }
+    }
+    return false;
+  }
+  /**
+   * 修正笔记标题
+   * @param noteInfo - 笔记信息
+   * @returns 是否进行了修正
+   */
+  async fixNoteTitle(noteInfo) {
     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);
+      const readmeContent = readFileSync4(noteInfo.readmePath, "utf-8");
+      if (readmeContent.length === 0) return false;
+      const lines = readmeContent.split("\n");
+      const match = noteInfo.dirName.match(/^\d{4}\.\s+(.+)$/);
+      if (!match) {
+        logger.warn(`\u68C0\u6D4B\u5230\u9519\u8BEF\u7684\u7B14\u8BB0\u76EE\u5F55\u540D\u79F0\uFF1A${noteInfo.dirName}`);
+        return false;
+      }
+      const expectedTitle = match[1];
+      const expectedH1 = generateNoteTitle(
+        noteInfo.index,
+        expectedTitle,
+        REPO_NOTES_URL
+      );
+      const firstLine = lines[0].trim();
+      if (!firstLine.startsWith("# ")) {
+        lines.unshift(expectedH1);
+        writeFileSync4(noteInfo.readmePath, lines.join("\n"), "utf-8");
+        logger.info(`Added title to: ${noteInfo.dirName}`);
+        return true;
+      }
+      if (firstLine !== expectedH1) {
+        lines[0] = expectedH1;
+        writeFileSync4(noteInfo.readmePath, lines.join("\n"), "utf-8");
+        logger.info(`Fixed title for: ${noteInfo.dirName}`);
+        return true;
       }
+      return false;
     } catch (error) {
-      logger2.error(`\u56DE\u9000\u6587\u4EF6\u5939\u91CD\u547D\u540D\u5931\u8D25: ${error}`);
+      logger.error(`Failed to fix title for: ${noteInfo.dirName}`, error);
+      return false;
     }
   }
-  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}`);
+  /**
+   * 修正所有笔记的标题
+   * @param providedNotes - 可选的笔记列表，不传则内部扫描
+   * @returns 修正的笔记数量
+   */
+  async fixAllNoteTitles(providedNotes) {
+    const notes = providedNotes ?? this.getAllNotes();
+    let fixedCount = 0;
+    for (const note of notes) {
+      const fixed = await this.fixNoteTitle(note);
+      if (fixed) {
+        fixedCount++;
+      }
     }
-    return noteIndex;
+    if (fixedCount > 0) {
+      logger.info(`Fixed ${fixedCount} note titles`);
+    }
+    return fixedCount;
   }
-  // #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 {
+// services/file-watcher/service.ts
+import { request as httpRequest } from "http";
+
+// services/file-watcher/configChangeHandler.ts
+var ConfigChangeHandler = 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}`);
-        }
+    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;
       }
-      dirCache.add(folderName);
-      if (this.pendingFolderRename) {
-        dirCache.delete(this.pendingFolderRename.oldName);
+      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");
       }
     }
-  }
-  clearTimers() {
-    if (this.folderRenameTimer) {
-      clearTimeout(this.folderRenameTimer);
-      this.folderRenameTimer = null;
-    }
-    this.pendingFolderRename = null;
+    return changedIndexes;
   }
 };
 
-// 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 {
+// 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;
   }
-  /** 文件哈希缓存 */
-  fileHashes = /* @__PURE__ */ new Map();
-  /** 笔记目录缓存 */
-  noteDirCache = /* @__PURE__ */ new Set();
-  /** 笔记配置缓存 */
-  configCache = /* @__PURE__ */ new Map();
+  /** 待处理的文件变更事件队列 */
+  pendingEvents = /* @__PURE__ */ new Map();
+  /** 防抖定时器 */
+  updateTimer = null;
+  /** 批量更新恢复定时器 */
+  batchResumeTimer = null;
+  /** 记录最近的变更时间戳 */
+  recentChanges = [];
+  /** 标记是否正在更新，避免循环触发 - 类似一把更新行为锁 */
+  isUpdating = false;
+  debounceMs;
+  batchWindowMs;
+  batchThreshold;
+  batchBufferMs;
   /**
-   * 获取指定文件的 MD5 哈希值，若文件不存在或读取失败返回 null
+   * 设置更新状态锁，用于防止在执行耗时更新操作时被新的文件变更事件打断
    *
-   * @param filePath 文件路径
-   * @returns 文件哈希
+   * @param flag - true 表示正在更新（锁定），false 表示更新完成（解锁）
    */
-  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;
-    }
+  setUpdating(flag) {
+    this.isUpdating = flag;
   }
   /**
-   * 更新文件哈希缓存，只有当文件内容发生变化时才更新并返回 true
+   * 获取当前是否处于更新锁定状态
    *
-   * @param filePath 文件路径
-   * @returns 是否发生变化
+   * @returns true 表示正在执行更新操作（事件处理被暂停），false 表示空闲可处理新事件
    */
-  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;
+  getUpdating() {
+    return this.isUpdating;
   }
   /**
-   * 检查指定名称的笔记目录是否已存在于缓存中
+   * 将文件变更事件加入待处理队列，并启动防抖定时器
    *
-   * @param name 笔记目录名称
-   * @returns 若存在则返回 true，否则返回 false
+   * - 若同一文件路径的事件已存在，则忽略重复事件（去重）
+   * - 每次新事件都会重置防抖计时器，确保在变更停止后才触发处理
+   *
+   * @param event 文件变更事件
    */
-  hasNoteDir(name) {
-    return this.noteDirCache.has(name);
+  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);
   }
   /**
-   * 将指定名称的笔记目录添加到缓存中
+   * 立即触发事件队列的处理（防抖到期或手动调用）
    *
-   * @param name 笔记目录名称
+   * - 若当前正在更新（isUpdating 为 true），则跳过以避免重复处理
+   * - 清空待处理事件队列，并通过 onFlush 回调交由上层服务处理
+   * - 处理开始后会锁定更新状态，防止处理过程中被新事件打断
    */
-  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 = 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);
+  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);
   }
   /**
-   * 获取指定配置文件路径对应的配置快照
+   * 记录当前变更时间并检测是否触发批量更新模式
    *
-   * @param configPath 配置文件路径（通常为 .tnotes.json 的绝对路径）
-   * @returns 配置快照，若不存在则返回 undefined
-   */
-  getConfigSnapshot(configPath) {
-    return this.configCache.get(configPath);
-  }
-  /**
-   * 设置指定配置文件路径的配置快照到缓存中
+   * - 维护一个滑动时间窗口（BATCH_UPDATE_WINDOW_MS）内的变更记录
+   * - 若短时间内（1秒内）变更次数达到阈值（BATCH_UPDATE_THRESHOLD = 3），则判定为批量操作
+   * - 触发批量模式后：
+   *   1. 清空当前待处理事件队列，避免重复处理
+   *   2. 锁定更新状态（isUpdating = true）
+   *   3. 暂停监听服务，并在延迟（窗口 + 缓冲时间）后自动恢复
    *
-   * @param configPath 配置文件路径（通常为 .tnotes.json 的绝对路径）
-   * @param snapshot 配置快照对象
+   * @param now 当前时间戳（默认使用 Date.now()）
+   * @returns true 表示已触发批量更新模式，false 表示仍处于普通监听模式
    */
-  setConfigSnapshot(configPath, snapshot) {
-    this.configCache.set(configPath, snapshot);
+  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;
   }
   /**
-   * 读取指定配置文件的快照
-   *
-   * 解析 .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;
+  clearTimers() {
+    if (this.updateTimer) {
+      clearTimeout(this.updateTimer);
+      this.updateTimer = null;
     }
-  }
-  /**
-   * 从磁盘初始化监听状态缓存：
-   * 遍历笔记根目录下的所有子目录，将每个笔记目录的 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}`
-      );
+    if (this.batchResumeTimer) {
+      clearTimeout(this.batchResumeTimer);
+      this.batchResumeTimer = null;
     }
+    this.pendingEvents.clear();
+    this.recentChanges = [];
   }
 };
 
-// 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";
+// services/file-watcher/folderChangeHandler.ts
+import { existsSync as existsSync4, promises as fsPromises3 } from "fs";
+import { join as join4 } from "path";
 
-// services/readme/service.ts
-import {
-  existsSync as existsSync6,
-  readFileSync as readFileSync4,
-  writeFileSync as writeFileSync3,
-  promises as fsPromises2
-} from "fs";
-var ReadmeService = class _ReadmeService {
-  static instance;
-  noteManager;
-  readmeGenerator;
-  configManager;
-  noteIndexCache;
-  constructor() {
-    this.noteManager = NoteManager.getInstance();
-    this.readmeGenerator = new ReadmeGenerator();
-    this.configManager = ConfigManager.getInstance();
-    this.noteIndexCache = NoteIndexCache.getInstance();
+// services/file-watcher/internal.ts
+var WATCH_EVENT_TYPES = {
+  README: "readme",
+  CONFIG: "config"
+};
+async function safeExecute(label, fn, logger2) {
+  try {
+    await fn();
+    return true;
+  } catch (error) {
+    logger2.error(`[${label}] ${error}`);
+    return false;
   }
-  static getInstance() {
-    if (!_ReadmeService.instance) {
-      _ReadmeService.instance = new _ReadmeService();
-    }
-    return _ReadmeService.instance;
+}
+
+// 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;
   }
+  /** 活跃的定时器 ID 集合，用于统一清理 */
+  activeTimers = /* @__PURE__ */ new Set();
   /**
-   * 更新所有笔记的 README
-   * @param options - 更新选项
+   * 清理所有活跃定时器，释放资源
+   *
+   * 在服务停止时调用，防止定时器在服务销毁后仍然触发回调
    */
-  async updateAllReadmes(options = {}) {
-    const {
-      updateSidebar = true,
-      updateHome = true,
-      notes: providedNotes
-    } = options;
-    logger.info("\u5F00\u59CB\u66F4\u65B0\u77E5\u8BC6\u5E93...");
-    const notes = providedNotes ?? this.noteManager.scanNotes();
-    logger.info(`\u626B\u63CF\u5230 ${notes.length} \u7BC7\u7B14\u8BB0`);
-    const changedIndexes = await this.getChangedNoteIndexes();
-    const shouldIncrementalUpdate = changedIndexes.size > 0 && changedIndexes.size < notes.length * 0.3;
-    let notesToUpdate = notes;
-    if (shouldIncrementalUpdate) {
-      notesToUpdate = notes.filter((note) => changedIndexes.has(note.index));
-      logger.info(
-        `\u68C0\u6D4B\u5230 ${changedIndexes.size} \u7BC7\u7B14\u8BB0\u6709\u53D8\u66F4\uFF0C\u4F7F\u7528\u589E\u91CF\u66F4\u65B0\u6A21\u5F0F`
-      );
-    } else {
-      logger.info("\u4F7F\u7528\u5168\u91CF\u66F4\u65B0\u6A21\u5F0F");
-    }
-    const startTime = Date.now();
-    await this.updateNoteReadmesInParallel(notesToUpdate);
-    const updateTime = Date.now() - startTime;
-    logger.info(`\u66F4\u65B0\u4E86 ${notesToUpdate.length} \u7BC7\u7B14\u8BB0 (\u8017\u65F6 ${updateTime}ms)`);
-    if (updateHome) {
-      await this.updateHomeReadme(notes);
-    }
-    if (updateSidebar) {
-      await this.updateSidebar(notes);
+  clearTimers() {
+    for (const timer of this.activeTimers) {
+      clearTimeout(timer);
     }
-    logger.info("\u77E5\u8BC6\u5E93\u66F4\u65B0\u5B8C\u6210\uFF01");
+    this.activeTimers.clear();
   }
-  /**
-   * 只更新指定笔记的 README（不更新 sidebar、home）
-   * @param noteIndexes - 笔记索引数组，例如 ['0001', '0002']
-   */
-  async updateNoteReadmesOnly(noteIndexes) {
-    if (noteIndexes.length === 0) return;
-    const notesToUpdate = [];
-    for (const noteIndex of noteIndexes) {
-      const note = this.noteManager.getNoteByIndex(noteIndex);
-      if (note) {
-        notesToUpdate.push(note);
-      } else {
-        logger.warn(`\u7B14\u8BB0\u672A\u627E\u5230: ${noteIndex}`);
-      }
-    }
-    if (notesToUpdate.length === 0) {
-      logger.warn("\u6CA1\u6709\u627E\u5230\u9700\u8981\u66F4\u65B0\u7684\u7B14\u8BB0");
-      return;
-    }
-    for (const note of notesToUpdate) {
-      try {
-        this.readmeGenerator.updateNoteReadme(note);
-      } catch (error) {
-        logger.error(`\u66F4\u65B0\u7B14\u8BB0 ${note.dirName} \u5931\u8D25`, error);
-      }
-    }
+  scheduleTimer(fn, delay) {
+    const timer = setTimeout(() => {
+      this.activeTimers.delete(timer);
+      fn();
+    }, delay);
+    this.activeTimers.add(timer);
   }
-  /**
-   * 获取变更的笔记索引集合
-   * @returns 变更的笔记索引集合
-   */
-  async getChangedNoteIndexes() {
+  async handleFolderDeletion(deletedFolderName) {
+    const { scheduler, watchState, noteIndexCache, readmeService, logger: logger2 } = this.config;
+    if (scheduler.getUpdating()) return;
+    scheduler.setUpdating(true);
     try {
-      return getChangedIds();
-    } catch (error) {
-      return /* @__PURE__ */ new Set();
+      const noteIndex = this.extractNoteIndexOrWarn(deletedFolderName);
+      if (!noteIndex) return;
+      logger2.info(`\u6B63\u5728\u5904\u7406\u7B14\u8BB0\u5220\u9664: ${noteIndex} (${deletedFolderName})`);
+      watchState.deleteNoteDir(deletedFolderName);
+      watchState.clearNoteCaches(deletedFolderName);
+      noteIndexCache.delete(noteIndex);
+      await safeExecute(
+        `\u5220\u9664\u7B14\u8BB0 ${noteIndex}`,
+        async () => {
+          await readmeService.deleteNoteFromReadme(noteIndex);
+          await readmeService.regenerateSidebar();
+        },
+        logger2
+      );
+    } finally {
+      this.scheduleTimer(() => {
+        scheduler.setUpdating(false);
+        watchState.initializeFromDisk();
+      }, DELETE_REINIT_DELAY_MS);
     }
   }
-  /**
-   * 并行更新多个笔记的 README
-   * @param notes - 笔记信息数组
-   */
-  async updateNoteReadmesInParallel(notes) {
-    const batchSize = 10;
-    const batches = [];
-    for (let i = 0; i < notes.length; i += batchSize) {
-      batches.push(notes.slice(i, i + batchSize));
-    }
-    let successCount = 0;
-    let failCount = 0;
-    for (const batch of batches) {
-      const results = await Promise.allSettled(
-        batch.map(
-          (note) => Promise.resolve().then(() => {
-            this.readmeGenerator.updateNoteReadme(note);
-          })
-        )
+  async handleFolderRenameUpdate(oldName, newName) {
+    const { scheduler, watchState, logger: logger2 } = this.config;
+    if (scheduler.getUpdating()) return;
+    scheduler.setUpdating(true);
+    try {
+      const { oldNoteIndex, newNoteIndex } = this.validateRenameIndexes(
+        oldName,
+        newName
       );
-      for (const result of results) {
-        if (result.status === "fulfilled") {
-          successCount++;
-        } else {
-          failCount++;
-          logger.error("\u66F4\u65B0\u7B14\u8BB0\u5931\u8D25", result.reason);
-        }
+      if (!oldNoteIndex || !newNoteIndex) return;
+      logger2.info(`\u6B63\u5728\u5904\u7406\u6587\u4EF6\u5939\u91CD\u547D\u540D: ${oldName} \u2192 ${newName}`);
+      if (oldNoteIndex === newNoteIndex) {
+        await safeExecute(
+          `\u6807\u9898\u91CD\u547D\u540D ${newNoteIndex}`,
+          () => this.handleTitleOnlyRename(newNoteIndex, newName),
+          logger2
+        );
+      } else {
+        await safeExecute(
+          `\u7D22\u5F15\u53D8\u66F4 ${oldNoteIndex}\u2192${newNoteIndex}`,
+          () => this.handleIndexChangedRename(oldNoteIndex, newNoteIndex),
+          logger2
+        );
       }
-    }
-    if (failCount > 0) {
-      logger.warn(`\u66F4\u65B0\u5B8C\u6210\uFF1A\u6210\u529F ${successCount} \u7BC7\uFF0C\u5931\u8D25 ${failCount} \u7BC7`);
+      this.config.onRenameSuccess?.({
+        oldFolder: oldName,
+        newFolder: newName,
+        noteIndex: newNoteIndex
+      });
+    } finally {
+      this.scheduleTimer(() => {
+        scheduler.setUpdating(false);
+        watchState.initializeFromDisk();
+      }, UPDATE_UNLOCK_DELAY_MS);
     }
   }
-  /**
-   * 更新侧边栏配置
-   * @param notes - 笔记信息数组
-   */
-  async updateSidebar(notes) {
-    if (!existsSync6(ROOT_README_PATH)) {
-      logger.error("\u672A\u627E\u5230\u9996\u9875 README\uFF0C\u65E0\u6CD5\u751F\u6210\u4FA7\u8FB9\u680F");
-      return;
+  // #region - 私有实现
+  validateRenameIndexes(oldName, newName) {
+    const { noteIndexCache, logger: logger2 } = this.config;
+    const oldNoteIndex = this.extractNoteIndexOrWarn(oldName);
+    const newNoteIndex = this.extractNoteIndexOrWarn(newName);
+    if (!oldNoteIndex || !newNoteIndex) {
+      return { oldNoteIndex: null, newNoteIndex: null };
     }
-    const content = readFileSync4(ROOT_README_PATH, "utf-8");
-    const lines = content.split("\n");
-    const itemList = [];
-    const titles = [];
-    const titlesNotesCount = [];
-    let currentNoteCount = 0;
-    let inTocRegion = false;
-    for (const line of lines) {
-      if (line.includes("<!-- region:toc -->")) {
-        inTocRegion = true;
-        continue;
-      }
-      if (line.includes("<!-- endregion:toc -->")) {
-        inTocRegion = false;
-        continue;
-      }
-      if (inTocRegion) {
-        continue;
-      }
-      const parsed = parseNoteLine(line);
-      if (parsed.isMatch && parsed.noteIndex) {
-        const note = notes.find((n) => n.index === parsed.noteIndex);
-        if (!note) {
-          logger.warn(`\u672A\u627E\u5230\u7B14\u8BB0\u7D22\u5F15: ${parsed.noteIndex}`);
-          continue;
-        }
-        let statusEmoji = "\u23F0 ";
-        if (note?.config) {
-          if (note.config.done) {
-            statusEmoji = "\u2705 ";
-          }
-        }
-        const sidebarShowNoteId2 = this.configManager.get("sidebarShowNoteId");
-        let displayText = note.dirName;
-        if (!sidebarShowNoteId2) {
-          displayText = note.dirName.replace(/^\d{4}\.\s/, "");
-        }
-        itemList.push({
-          text: statusEmoji + displayText,
-          link: `/notes/${note.dirName}/README`
-        });
-        currentNoteCount++;
-        continue;
-      }
-      const titleMatch = line.match(/^(#{2,})\s+(.+)$/);
-      if (titleMatch) {
-        if (titles.length > 0) {
-          titlesNotesCount.push(currentNoteCount);
-        }
-        titles.push(line);
-        currentNoteCount = 0;
-      }
+    if (!/^\d{4}$/.test(newNoteIndex)) {
+      logger2.error(`\u65B0\u7B14\u8BB0\u7D22\u5F15\u683C\u5F0F\u975E\u6CD5: ${newNoteIndex}\uFF0C\u81EA\u52A8\u56DE\u9000`);
+      this.revertFolderRename(oldName, newName);
+      return { oldNoteIndex: null, newNoteIndex: null };
     }
-    if (titles.length > 0) {
-      titlesNotesCount.push(currentNoteCount);
+    if (oldNoteIndex !== newNoteIndex && noteIndexCache.has(newNoteIndex)) {
+      logger2.error(`\u65B0\u7B14\u8BB0\u7D22\u5F15 ${newNoteIndex} \u5DF2\u5B58\u5728\uFF0C\u81EA\u52A8\u56DE\u9000`);
+      this.revertFolderRename(oldName, newName);
+      return { oldNoteIndex: null, newNoteIndex: null };
     }
-    const sidebarIsCollapsed = true;
-    const hierarchicalSidebar = genHierarchicalSidebar(
-      itemList,
-      titles,
-      titlesNotesCount,
-      sidebarIsCollapsed
-    );
-    writeFileSync3(
-      VP_SIDEBAR_PATH,
-      JSON.stringify(hierarchicalSidebar, null, 2),
-      "utf-8"
-    );
-    logger.info("\u5DF2\u66F4\u65B0\u4FA7\u8FB9\u680F\u914D\u7F6E");
-  }
-  /**
-   * 更新首页 README
-   * @param notes - 笔记信息数组
-   */
-  async updateHomeReadme(notes) {
-    this.readmeGenerator.updateHomeReadme(notes, ROOT_README_PATH);
+    return { oldNoteIndex, newNoteIndex };
   }
-  /**
-   * 增量更新首页 README 中的单个笔记
-   * @param noteIndex - 笔记索引
-   * @param updates - 需要更新的配置字段
-   */
-  async updateNoteInReadme(noteIndex, updates) {
-    const item = this.noteIndexCache.getByNoteIndex(noteIndex);
-    if (!item) {
-      logger.warn(`\u5C1D\u8BD5\u66F4\u65B0\u4E0D\u5B58\u5728\u7684\u7B14\u8BB0: ${noteIndex}`);
-      return;
-    }
-    const content = await fsPromises2.readFile(ROOT_README_PATH, "utf-8");
-    const lines = content.split("\n");
-    const repoOwner = this.configManager.get("author");
-    const repoName2 = this.configManager.get("repoName");
-    const mergedConfig = { ...item.noteConfig, ...updates };
-    const tempNoteInfo = {
-      index: noteIndex,
-      dirName: item.folderName,
-      path: "",
-      readmePath: "",
-      configPath: "",
-      config: mergedConfig
-    };
-    let updated = false;
-    for (let i = 0; i < lines.length; i++) {
-      const parsed = parseNoteLine(lines[i]);
-      if (parsed.noteIndex === noteIndex) {
-        lines[i] = buildNoteLineMarkdown(tempNoteInfo, repoOwner, repoName2);
-        updated = true;
-      }
-    }
-    if (updated) {
-      await fsPromises2.writeFile(ROOT_README_PATH, lines.join("\n"), "utf-8");
-      logger.info(`\u589E\u91CF\u66F4\u65B0 README.md \u4E2D\u7684\u7B14\u8BB0: ${noteIndex}`);
-    } else {
-      logger.warn(`README.md \u4E2D\u672A\u627E\u5230\u7B14\u8BB0: ${noteIndex}`);
+  async handleTitleOnlyRename(noteIndex, newName) {
+    const { noteIndexCache, readmeService, logger: logger2, notesDir } = this.config;
+    logger2.info(`\u7B14\u8BB0\u7D22\u5F15\u672A\u53D8 (${noteIndex})\uFF0C\u53EA\u66F4\u65B0\u6807\u9898`);
+    noteIndexCache.updateFolderName(noteIndex, newName);
+    await safeExecute(
+      `\u66F4\u65B0 README \u4E00\u7EA7\u6807\u9898 ${noteIndex}`,
+      () => this.rewriteNoteReadmeH1(notesDir, newName, noteIndex),
+      logger2
+    );
+    const item = noteIndexCache.getByNoteIndex(noteIndex);
+    if (item) {
+      await readmeService.updateNoteInReadme(noteIndex, item.noteConfig);
     }
+    await readmeService.regenerateSidebar();
+    logger2.success(`\u6807\u9898\u66F4\u65B0\u5B8C\u6210`);
   }
   /**
-   * 从首页 README 中删除笔记
-   * @param noteIndex - 笔记索引
+   * 重写指定笔记目录下 README.md 的一级标题。
+   *
+   * 输入的 `folderName` 形如 `0003. 评论功能的技术实现`，
+   * 据此推导出新标题文本（去掉 `${noteIndex}. ` 前缀）。
    */
-  async deleteNoteFromReadme(noteIndex) {
-    const content = await fsPromises2.readFile(ROOT_README_PATH, "utf-8");
+  async rewriteNoteReadmeH1(notesDir, folderName, noteIndex) {
+    const readmePath = join4(notesDir, folderName, "README.md");
+    if (!existsSync4(readmePath)) return;
+    const newTitle = folderName.replace(/^\d{4}\.\s*/, "").trim();
+    if (!newTitle) return;
+    const content = await fsPromises3.readFile(readmePath, "utf-8");
     const lines = content.split("\n");
-    const linesToRemove = [];
+    let h1Index = -1;
     for (let i = 0; i < lines.length; i++) {
-      const parsed = parseNoteLine(lines[i]);
-      if (parsed.noteIndex === noteIndex) {
-        linesToRemove.push(i);
+      if (lines[i].trim().startsWith("# ")) {
+        h1Index = i;
+        break;
       }
     }
-    if (linesToRemove.length > 0) {
-      for (let i = linesToRemove.length - 1; i >= 0; i--) {
-        lines.splice(linesToRemove[i], 1);
-      }
-      await fsPromises2.writeFile(ROOT_README_PATH, lines.join("\n"), "utf-8");
-      logger.info(
-        `\u4ECE README.md \u4E2D\u5220\u9664\u7B14\u8BB0: ${noteIndex} (${linesToRemove.length} \u5904\u5F15\u7528)`
+    if (h1Index === -1) {
+      this.config.logger.warn(
+        `\u672A\u5728 ${readmePath} \u627E\u5230\u4E00\u7EA7\u6807\u9898\uFF0C\u8DF3\u8FC7 README H1 \u66F4\u65B0`
       );
-    } else {
-      logger.warn(`README.md \u4E2D\u672A\u627E\u5230\u7B14\u8BB0: ${noteIndex}`);
+      return;
     }
-  }
+    const newH1 = generateNoteTitle(noteIndex, newTitle, REPO_NOTES_URL);
+    if (lines[h1Index] === newH1) return;
+    lines[h1Index] = newH1;
+    await fsPromises3.writeFile(readmePath, lines.join("\n"), "utf-8");
+  }
+  async handleIndexChangedRename(oldNoteIndex, newNoteIndex) {
+    const { noteService, noteIndexCache, readmeService, logger: logger2 } = this.config;
+    logger2.info(`\u7B14\u8BB0\u7D22\u5F15\u53D8\u66F4: ${oldNoteIndex} \u2192 ${newNoteIndex}`);
+    await readmeService.deleteNoteFromReadme(oldNoteIndex);
+    const newNote = noteService.getNoteByIndex(newNoteIndex);
+    if (newNote) {
+      noteIndexCache.delete(oldNoteIndex);
+      noteIndexCache.add(newNote);
+      await readmeService.appendNoteToReadme(newNoteIndex);
+      await readmeService.regenerateSidebar();
+      logger2.success(`\u7B14\u8BB0\u7D22\u5F15\u53D8\u66F4\u5904\u7406\u5B8C\u6210`);
+    } else {
+      logger2.error(`\u672A\u627E\u5230\u65B0\u7B14\u8BB0: ${newNoteIndex}`);
+    }
+  }
+  async revertFolderRename(oldName, newName) {
+    const { notesDir, scheduler, watchState, logger: logger2 } = this.config;
+    try {
+      const oldPath = join4(notesDir, oldName);
+      const newPath = join4(notesDir, newName);
+      if (existsSync4(newPath)) {
+        scheduler.setUpdating(true);
+        await fsPromises3.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 join5, 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 = join5(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 existsSync5 } from "fs";
+import { join as join6 } 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 = join6(notesDir, folderName);
+    const folderExists = existsSync5(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 existsSync6, readFileSync as readFileSync5, readdirSync as readdirSync2, statSync } from "fs";
+import { join as join7 } 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 (!existsSync6(filePath)) return null;
+      const content = readFileSync5(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 = join7(this.config.notesDir, noteDirName, "README.md");
+    const configPath = join7(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 (!existsSync6(configPath)) return null;
+      const content = readFileSync5(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 = join7(this.config.notesDir, noteDir);
+        if (!statSync(noteDirPath).isDirectory()) continue;
+        this.noteDirCache.add(noteDir);
+        const readmePath = join7(noteDirPath, "README.md");
+        const readmeHash = this.getFileHash(readmePath);
+        if (readmeHash) this.fileHashes.set(readmePath, readmeHash);
+        const configPath = join7(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/service.ts
+var NOTES_DIR_NOT_SET_ERROR = "NOTES_DIR_PATH \u672A\u8BBE\u7F6E\uFF0C\u65E0\u6CD5\u542F\u52A8\u6587\u4EF6\u76D1\u542C";
+var UPDATE_UNLOCK_DELAY_MS2 = 500;
+var RENAME_BROADCAST_PATH = "/__tnotes_broadcast_rename";
+var FileWatcherService = class _FileWatcherService {
+  constructor(notesDir = NOTES_DIR_PATH) {
+    this.notesDir = notesDir;
+    if (!this.notesDir) {
+      throw new Error(NOTES_DIR_NOT_SET_ERROR);
+    }
+    this.init();
+    _FileWatcherService.instance = this;
+  }
+  static instance = null;
+  watchState;
+  scheduler;
+  renameDetector;
+  configHandler;
+  readmeHandler;
+  coordinator;
+  folderHandler;
+  adapter;
+  noteService;
+  readmeService;
+  noteIndexCache;
+  unlockTimer = null;
+  static getInstance() {
+    return _FileWatcherService.instance;
+  }
+  init() {
+    this.noteService = NoteService.getInstance();
+    this.readmeService = ReadmeService.getInstance();
+    this.noteIndexCache = NoteIndexCache.getInstance();
+    this.watchState = this.initWatchState();
+    this.scheduler = this.initScheduler();
+    this.folderHandler = this.initFolderHandler();
+    this.renameDetector = this.initRenameDetector();
+    this.configHandler = this.initConfigHandler();
+    this.readmeHandler = this.initReadmeHandler();
+    this.coordinator = this.initCoordinator();
+    this.adapter = this.initAdapter();
+  }
+  initWatchState() {
+    const watchState = new WatchState({ notesDir: this.notesDir, logger });
+    watchState.initializeFromDisk();
+    return watchState;
+  }
+  initScheduler() {
+    return new EventScheduler({
+      onFlush: (events) => this.handleFileChange(events),
+      onPauseForBatch: () => logger.warn("\u76D1\u542C\u670D\u52A1\u6682\u505C 3s \u7B49\u5F85\u6279\u91CF\u66F4\u65B0\u5B8C\u6210..."),
+      onResumeAfterBatch: () => logger.info("\u6062\u590D\u81EA\u52A8\u76D1\u542C"),
+      reinit: () => this.watchState.initializeFromDisk()
+    });
+  }
+  initFolderHandler() {
+    return new FolderChangeHandler({
+      notesDir: this.notesDir,
+      watchState: this.watchState,
+      scheduler: this.scheduler,
+      noteService: this.noteService,
+      readmeService: this.readmeService,
+      noteIndexCache: this.noteIndexCache,
+      logger,
+      onRenameSuccess: (payload) => {
+        void this.broadcastRename(payload);
+      }
+    });
+  }
+  async broadcastRename(payload) {
+    const path2 = `/${repoName}${RENAME_BROADCAST_PATH}`;
+    const body = JSON.stringify(payload);
+    const hosts = ["127.0.0.1", "::1"];
+    let lastError = null;
+    for (const host of hosts) {
+      try {
+        await this.postOnce(host, path2, body);
+        return;
+      } catch (error) {
+        lastError = error;
+      }
+    }
+    logger.warn(
+      `\u5E7F\u64AD\u91CD\u547D\u540D\u4E8B\u4EF6\u5931\u8D25 (POST http://[127.0.0.1|::1]:${port}${path2}): ${String(lastError)}`
+    );
+  }
+  postOnce(host, path2, body) {
+    return new Promise((resolve2, reject) => {
+      const req = httpRequest(
+        {
+          host,
+          port,
+          path: path2,
+          method: "POST",
+          family: host.includes(":") ? 6 : 4,
+          headers: {
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(body)
+          }
+        },
+        (res) => {
+          res.on("data", () => {
+          });
+          res.on("end", () => {
+            if (res.statusCode && res.statusCode >= 400) {
+              reject(new Error(`HTTP ${res.statusCode}`));
+              return;
+            }
+            resolve2();
+          });
+        }
+      );
+      req.on("error", reject);
+      req.write(body);
+      req.end();
+    });
+  }
+  initRenameDetector() {
+    return new RenameDetector({
+      notesDir: this.notesDir,
+      dirCache: {
+        has: (name) => this.watchState.hasNoteDir(name),
+        add: (name) => this.watchState.addNoteDir(name),
+        delete: (name) => this.watchState.deleteNoteDir(name)
+      },
+      logger,
+      onDelete: (oldName) => this.folderHandler.handleFolderDeletion(oldName),
+      onRename: (oldName, newName) => this.folderHandler.handleFolderRenameUpdate(oldName, newName)
+    });
+  }
+  initConfigHandler() {
+    return new ConfigChangeHandler({
+      state: this.watchState,
+      noteService: this.noteService,
+      noteIndexCache: this.noteIndexCache,
+      logger
+    });
+  }
+  initReadmeHandler() {
+    return new ReadmeChangeHandler({ noteService: this.noteService });
+  }
+  initCoordinator() {
+    return new GlobalUpdateCoordinator({
+      readmeService: this.readmeService,
+      noteIndexCache: this.noteIndexCache,
+      logger
+    });
+  }
+  initAdapter() {
+    return new FsWatcherAdapter({
+      notesDir: this.notesDir,
+      isUpdating: () => this.scheduler.getUpdating(),
+      onRename: (folderName) => this.renameDetector.handleFsRename(folderName),
+      onNoteEvent: (event) => this.onNoteEvent(event),
+      logger
+    });
+  }
+  start() {
+    this.watchState.initializeFromDisk();
+    this.adapter.start();
+  }
+  stop() {
+    this.adapter.stop();
+    this.scheduler.clearTimers();
+    this.renameDetector.clearTimers();
+    this.folderHandler.clearTimers();
+    if (this.unlockTimer) {
+      clearTimeout(this.unlockTimer);
+      this.unlockTimer = null;
+    }
+    logger.info("\u6587\u4EF6\u76D1\u542C\u670D\u52A1\u5DF2\u505C\u6B62");
+  }
+  pause() {
+    this.scheduler.setUpdating(true);
+    logger.info("\u6587\u4EF6\u76D1\u542C\u5DF2\u6682\u505C");
+  }
+  resume() {
+    this.watchState.initializeFromDisk();
+    this.scheduler.setUpdating(false);
+    logger.info("\u6587\u4EF6\u76D1\u542C\u5DF2\u6062\u590D");
+  }
+  isWatching() {
+    return this.adapter.isWatching();
+  }
   /**
-   * 在首页 README 末尾添加新笔记
-   * @param noteIndex - 笔记索引
+   * 挂起文件监听（关闭 fs.watch 句柄），用于需要操作文件夹的场景（如重命名）
+   * Windows 上 fs.watch 会锁住文件夹句柄，必须先关闭才能重命名
    */
-  async appendNoteToReadme(noteIndex) {
-    const item = this.noteIndexCache.getByNoteIndex(noteIndex);
-    if (!item) {
-      logger.warn(`\u5C1D\u8BD5\u6DFB\u52A0\u4E0D\u5B58\u5728\u7684\u7B14\u8BB0: ${noteIndex}`);
-      return;
+  suspend() {
+    this.adapter.stop();
+    this.scheduler.setUpdating(true);
+    logger.info("\u6587\u4EF6\u76D1\u542C\u5DF2\u6302\u8D77\uFF08fs.watch \u5DF2\u5173\u95ED\uFF09");
+  }
+  /**
+   * 恢复文件监听（重新启动 fs.watch）
+   */
+  unsuspend() {
+    this.watchState.initializeFromDisk();
+    this.scheduler.setUpdating(false);
+    this.adapter.start();
+    logger.info("\u6587\u4EF6\u76D1\u542C\u5DF2\u6062\u590D\uFF08fs.watch \u5DF2\u91CD\u542F\uFF09");
+  }
+  // #region - 私有实现
+  onNoteEvent(event) {
+    if (!this.isNoteFile(event.path)) return;
+    if (!this.watchState.updateFileHash(event.path)) return;
+    if (this.scheduler.recordChangeAndDetectBatch()) return;
+    this.scheduler.enqueue(event);
+  }
+  async handleFileChange(events) {
+    try {
+      const configChanges = events.filter(
+        (e) => e.type === WATCH_EVENT_TYPES.CONFIG
+      );
+      const readmeChanges = events.filter(
+        (e) => e.type === WATCH_EVENT_TYPES.README
+      );
+      const changedNoteIndexes = await this.configHandler.handle(configChanges);
+      if (changedNoteIndexes.length > 0) {
+        await safeExecute(
+          "\u914D\u7F6E\u53D8\u66F4\u66F4\u65B0",
+          () => this.coordinator.applyConfigUpdates(changedNoteIndexes),
+          logger
+        );
+        return;
+      }
+      await safeExecute(
+        "README \u53D8\u66F4\u66F4\u65B0",
+        async () => {
+          await this.readmeHandler.handle(readmeChanges);
+          await this.coordinator.updateNoteReadmesOnly(events);
+        },
+        logger
+      );
+    } finally {
+      if (this.unlockTimer) clearTimeout(this.unlockTimer);
+      this.unlockTimer = setTimeout(() => {
+        this.unlockTimer = null;
+        this.scheduler.setUpdating(false);
+      }, UPDATE_UNLOCK_DELAY_MS2);
     }
-    const content = await fsPromises2.readFile(ROOT_README_PATH, "utf-8");
-    const lines = content.split("\n");
-    const repoOwner = this.configManager.get("author");
-    const repoName2 = this.configManager.get("repoName");
-    const tempNoteInfo = {
-      index: noteIndex,
-      dirName: item.folderName,
-      path: "",
-      readmePath: "",
-      configPath: "",
-      config: item.noteConfig
-    };
-    const noteLine = buildNoteLineMarkdown(tempNoteInfo, repoOwner, repoName2);
-    lines.push(noteLine);
-    await fsPromises2.writeFile(ROOT_README_PATH, lines.join("\n"), "utf-8");
-    logger.info(`\u5728 README.md \u672B\u5C3E\u6DFB\u52A0\u7B14\u8BB0: ${noteIndex}`);
+  }
+  isNoteFile(filePath) {
+    return filePath.endsWith("README.md") || filePath.endsWith(".tnotes.json");
+  }
+  // #endregion - 私有实现
+};
+
+// core/GitManager.ts
+var GitManager = class {
+  logger;
+  dir;
+  constructor(dir, logger2) {
+    this.dir = dir;
+    this.logger = logger2?.child("git") || new Logger({ prefix: "git" });
+  }
+  /**
+   * 检查是否为有效的 Git 仓库
+   */
+  async isValidRepo() {
+    try {
+      const result = await runCommand(
+        "git rev-parse --is-inside-work-tree",
+        this.dir
+      );
+      return result.trim() === "true";
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * 确保是有效的 Git 仓库，否则抛出错误
+   */
+  async ensureValidRepo() {
+    if (!await this.isValidRepo()) {
+      throw createError.gitNotRepo(this.dir);
+    }
+  }
+  /**
+   * 获取 Git 状态
+   */
+  async getStatus() {
+    await this.ensureValidRepo();
+    const statusOutput = await runCommand(
+      "git -c core.quotePath=false status --porcelain",
+      this.dir
+    );
+    const lines = statusOutput.trim().split("\n").filter((line) => line);
+    const files = lines.map((line) => {
+      const statusCode = line.substring(0, 2);
+      let path2 = line.substring(3);
+      path2 = path2.replace(/^"(.*)"$/, "$1");
+      let status = "modified";
+      if (line.startsWith("??")) {
+        status = "untracked";
+      } else if (/^[MADRC]/.test(statusCode)) {
+        status = "staged";
+      } else if (/^.[MD]/.test(statusCode)) {
+        status = "unstaged";
+      }
+      return { path: path2, status, statusCode };
+    });
+    const staged = files.filter((f) => f.status === "staged").length;
+    const unstaged = files.filter((f) => f.status === "unstaged").length;
+    const untracked = files.filter((f) => f.status === "untracked").length;
+    const branch = await runCommand("git branch --show-current", this.dir);
+    let ahead = 0;
+    let behind = 0;
+    try {
+      const aheadBehind = await runCommand(
+        "git rev-list --left-right --count @{upstream}...HEAD",
+        this.dir
+      );
+      const [behindStr, aheadStr] = aheadBehind.trim().split("	");
+      behind = parseInt(behindStr) || 0;
+      ahead = parseInt(aheadStr) || 0;
+    } catch {
+    }
+    return {
+      hasChanges: lines.length > 0,
+      changedFiles: lines.length,
+      staged,
+      unstaged,
+      untracked,
+      branch: branch.trim(),
+      ahead,
+      behind,
+      files
+    };
   }
   /**
-   * 重新生成 sidebar.json（基于当前 README.md）
-   * @param notes - 可选的笔记列表，不传则内部扫描
+   * 获取远程仓库信息
    */
-  async regenerateSidebar(notes) {
-    const allNotes = notes ?? (this.noteIndexCache.isInitialized() ? this.noteIndexCache.toNoteInfoList() : this.noteManager.scanNotes());
-    await this.updateSidebar(allNotes);
-    logger.info("\u91CD\u65B0\u751F\u6210 sidebar.json");
-  }
-};
-
-// services/note/service.ts
-var NEW_NOTES_README_MD_TEMPLATE = `
-<!-- region:toc -->
-
-- [1. \u{1F3AF} \u672C\u8282\u5185\u5BB9](#1--\u672C\u8282\u5185\u5BB9)
-- [2. \u{1FAE7} \u8BC4\u4EF7](#2--\u8BC4\u4EF7)
-
-<!-- endregion:toc -->
-
-## 1. \u{1F3AF} \u672C\u8282\u5185\u5BB9
-
-- todo
-
-## 2. \u{1FAE7} \u8BC4\u4EF7
-
-- todo
-`;
-var NoteService = class _NoteService {
-  static instance;
-  noteManager;
-  noteIndexCache;
-  ignoredConfigPaths = /* @__PURE__ */ new Set();
-  constructor() {
-    this.noteManager = NoteManager.getInstance();
-    this.noteIndexCache = NoteIndexCache.getInstance();
-  }
-  static getInstance() {
-    if (!_NoteService.instance) {
-      _NoteService.instance = new _NoteService();
+  async getRemoteInfo() {
+    try {
+      await this.ensureValidRepo();
+      const remoteUrl = await runCommand(
+        "git config --get remote.origin.url",
+        this.dir
+      );
+      const url = remoteUrl.trim();
+      if (!url) return null;
+      const httpsMatch = url.match(
+        /https:\/\/(?:www\.)?github\.com\/([^/]+)\/(.+?)(?:\.git)?$/
+      );
+      if (httpsMatch) {
+        return {
+          url,
+          type: "https",
+          owner: httpsMatch[1],
+          repo: httpsMatch[2]
+        };
+      }
+      const sshMatch = url.match(/git@github\.com:([^/]+)\/(.+?)(?:\.git)?$/);
+      if (sshMatch) {
+        return {
+          url,
+          type: "ssh",
+          owner: sshMatch[1],
+          repo: sshMatch[2]
+        };
+      }
+      return { url, type: "unknown" };
+    } catch {
+      return null;
     }
-    return _NoteService.instance;
   }
   /**
-   * 标记配置文件在下次变更时被忽略（防止 API 写入触发文件监听循环）
-   * @param configPath - 配置文件路径
+   * 检查是否有未提交的更改
    */
-  ignoreNextConfigChange(configPath) {
-    this.ignoredConfigPaths.add(configPath);
+  async hasUncommittedChanges() {
+    const status = await this.getStatus();
+    return status.hasChanges;
   }
   /**
-   * 检查配置文件是否应该被忽略
-   * @param configPath - 配置文件路径
-   * @returns 是否应该忽略
+   * Stash 当前更改
    */
-  shouldIgnoreConfigChange(configPath) {
-    if (this.ignoredConfigPaths.has(configPath)) {
-      this.ignoredConfigPaths.delete(configPath);
+  async stash(message) {
+    try {
+      await this.ensureValidRepo();
+      const cmd = message ? `git stash push -m "${message}"` : "git stash push";
+      await runCommand(cmd, this.dir);
+      this.logger.info("Stashed uncommitted changes");
       return true;
+    } catch (error) {
+      this.logger.warn("Failed to stash changes");
+      return false;
     }
-    return false;
   }
   /**
-   * 获取所有笔记
-   * dev 模式下（缓存已初始化）从内存读取，其他模式回退到文件扫描
-   * @returns 笔记信息数组
+   * Pop stash
    */
-  getAllNotes() {
-    if (this.noteIndexCache.isInitialized()) {
-      return this.noteIndexCache.toNoteInfoList();
+  async stashPop() {
+    try {
+      await this.ensureValidRepo();
+      await runCommand("git stash pop", this.dir);
+      this.logger.info("Restored stashed changes");
+      return true;
+    } catch (error) {
+      this.logger.warn("Failed to restore stashed changes");
+      return false;
     }
-    return this.noteManager.scanNotes();
-  }
-  /**
-   * 获取笔记（通过索引）
-   * @param noteIndex - 笔记索引（文件夹前 4 位数字）
-   * @returns 笔记信息，未找到时返回 undefined
-   */
-  getNoteByIndex(noteIndex) {
-    return this.noteManager.getNoteByIndex(noteIndex);
-  }
-  /**
-   * 创建新笔记
-   * @param options - 创建选项
-   * @returns 新创建的笔记信息
-   */
-  async createNote(options = {}) {
-    const {
-      title = "new",
-      category,
-      enableDiscussions = false,
-      configId,
-      usedIndexes
-    } = options;
-    const noteIndex = this.generateNextNoteIndex(usedIndexes);
-    const dirName = `${noteIndex}. ${title}`;
-    const notePath = join7(NOTES_PATH, dirName);
-    await ensureDirectory(notePath);
-    const readmePath = join7(notePath, "README.md");
-    const noteTitle = generateNoteTitle(noteIndex, title, REPO_NOTES_URL);
-    const readmeContent = noteTitle + "\n" + NEW_NOTES_README_MD_TEMPLATE;
-    writeFileSync4(readmePath, readmeContent, "utf-8");
-    const configPath = join7(notePath, ".tnotes.json");
-    const config2 = {
-      id: configId || uuidv4(),
-      // 配置 ID 使用 UUID（跨知识库唯一）
-      bilibili: [],
-      tnotes: [],
-      yuque: [],
-      done: false,
-      category,
-      enableDiscussions
-      // created_at / updated_at 由 tn:push 时 fix-timestamps 自动写入
-    };
-    this.noteManager.writeNoteConfig(configPath, config2);
-    logger.info(`Created new note: ${dirName}`);
-    return {
-      index: noteIndex,
-      // 返回的 id 是笔记索引（目录前缀）
-      path: notePath,
-      dirName,
-      readmePath,
-      configPath,
-      config: config2
-    };
   }
   /**
-   * 生成下一个笔记索引（填充空缺）
-   * @param usedIndexes - 可选的已使用编号集合，不传则内部扫描
-   * @returns 新的笔记索引（4位数字字符串，从 0001 到 9999）
+   * 拉取远程更新
    */
-  generateNextNoteIndex(usedIndexes) {
-    if (!usedIndexes) {
-      const notes = this.getAllNotes();
-      usedIndexes = /* @__PURE__ */ new Set();
-      for (const note of notes) {
-        const id = parseInt(note.index, 10);
-        if (!isNaN(id) && id >= 1 && id <= 9999) {
-          usedIndexes.add(id);
+  async pull(options) {
+    await this.ensureValidRepo();
+    const { rebase = true, autostash = true } = options || {};
+    const hasChanges = await this.hasUncommittedChanges();
+    let didStash = false;
+    if (hasChanges && !autostash) {
+      this.logger.warn("Repository has uncommitted changes");
+      didStash = await this.stash("Auto-stash before pull");
+    }
+    try {
+      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();
+      await runCommand(cmd, this.dir);
+      const afterCommit = await runCommand("git rev-parse HEAD", this.dir);
+      if (beforeCommit.trim() !== afterCommit.trim()) {
+        try {
+          const diffOutput = await runCommand(
+            `git diff --name-only ${beforeCommit.trim()}..${afterCommit.trim()}`,
+            this.dir
+          );
+          const changedFiles = diffOutput.trim().split("\n").filter((f) => f);
+          if (changedFiles.length > 0) {
+            console.log(`  \u66F4\u65B0\u4E86 ${changedFiles.length} \u4E2A\u6587\u4EF6:`);
+            changedFiles.forEach((file, index) => {
+              console.log(`  ${index + 1}. ${file}`);
+            });
+          }
+          this.logger.success(`\u62C9\u53D6\u6210\u529F: ${changedFiles.length} \u4E2A\u6587\u4EF6\u5DF2\u66F4\u65B0`);
+        } catch {
+          this.logger.success("\u62C9\u53D6\u6210\u529F");
         }
+      } else {
+        this.logger.info("\u5DF2\u662F\u6700\u65B0\uFF0C\u6CA1\u6709\u9700\u8981\u62C9\u53D6\u7684\u66F4\u65B0");
       }
-    }
-    if (usedIndexes.size === 0) {
-      return "0001";
-    }
-    for (let i = 1; i <= 9999; i++) {
-      if (!usedIndexes.has(i)) {
-        return i.toString().padStart(CONSTANTS.NOTE_INDEX_LENGTH, "0");
+    } catch (error) {
+      this.logger.error("\u62C9\u53D6\u5931\u8D25");
+      handleError(error);
+      throw error;
+    } finally {
+      if (didStash) {
+        await this.stashPop();
       }
     }
-    throw new Error("\u6240\u6709\u7B14\u8BB0\u7F16\u53F7 (0001-9999) \u5DF2\u88AB\u5360\u7528\uFF0C\u65E0\u6CD5\u521B\u5EFA\u65B0\u7B14\u8BB0");
   }
   /**
-   * 更新笔记配置
-   * @param noteIndex - 笔记索引
-   * @param updates - 配置更新
+   * 提交更改
    */
-  async updateNoteConfig(noteIndex, updates) {
-    const note = this.getNoteByIndex(noteIndex);
-    if (!note || !note.config) {
-      throw new Error(`Note not found or no config: ${noteIndex}`);
-    }
-    const oldConfig = { ...note.config };
-    const updatedConfig = {
-      ...note.config,
-      ...updates
-    };
-    this.ignoreNextConfigChange(note.configPath);
-    this.noteManager.updateNoteConfig(note, updatedConfig);
-    this.noteIndexCache.updateConfig(noteIndex, updatedConfig);
-    const needsGlobalUpdate = this.checkNeedsGlobalUpdate(
-      oldConfig,
-      updatedConfig
-    );
-    if (needsGlobalUpdate) {
-      logger.info(`\u68C0\u6D4B\u5230\u5168\u5C40\u5B57\u6BB5\u53D8\u66F4 (${noteIndex})\uFF0C\u6B63\u5728\u589E\u91CF\u66F4\u65B0\u5168\u5C40\u6587\u4EF6...`);
-      const readmeService = ReadmeService.getInstance();
-      await readmeService.updateNoteInReadme(noteIndex, updates);
-      await readmeService.regenerateSidebar();
-      logger.info(`\u5168\u5C40\u6587\u4EF6\u589E\u91CF\u66F4\u65B0\u5B8C\u6210 (${noteIndex})`);
-    } else {
-      logger.debug(`\u914D\u7F6E\u66F4\u65B0\u4E0D\u5F71\u54CD\u5168\u5C40\u6587\u4EF6 (${noteIndex})`);
+  async commit(message) {
+    await this.ensureValidRepo();
+    try {
+      await runCommand(`git commit -m "${message}"`, this.dir);
+      this.logger.success(`Committed: ${message}`);
+    } catch (error) {
+      handleError(error);
+      throw error;
     }
   }
   /**
-   * 检查配置更新是否需要触发全局更新
-   * @param oldConfig - 旧配置
-   * @param newConfig - 新配置
-   * @returns 是否需要全局更新
+   * 添加文件到暂存区
    */
-  checkNeedsGlobalUpdate(oldConfig, newConfig) {
-    const globalFields = ["done"];
-    for (const field of globalFields) {
-      if (oldConfig[field] !== newConfig[field]) {
-        return true;
-      }
+  async add(files = ".") {
+    await this.ensureValidRepo();
+    const fileList = Array.isArray(files) ? files.join(" ") : files;
+    try {
+      await runCommand(`git add ${fileList}`, this.dir);
+      this.logger.info(`Staged changes: ${fileList}`);
+    } catch (error) {
+      handleError(error);
+      throw error;
     }
-    return false;
   }
   /**
-   * 修正笔记标题
-   * @param noteInfo - 笔记信息
-   * @returns 是否进行了修正
+   * 推送到远程仓库
    */
-  async fixNoteTitle(noteInfo) {
+  async push(options) {
+    await this.ensureValidRepo();
+    const { force = false, setUpstream = false } = options || {};
     try {
-      const readmeContent = readFileSync5(noteInfo.readmePath, "utf-8");
-      if (readmeContent.length === 0) return false;
-      const lines = readmeContent.split("\n");
-      const match = noteInfo.dirName.match(/^\d{4}\.\s+(.+)$/);
-      if (!match) {
-        logger.warn(`\u68C0\u6D4B\u5230\u9519\u8BEF\u7684\u7B14\u8BB0\u76EE\u5F55\u540D\u79F0\uFF1A${noteInfo.dirName}`);
-        return false;
-      }
-      const expectedTitle = match[1];
-      const expectedH1 = generateNoteTitle(
-        noteInfo.index,
-        expectedTitle,
-        REPO_NOTES_URL
-      );
-      const firstLine = lines[0].trim();
-      if (!firstLine.startsWith("# ")) {
-        lines.unshift(expectedH1);
-        writeFileSync4(noteInfo.readmePath, lines.join("\n"), "utf-8");
-        logger.info(`Added title to: ${noteInfo.dirName}`);
-        return true;
-      }
-      if (firstLine !== expectedH1) {
-        lines[0] = expectedH1;
-        writeFileSync4(noteInfo.readmePath, lines.join("\n"), "utf-8");
-        logger.info(`Fixed title for: ${noteInfo.dirName}`);
-        return true;
+      const status = await this.getStatus();
+      this.logger.progress(`\u6B63\u5728\u63A8\u9001\u5230\u8FDC\u7A0B (${status.branch})...`);
+      let cmd = "git push";
+      if (force) cmd += " --force";
+      if (setUpstream) cmd += ` --set-upstream origin ${status.branch}`;
+      await runCommand(cmd, this.dir);
+      const remoteInfo = await this.getRemoteInfo();
+      if (remoteInfo) {
+        this.logger.success(`\u63A8\u9001\u6210\u529F \u2192 ${remoteInfo.owner}/${remoteInfo.repo}`);
+      } else {
+        this.logger.success("\u63A8\u9001\u6210\u529F");
       }
-      return false;
     } catch (error) {
-      logger.error(`Failed to fix title for: ${noteInfo.dirName}`, error);
-      return false;
+      this.logger.error("\u63A8\u9001\u5931\u8D25");
+      handleError(error);
+      throw error;
     }
   }
   /**
-   * 修正所有笔记的标题
-   * @param providedNotes - 可选的笔记列表，不传则内部扫描
-   * @returns 修正的笔记数量
+   * 完整的推送流程：检查 -> 添加 -> 提交 -> 推送
    */
-  async fixAllNoteTitles(providedNotes) {
-    const notes = providedNotes ?? this.getAllNotes();
-    let fixedCount = 0;
-    for (const note of notes) {
-      const fixed = await this.fixNoteTitle(note);
-      if (fixed) {
-        fixedCount++;
-      }
+  async pushWithCommit(commitMessage, options) {
+    await this.ensureValidRepo();
+    const status = await this.getStatus();
+    if (!status.hasChanges) {
+      this.logger.info("\u6CA1\u6709\u9700\u8981\u63D0\u4EA4\u7684\u66F4\u6539");
+      return;
     }
-    if (fixedCount > 0) {
-      logger.info(`Fixed ${fixedCount} note titles`);
+    try {
+      this.logger.info(`\u6B63\u5728\u63A8\u9001 ${status.changedFiles} \u4E2A\u6587\u4EF6...`);
+      status.files.forEach((file, index) => {
+        console.log(`  ${index + 1}. ${file.path}`);
+      });
+      await runCommand("git add .", this.dir);
+      const message = commitMessage || `update: ${status.changedFiles} files modified`;
+      await runCommand(`git commit -m "${message}"`, this.dir);
+      let cmd = "git push";
+      if (options?.force) cmd += " --force";
+      await runCommand(cmd, this.dir);
+      const remoteInfo = await this.getRemoteInfo();
+      if (remoteInfo) {
+        this.logger.success(
+          `\u63A8\u9001\u6210\u529F: ${status.changedFiles} \u4E2A\u6587\u4EF6 \u2192 https://github.com/${remoteInfo.owner}/${remoteInfo.repo}`
+        );
+      } else {
+        this.logger.success(`\u63A8\u9001\u6210\u529F: ${status.changedFiles} \u4E2A\u6587\u4EF6`);
+      }
+    } catch (error) {
+      this.logger.error(`\u63A8\u9001\u5931\u8D25`);
+      handleError(error);
+      throw error;
     }
-    return fixedCount;
   }
-};
-
-// services/file-watcher/service.ts
-var NOTES_DIR_NOT_SET_ERROR = "NOTES_DIR_PATH \u672A\u8BBE\u7F6E\uFF0C\u65E0\u6CD5\u542F\u52A8\u6587\u4EF6\u76D1\u542C";
-var UPDATE_UNLOCK_DELAY_MS2 = 500;
-var RENAME_BROADCAST_PATH = "/__tnotes_broadcast_rename";
-var FileWatcherService = class _FileWatcherService {
-  constructor(notesDir = NOTES_DIR_PATH) {
-    this.notesDir = notesDir;
-    if (!this.notesDir) {
-      throw new Error(NOTES_DIR_NOT_SET_ERROR);
+  /**
+   * 完整的同步流程：拉取 -> 推送
+   */
+  async sync(options) {
+    const { commitMessage, rebase = true } = options || {};
+    try {
+      await this.pull({ rebase, autostash: true });
+      await this.pushWithCommit(commitMessage);
+    } catch (error) {
+      this.logger.error("Sync failed");
+      handleError(error);
+      throw error;
     }
-    this.init();
-    _FileWatcherService.instance = this;
-  }
-  static instance = null;
-  watchState;
-  scheduler;
-  renameDetector;
-  configHandler;
-  readmeHandler;
-  coordinator;
-  folderHandler;
-  adapter;
-  noteService;
-  readmeService;
-  noteIndexCache;
-  unlockTimer = null;
-  static getInstance() {
-    return _FileWatcherService.instance;
-  }
-  init() {
-    this.noteService = NoteService.getInstance();
-    this.readmeService = ReadmeService.getInstance();
-    this.noteIndexCache = NoteIndexCache.getInstance();
-    this.watchState = this.initWatchState();
-    this.scheduler = this.initScheduler();
-    this.folderHandler = this.initFolderHandler();
-    this.renameDetector = this.initRenameDetector();
-    this.configHandler = this.initConfigHandler();
-    this.readmeHandler = this.initReadmeHandler();
-    this.coordinator = this.initCoordinator();
-    this.adapter = this.initAdapter();
-  }
-  initWatchState() {
-    const watchState = new WatchState({ notesDir: this.notesDir, logger });
-    watchState.initializeFromDisk();
-    return watchState;
-  }
-  initScheduler() {
-    return new EventScheduler({
-      onFlush: (events) => this.handleFileChange(events),
-      onPauseForBatch: () => logger.warn("\u76D1\u542C\u670D\u52A1\u6682\u505C 3s \u7B49\u5F85\u6279\u91CF\u66F4\u65B0\u5B8C\u6210..."),
-      onResumeAfterBatch: () => logger.info("\u6062\u590D\u81EA\u52A8\u76D1\u542C"),
-      reinit: () => this.watchState.initializeFromDisk()
-    });
-  }
-  initFolderHandler() {
-    return new FolderChangeHandler({
-      notesDir: this.notesDir,
-      watchState: this.watchState,
-      scheduler: this.scheduler,
-      noteService: this.noteService,
-      readmeService: this.readmeService,
-      noteIndexCache: this.noteIndexCache,
-      logger,
-      onRenameSuccess: (payload) => {
-        void this.broadcastRename(payload);
-      }
-    });
   }
-  async broadcastRename(payload) {
-    const path2 = `/${repoName}${RENAME_BROADCAST_PATH}`;
-    const body = JSON.stringify(payload);
-    const hosts = ["127.0.0.1", "::1"];
-    let lastError = null;
-    for (const host of hosts) {
-      try {
-        await this.postOnce(host, path2, body);
-        return;
-      } catch (error) {
-        lastError = error;
+  /**
+   * 显示状态摘要
+   */
+  async showStatus(options) {
+    const { showFiles = true } = options || {};
+    const status = await this.getStatus();
+    const remoteInfo = await this.getRemoteInfo();
+    console.log("\n\u{1F4CA} Git \u72B6\u6001:");
+    console.log(`  \u5206\u652F: ${status.branch}`);
+    if (remoteInfo) {
+      console.log(
+        `  \u8FDC\u7A0B: ${remoteInfo.owner}/${remoteInfo.repo} (${remoteInfo.type})`
+      );
+    }
+    if (status.hasChanges) {
+      console.log(
+        `  \u53D8\u66F4: ${status.changedFiles} \u4E2A\u6587\u4EF6 (\u5DF2\u6682\u5B58 ${status.staged}, \u672A\u6682\u5B58 ${status.unstaged}, \u672A\u8DDF\u8E2A ${status.untracked})`
+      );
+      if (showFiles && status.files.length > 0) {
+        console.log("  \u53D8\u66F4\u6587\u4EF6\u5217\u8868:");
+        const stagedFiles = status.files.filter((f) => f.status === "staged");
+        const unstagedFiles = status.files.filter(
+          (f) => f.status === "unstaged"
+        );
+        const untrackedFiles = status.files.filter(
+          (f) => f.status === "untracked"
+        );
+        if (stagedFiles.length > 0) {
+          console.log("    \u5DF2\u6682\u5B58:");
+          stagedFiles.forEach((f) => console.log(`      \u2713 ${f.path}`));
+        }
+        if (unstagedFiles.length > 0) {
+          console.log("    \u672A\u6682\u5B58:");
+          unstagedFiles.forEach((f) => console.log(`      \u2022 ${f.path}`));
+        }
+        if (untrackedFiles.length > 0) {
+          console.log("    \u672A\u8DDF\u8E2A:");
+          untrackedFiles.forEach((f) => console.log(`      ? ${f.path}`));
+        }
       }
+    } else {
+      console.log("  \u72B6\u6001: \u5DE5\u4F5C\u533A\u5E72\u51C0\uFF0C\u6CA1\u6709\u53D8\u66F4");
+    }
+    if (status.ahead > 0 || status.behind > 0) {
+      const syncInfo = [];
+      if (status.ahead > 0) syncInfo.push(`\u9886\u5148 ${status.ahead} \u4E2A\u63D0\u4EA4`);
+      if (status.behind > 0) syncInfo.push(`\u843D\u540E ${status.behind} \u4E2A\u63D0\u4EA4`);
+      console.log(`  \u540C\u6B65: ${syncInfo.join(", ")}`);
     }
-    logger.warn(
-      `\u5E7F\u64AD\u91CD\u547D\u540D\u4E8B\u4EF6\u5931\u8D25 (POST http://[127.0.0.1|::1]:${port}${path2}): ${String(lastError)}`
-    );
+    console.log();
   }
-  postOnce(host, path2, body) {
-    return new Promise((resolve2, reject) => {
-      const req = httpRequest(
-        {
-          host,
-          port,
-          path: path2,
-          method: "POST",
-          family: host.includes(":") ? 6 : 4,
-          headers: {
-            "Content-Type": "application/json",
-            "Content-Length": Buffer.byteLength(body)
-          }
-        },
-        (res) => {
-          res.on("data", () => {
-          });
-          res.on("end", () => {
-            if (res.statusCode && res.statusCode >= 400) {
-              reject(new Error(`HTTP ${res.statusCode}`));
-              return;
-            }
-            resolve2();
-          });
-        }
-      );
-      req.on("error", reject);
-      req.write(body);
-      req.end();
+};
+
+// core/ProcessManager.ts
+import { spawn } from "child_process";
+var ProcessManager = class {
+  processes = /* @__PURE__ */ new Map();
+  logger;
+  constructor() {
+    this.logger = new Logger({ prefix: "process" });
+    process.on("exit", () => {
+      this.killAll();
     });
-  }
-  initRenameDetector() {
-    return new RenameDetector({
-      notesDir: this.notesDir,
-      dirCache: {
-        has: (name) => this.watchState.hasNoteDir(name),
-        add: (name) => this.watchState.addNoteDir(name),
-        delete: (name) => this.watchState.deleteNoteDir(name)
-      },
-      logger,
-      onDelete: (oldName) => this.folderHandler.handleFolderDeletion(oldName),
-      onRename: (oldName, newName) => this.folderHandler.handleFolderRenameUpdate(oldName, newName)
+    process.on("SIGINT", () => {
+      this.killAll();
+      process.exit(0);
     });
-  }
-  initConfigHandler() {
-    return new ConfigChangeHandler({
-      state: this.watchState,
-      noteService: this.noteService,
-      noteIndexCache: this.noteIndexCache,
-      logger
+    process.on("SIGTERM", () => {
+      this.killAll();
+      process.exit(0);
     });
   }
-  initReadmeHandler() {
-    return new ReadmeChangeHandler({ noteService: this.noteService });
-  }
-  initCoordinator() {
-    return new GlobalUpdateCoordinator({
-      readmeService: this.readmeService,
-      noteIndexCache: this.noteIndexCache,
-      logger
+  /**
+   * 启动进程
+   * @param id - 进程ID
+   * @param command - 命令
+   * @param args - 参数列表
+   * @param options - spawn 选项
+   * @returns ProcessInfo
+   */
+  spawn(id, command, args = [], options) {
+    if (this.processes.has(id)) {
+      this.logger.warn(`\u8FDB\u7A0B ${id} \u5DF2\u5B58\u5728\uFF0C\u5148\u505C\u6B62\u65E7\u8FDB\u7A0B`);
+      this.kill(id);
+    }
+    const proc = spawn(command, args, {
+      stdio: "inherit",
+      shell: true,
+      ...options
     });
-  }
-  initAdapter() {
-    return new FsWatcherAdapter({
-      notesDir: this.notesDir,
-      isUpdating: () => this.scheduler.getUpdating(),
-      onRename: (folderName) => this.renameDetector.handleFsRename(folderName),
-      onNoteEvent: (event) => this.onNoteEvent(event),
-      logger
+    const processInfo = {
+      id,
+      pid: proc.pid,
+      command,
+      args,
+      startTime: Date.now(),
+      process: proc
+    };
+    this.processes.set(id, processInfo);
+    proc.on("exit", (code, signal) => {
+      this.logger.info(`\u8FDB\u7A0B ${id} \u5DF2\u9000\u51FA (code: ${code}, signal: ${signal})`);
+      this.processes.delete(id);
     });
+    proc.on("error", (err) => {
+      this.logger.error(`\u8FDB\u7A0B ${id} \u51FA\u9519: ${err.message}`);
+      this.processes.delete(id);
+    });
+    return processInfo;
   }
-  start() {
-    this.watchState.initializeFromDisk();
-    this.adapter.start();
-  }
-  stop() {
-    this.adapter.stop();
-    this.scheduler.clearTimers();
-    this.renameDetector.clearTimers();
-    this.folderHandler.clearTimers();
-    if (this.unlockTimer) {
-      clearTimeout(this.unlockTimer);
-      this.unlockTimer = null;
+  /**
+   * 停止进程
+   * @param id - 进程ID
+   * @param signal - 信号（默认为 SIGTERM）
+   * @returns 是否成功停止
+   */
+  kill(id, signal = "SIGTERM") {
+    const processInfo = this.processes.get(id);
+    if (!processInfo) {
+      this.logger.warn(`\u8FDB\u7A0B ${id} \u4E0D\u5B58\u5728`);
+      return false;
+    }
+    this.logger.info(`\u505C\u6B62\u8FDB\u7A0B: ${id} (PID: ${processInfo.pid})`);
+    try {
+      const killed = processInfo.process.kill(signal);
+      if (killed) {
+        this.processes.delete(id);
+        return true;
+      }
+      return false;
+    } catch (error) {
+      this.logger.error(`\u505C\u6B62\u8FDB\u7A0B ${id} \u5931\u8D25: ${error}`);
+      return false;
     }
-    logger.info("\u6587\u4EF6\u76D1\u542C\u670D\u52A1\u5DF2\u505C\u6B62");
-  }
-  pause() {
-    this.scheduler.setUpdating(true);
-    logger.info("\u6587\u4EF6\u76D1\u542C\u5DF2\u6682\u505C");
-  }
-  resume() {
-    this.watchState.initializeFromDisk();
-    this.scheduler.setUpdating(false);
-    logger.info("\u6587\u4EF6\u76D1\u542C\u5DF2\u6062\u590D");
-  }
-  isWatching() {
-    return this.adapter.isWatching();
   }
   /**
-   * 挂起文件监听（关闭 fs.watch 句柄），用于需要操作文件夹的场景（如重命名）
-   * Windows 上 fs.watch 会锁住文件夹句柄，必须先关闭才能重命名
+   * 检查进程是否存在
+   * @param id - 进程ID
+   * @returns 是否存在
    */
-  suspend() {
-    this.adapter.stop();
-    this.scheduler.setUpdating(true);
-    logger.info("\u6587\u4EF6\u76D1\u542C\u5DF2\u6302\u8D77\uFF08fs.watch \u5DF2\u5173\u95ED\uFF09");
+  has(id) {
+    return this.processes.has(id);
   }
   /**
-   * 恢复文件监听（重新启动 fs.watch）
+   * 检查进程是否在运行
+   * @param id - 进程 ID
+   * @returns 是否在运行
    */
-  unsuspend() {
-    this.watchState.initializeFromDisk();
-    this.scheduler.setUpdating(false);
-    this.adapter.start();
-    logger.info("\u6587\u4EF6\u76D1\u542C\u5DF2\u6062\u590D\uFF08fs.watch \u5DF2\u91CD\u542F\uFF09");
-  }
-  // #region - 私有实现
-  onNoteEvent(event) {
-    if (!this.isNoteFile(event.path)) return;
-    if (!this.watchState.updateFileHash(event.path)) return;
-    if (this.scheduler.recordChangeAndDetectBatch()) return;
-    this.scheduler.enqueue(event);
-  }
-  async handleFileChange(events) {
+  isRunning(id) {
+    const processInfo = this.processes.get(id);
+    if (!processInfo) return false;
     try {
-      const configChanges = events.filter(
-        (e) => e.type === WATCH_EVENT_TYPES.CONFIG
-      );
-      const readmeChanges = events.filter(
-        (e) => e.type === WATCH_EVENT_TYPES.README
-      );
-      const changedNoteIndexes = await this.configHandler.handle(configChanges);
-      if (changedNoteIndexes.length > 0) {
-        await safeExecute(
-          "\u914D\u7F6E\u53D8\u66F4\u66F4\u65B0",
-          () => this.coordinator.applyConfigUpdates(changedNoteIndexes),
-          logger
-        );
-        return;
-      }
-      await safeExecute(
-        "README \u53D8\u66F4\u66F4\u65B0",
-        async () => {
-          await this.readmeHandler.handle(readmeChanges);
-          await this.coordinator.updateNoteReadmesOnly(events);
-        },
-        logger
-      );
-    } finally {
-      if (this.unlockTimer) clearTimeout(this.unlockTimer);
-      this.unlockTimer = setTimeout(() => {
-        this.unlockTimer = null;
-        this.scheduler.setUpdating(false);
-      }, UPDATE_UNLOCK_DELAY_MS2);
+      return process.kill(processInfo.pid, 0);
+    } catch {
+      return false;
     }
   }
-  isNoteFile(filePath) {
-    return filePath.endsWith("README.md") || filePath.endsWith(".tnotes.json");
+  /**
+   * 停止所有进程
+   * @param signal - 信号（默认为 SIGTERM）
+   */
+  killAll(signal = "SIGTERM") {
+    if (this.processes.size === 0) {
+      return;
+    }
+    this.logger.info(`\u505C\u6B62\u6240\u6709\u8FDB\u7A0B (${this.processes.size} \u4E2A)`);
+    for (const [id, processInfo] of this.processes) {
+      try {
+        processInfo.process.kill(signal);
+        this.logger.info(`\u5DF2\u505C\u6B62\u8FDB\u7A0B: ${id}`);
+      } catch (error) {
+        this.logger.error(`\u505C\u6B62\u8FDB\u7A0B ${id} \u5931\u8D25: ${error}`);
+      }
+    }
+    this.processes.clear();
   }
-  // #endregion - 私有实现
 };
 
 // services/git/service.ts