@tnotesjs/core 0.1.24 → 0.1.25

package/dist/cli/index.js

@@ -5,6 +5,7 @@ import {
   COMMAND_NAMES,
   COMMAND_OPTIONS,
   FileWatcherService,
+  GitManager,
   GitService,
   NoteIndexCache,
   NoteManager,
@@ -22,20 +23,18 @@ import {
   parseArgs,
   parseReadmeCompletedNotes,
   runCommand
-} from "../chunk-BSTQOJVE.js";
+} from "../chunk-4KG6RXFS.js";
 import {
   ConfigManager
-} from "../chunk-O4DCXHOV.js";
+} from "../chunk-AGSL3VZE.js";
 
 // commands/update/UpdateCommand.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { resolve } from "path";
 var UpdateCommand = class extends BaseCommand {
-  readmeService;
-  noteService;
-  quiet = false;
   constructor() {
     super("update");
+    this.quiet = false;
     this.readmeService = ReadmeService.getInstance();
     this.noteService = NoteService.getInstance();
   }
@@ -121,158 +120,18 @@ var UpdateCommand = class extends BaseCommand {
   }
 };
 
-// commands/update-completed-count/UpdateCompletedCountCommand.ts
-import { execSync } from "child_process";
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-var UpdateCompletedCountCommand = class extends BaseCommand {
-  constructor() {
-    super("update-completed-count");
-  }
-  async run() {
-    await this.updateCurrentRepo();
-  }
-  /**
-   * 更新当前知识库
-   */
-  async updateCurrentRepo() {
-    const startTime = Date.now();
-    try {
-      const configContent = readFileSync2(ROOT_CONFIG_PATH, "utf-8");
-      const config = JSON.parse(configContent);
-      this.logger.info("\u5F00\u59CB\u66F4\u65B0\u5B8C\u6210\u7B14\u8BB0\u6570\u91CF\u5386\u53F2\u8BB0\u5F55...");
-      const completedNotesCountHistory = await this.getCompletedNotesCountHistory(
-        config.root_item.created_at ?? Date.now()
-      );
-      config.root_item = {
-        ...config.root_item,
-        completed_notes_count: completedNotesCountHistory
-      };
-      writeFileSync2(ROOT_CONFIG_PATH, JSON.stringify(config, null, 2), "utf-8");
-      const duration = Date.now() - startTime;
-      const monthKeys = Object.keys(completedNotesCountHistory);
-      const currentKey = monthKeys[monthKeys.length - 1];
-      const currentCount = completedNotesCountHistory[currentKey] || 0;
-      this.logger.success(
-        `\u5386\u53F2\u6570\u636E\u66F4\u65B0\u5B8C\u6210: \u5171 ${monthKeys.length} \u4E2A\u6708, \u5F53\u524D ${currentKey} \u6708\u5B8C\u6210 ${currentCount} \u7BC7\u7B14\u8BB0 (${duration}ms)`
-      );
-    } catch (error) {
-      this.logger.error(
-        `\u66F4\u65B0\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}`
-      );
-      throw error;
-    }
-  }
-  /**
-   * 获取历史每个月的 completed_notes_count（最近12个月）
-   *
-   * 逻辑:
-   * 1. 计算最近12个月的范围（当前月份往前推11个月）
-   * 2. 遍历这12个月，从 Git 历史中读取 README.md
-   * 3. 解析 README.md 获取完成笔记数量
-   * 4. 如果知识库创建时间在这12个月内，之前的月份补0
-   * 5. 返回对象 { '25.01': 0, '25.02': 1, ..., '25.12': 15 }
-   */
-  async getCompletedNotesCountHistory(createdAt) {
-    try {
-      const now = /* @__PURE__ */ new Date();
-      const currentYear = now.getFullYear();
-      const currentMonth = now.getMonth();
-      let firstYear = currentYear;
-      let firstMonth = currentMonth - 11;
-      if (firstMonth < 0) {
-        firstYear = currentYear - 1;
-        firstMonth = 12 + firstMonth;
-      }
-      const createdDate = new Date(createdAt);
-      const createdYear = createdDate.getFullYear();
-      const createdMonth = createdDate.getMonth();
-      const result = {};
-      let prevCount = 0;
-      for (let i = 0; i < 12; i++) {
-        const targetYear = firstYear + Math.floor((firstMonth + i) / 12);
-        const targetMonth = (firstMonth + i) % 12;
-        const yearShort = String(targetYear).slice(-2);
-        const monthStr = String(targetMonth + 1).padStart(2, "0");
-        const key = `${yearShort}.${monthStr}`;
-        const isBeforeCreation = targetYear < createdYear || targetYear === createdYear && targetMonth < createdMonth;
-        if (isBeforeCreation) {
-          result[key] = 0;
-          prevCount = 0;
-          this.logger.info(`\u2713 ${key}: 0 \u7BC7\uFF08\u65E9\u4E8E\u521B\u5EFA\u65F6\u95F4\uFF09`);
-        } else {
-          try {
-            const count = await this.getMonthCompletedCount(
-              targetYear,
-              targetMonth,
-              prevCount
-            );
-            result[key] = count;
-            prevCount = count;
-            this.logger.info(`\u2713 ${key}: ${count} \u7BC7`);
-          } catch (error) {
-            result[key] = prevCount;
-            this.logger.warn(`${key}: \u65E0\u6570\u636E\uFF0C\u4F7F\u7528 ${prevCount}\uFF08\u4E0A\u6708\u503C\uFF09`);
-          }
-        }
-      }
-      return result;
-    } catch (error) {
-      this.logger.error(
-        `\u83B7\u53D6\u5386\u53F2\u6570\u636E\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}`
-      );
-      return {};
-    }
-  }
-  /**
-   * 获取指定月份的完成笔记数量
-   * @param year - 年份
-   * @param month - 月份 (0-11)
-   * @param fallbackCount - 回退值（如果该月没有数据）
-   * @returns 完成笔记数量
-   */
-  async getMonthCompletedCount(year, month, fallbackCount = 0) {
-    const lastDayOfMonth = new Date(year, month + 1, 0, 23, 59, 59);
-    const yearStr = lastDayOfMonth.getFullYear();
-    const monthStr = String(lastDayOfMonth.getMonth() + 1).padStart(2, "0");
-    const dayStr = String(lastDayOfMonth.getDate()).padStart(2, "0");
-    const untilDate = `${yearStr}-${monthStr}-${dayStr} 23:59:59 +0800`;
-    const commitHash = execSync(
-      `git log --until="${untilDate}" --format=%H -1 -- README.md`,
-      {
-        cwd: ROOT_DIR_PATH,
-        encoding: "utf-8"
-      }
-    ).trim();
-    if (!commitHash) {
-      return fallbackCount;
-    }
-    let readmeContent;
-    try {
-      readmeContent = execSync(`git show ${commitHash}:README.md`, {
-        cwd: ROOT_DIR_PATH,
-        encoding: "utf-8"
-      });
-    } catch (error) {
-      return fallbackCount;
-    }
-    const { completedCount } = parseReadmeCompletedNotes(readmeContent);
-    return completedCount;
-  }
-};
-
 // commands/git/PushCommand.ts
 var PushCommand = class extends BaseCommand {
-  gitService;
-  timestampService;
   constructor() {
     super("push");
+    this.gitManager = new GitManager(ROOT_DIR_PATH);
     this.gitService = new GitService();
     this.timestampService = new TimestampService();
   }
   async run() {
     try {
       this.logger.info("\u68C0\u67E5\u662F\u5426\u6709\u66F4\u6539...");
-      const status = await this.gitService.getStatus();
+      const status = await this.gitManager.getStatus();
       const hasPendingCommits = (status.ahead ?? 0) > 0;
       if (!status.hasChanges && !hasPendingCommits) {
         this.logger.info("\u6CA1\u6709\u66F4\u6539\u9700\u8981\u63A8\u9001");
@@ -317,7 +176,6 @@ var PushCommand = class extends BaseCommand {
 
 // commands/git/PullCommand.ts
 var PullCommand = class extends BaseCommand {
-  gitService;
   constructor() {
     super("pull");
     this.gitService = new GitService();
@@ -331,7 +189,6 @@ var PullCommand = class extends BaseCommand {
 
 // commands/build/BuildCommand.ts
 var BuildCommand = class extends BaseCommand {
-  vitepressService;
   constructor() {
     super("build");
     this.vitepressService = new VitepressService();
@@ -345,7 +202,6 @@ var BuildCommand = class extends BaseCommand {
 
 // commands/build/PreviewCommand.ts
 var PreviewCommand = class extends BaseCommand {
-  vitepressService;
   constructor() {
     super("preview");
     this.vitepressService = new VitepressService();
@@ -363,23 +219,20 @@ var PreviewCommand = class extends BaseCommand {
 
 // commands/dev/DevCommand.ts
 var DevCommand = class extends BaseCommand {
-  fileWatcherService;
-  vitepressService;
-  noteManager;
-  noteIndexCache;
-  configManager;
   constructor() {
     super("dev");
+    this.configManager = ConfigManager.getInstance();
     this.fileWatcherService = new FileWatcherService();
-    this.vitepressService = new VitepressService();
-    this.noteManager = NoteManager.getInstance();
     this.noteIndexCache = NoteIndexCache.getInstance();
-    this.configManager = ConfigManager.getInstance();
+    this.noteManager = NoteManager.getInstance();
+    this.readmeService = ReadmeService.getInstance();
+    this.vitepressService = new VitepressService();
   }
   async run() {
     const notes = this.noteManager.scanNotes();
     this.logger.info(`\u626B\u63CF\u5230 ${notes.length} \u7BC7\u7B14\u8BB0`);
     this.noteIndexCache.initialize(notes);
+    await this.readmeService.regenerateSidebar(notes);
     const result = await this.vitepressService.startServer();
     if (result) {
       const versionInfo = result.version ? `\uFF08v${result.version}\uFF09` : "";
@@ -390,10 +243,10 @@ var DevCommand = class extends BaseCommand {
       this.fileWatcherService.start();
       const watcherElapsed = Date.now() - watcherStart;
       this.logger.success(`\u6587\u4EF6\u76D1\u542C\u670D\u52A1\u5DF2\u5C31\u7EEA\uFF0C\u8017\u65F6\uFF1A${watcherElapsed} ms`);
-      const port = this.configManager.get("port") || VitepressService.DEFAULT_DEV_PORT;
-      const repoName = this.configManager.get("repoName");
+      const port2 = this.configManager.get("port") || VitepressService.DEFAULT_DEV_PORT;
+      const repoName2 = this.configManager.get("repoName");
       this.logger.info(
-        `\u672C\u5730\u5F00\u53D1\u670D\u52A1\u5730\u5740\uFF1Ahttp://localhost:${port}/${repoName}/`
+        `\u672C\u5730\u5F00\u53D1\u670D\u52A1\u5730\u5740\uFF1Ahttp://localhost:${port2}/${repoName2}/`
       );
     } else {
       this.logger.error("\u542F\u52A8\u670D\u52A1\u5668\u5931\u8D25");
@@ -403,7 +256,6 @@ var DevCommand = class extends BaseCommand {
 
 // commands/maintenance/FixTimestampsCommand.ts
 var FixTimestampsCommand = class extends BaseCommand {
-  timestampService;
   constructor() {
     super("fix-timestamps");
     this.timestampService = new TimestampService();
@@ -509,8 +361,6 @@ var HelpCommand = class extends BaseCommand {
 import { createInterface } from "readline";
 import { v4 as uuidv4 } from "uuid";
 var CreateNoteCommand = class extends BaseCommand {
-  noteService;
-  readmeService;
   constructor() {
     super("create-notes");
     this.noteService = NoteService.getInstance();
@@ -624,20 +474,159 @@ var CreateNoteCommand = class extends BaseCommand {
   }
 };
 
+// commands/update-completed-count/UpdateCompletedCountCommand.ts
+import { execSync } from "child_process";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+var UpdateCompletedCountCommand = class extends BaseCommand {
+  constructor() {
+    super("update-completed-count");
+  }
+  async run() {
+    await this.updateCurrentRepo();
+  }
+  /**
+   * 更新当前知识库
+   */
+  async updateCurrentRepo() {
+    const startTime = Date.now();
+    try {
+      const configContent = readFileSync2(ROOT_CONFIG_PATH, "utf-8");
+      const config = JSON.parse(configContent);
+      this.logger.info("\u5F00\u59CB\u66F4\u65B0\u5B8C\u6210\u7B14\u8BB0\u6570\u91CF\u5386\u53F2\u8BB0\u5F55...");
+      const completedNotesCountHistory = await this.getCompletedNotesCountHistory(
+        config.root_item.created_at ?? Date.now()
+      );
+      config.root_item = {
+        ...config.root_item,
+        completed_notes_count: completedNotesCountHistory
+      };
+      writeFileSync2(ROOT_CONFIG_PATH, JSON.stringify(config, null, 2), "utf-8");
+      const duration = Date.now() - startTime;
+      const monthKeys = Object.keys(completedNotesCountHistory);
+      const currentKey = monthKeys[monthKeys.length - 1];
+      const currentCount = completedNotesCountHistory[currentKey] || 0;
+      this.logger.success(
+        `\u5386\u53F2\u6570\u636E\u66F4\u65B0\u5B8C\u6210: \u5171 ${monthKeys.length} \u4E2A\u6708, \u5F53\u524D ${currentKey} \u6708\u5B8C\u6210 ${currentCount} \u7BC7\u7B14\u8BB0 (${duration}ms)`
+      );
+    } catch (error) {
+      this.logger.error(
+        `\u66F4\u65B0\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}`
+      );
+      throw error;
+    }
+  }
+  /**
+   * 获取历史每个月的 completed_notes_count（最近12个月）
+   *
+   * 逻辑:
+   * 1. 计算最近12个月的范围（当前月份往前推11个月）
+   * 2. 遍历这12个月，从 Git 历史中读取 README.md
+   * 3. 解析 README.md 获取完成笔记数量
+   * 4. 如果知识库创建时间在这12个月内，之前的月份补0
+   * 5. 返回对象 { '25.01': 0, '25.02': 1, ..., '25.12': 15 }
+   */
+  async getCompletedNotesCountHistory(createdAt) {
+    try {
+      const now = /* @__PURE__ */ new Date();
+      const currentYear = now.getFullYear();
+      const currentMonth = now.getMonth();
+      let firstYear = currentYear;
+      let firstMonth = currentMonth - 11;
+      if (firstMonth < 0) {
+        firstYear = currentYear - 1;
+        firstMonth = 12 + firstMonth;
+      }
+      const createdDate = new Date(createdAt);
+      const createdYear = createdDate.getFullYear();
+      const createdMonth = createdDate.getMonth();
+      const result = {};
+      let prevCount = 0;
+      for (let i = 0; i < 12; i++) {
+        const targetYear = firstYear + Math.floor((firstMonth + i) / 12);
+        const targetMonth = (firstMonth + i) % 12;
+        const yearShort = String(targetYear).slice(-2);
+        const monthStr = String(targetMonth + 1).padStart(2, "0");
+        const key = `${yearShort}.${monthStr}`;
+        const isBeforeCreation = targetYear < createdYear || targetYear === createdYear && targetMonth < createdMonth;
+        if (isBeforeCreation) {
+          result[key] = 0;
+          prevCount = 0;
+          this.logger.info(`\u2713 ${key}: 0 \u7BC7\uFF08\u65E9\u4E8E\u521B\u5EFA\u65F6\u95F4\uFF09`);
+        } else {
+          try {
+            const count = await this.getMonthCompletedCount(
+              targetYear,
+              targetMonth,
+              prevCount
+            );
+            result[key] = count;
+            prevCount = count;
+            this.logger.info(`\u2713 ${key}: ${count} \u7BC7`);
+          } catch (error) {
+            result[key] = prevCount;
+            this.logger.warn(`${key}: \u65E0\u6570\u636E\uFF0C\u4F7F\u7528 ${prevCount}\uFF08\u4E0A\u6708\u503C\uFF09`);
+          }
+        }
+      }
+      return result;
+    } catch (error) {
+      this.logger.error(
+        `\u83B7\u53D6\u5386\u53F2\u6570\u636E\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}`
+      );
+      return {};
+    }
+  }
+  /**
+   * 获取指定月份的完成笔记数量
+   * @param year - 年份
+   * @param month - 月份 (0-11)
+   * @param fallbackCount - 回退值（如果该月没有数据）
+   * @returns 完成笔记数量
+   */
+  async getMonthCompletedCount(year, month, fallbackCount = 0) {
+    const lastDayOfMonth = new Date(year, month + 1, 0, 23, 59, 59);
+    const yearStr = lastDayOfMonth.getFullYear();
+    const monthStr = String(lastDayOfMonth.getMonth() + 1).padStart(2, "0");
+    const dayStr = String(lastDayOfMonth.getDate()).padStart(2, "0");
+    const untilDate = `${yearStr}-${monthStr}-${dayStr} 23:59:59 +0800`;
+    const commitHash = execSync(
+      `git log --until="${untilDate}" --format=%H -1 -- README.md`,
+      {
+        cwd: ROOT_DIR_PATH,
+        encoding: "utf-8"
+      }
+    ).trim();
+    if (!commitHash) {
+      return fallbackCount;
+    }
+    let readmeContent;
+    try {
+      readmeContent = execSync(`git show ${commitHash}:README.md`, {
+        cwd: ROOT_DIR_PATH,
+        encoding: "utf-8"
+      });
+    } catch (error) {
+      return fallbackCount;
+    }
+    const { completedCount } = parseReadmeCompletedNotes(readmeContent);
+    return completedCount;
+  }
+};
+
 // commands/registry.ts
 var commandFactories = {
-  dev: () => new DevCommand(),
-  build: () => new BuildCommand(),
-  preview: () => new PreviewCommand(),
-  update: () => new UpdateCommand(),
-  "update-completed-count": () => new UpdateCompletedCountCommand(),
-  push: () => new PushCommand(),
-  pull: () => new PullCommand(),
+  "build": () => new BuildCommand(),
   "create-notes": () => new CreateNoteCommand(),
+  "dev": () => new DevCommand(),
   "fix-timestamps": () => new FixTimestampsCommand(),
-  "update-note-config": () => new UpdateNoteConfigCommand(),
+  "help": () => new HelpCommand(),
+  "preview": () => new PreviewCommand(),
+  "pull": () => new PullCommand(),
+  "push": () => new PushCommand(),
   "rename-note": () => new RenameNoteCommand(),
-  help: () => new HelpCommand()
+  "update-completed-count": () => new UpdateCompletedCountCommand(),
+  "update-note-config": () => new UpdateNoteConfigCommand(),
+  "update": () => new UpdateCommand()
 };
 var commandCache = /* @__PURE__ */ new Map();
 function getCommand(name) {

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   ConfigManager,
   getConfigManager
-} from "./chunk-O4DCXHOV.js";
+} from "./chunk-AGSL3VZE.js";
 export {
   ConfigManager,
   getConfigManager

package/dist/vitepress/config/index.js

@@ -7,8 +7,10 @@ import {
   UpdateNoteConfigCommand,
   generateAnchor,
   logger
-} from "../../chunk-BSTQOJVE.js";
-import "../../chunk-O4DCXHOV.js";
+} from "../../chunk-4KG6RXFS.js";
+import {
+  ConfigManager
+} from "../../chunk-AGSL3VZE.js";
 
 // vitepress/config/index.ts
 import fs2 from "fs";
@@ -1066,14 +1068,10 @@ function updateConfigPlugin() {
 }
 
 // vitepress/config/index.ts
-function loadTNotesConfig(rootPath) {
-  const configPath = path2.resolve(rootPath, ".tnotes.json");
-  const configContent = fs2.readFileSync(configPath, "utf-8");
-  return JSON.parse(configContent);
-}
 function defineNotesConfig(overrides = {}) {
   const rootPath = process.cwd();
-  const config = loadTNotesConfig(rootPath);
+  ConfigManager.init({ rootPath });
+  const config = ConfigManager.getInstance().getAll();
   const { repoName } = config;
   const IGNORE_LIST = getIgnoreList(config);
   const GITHUB_PAGE_URL = getGithubPageUrl(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tnotesjs/core",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "TNotes 知识库核心框架 —— 基于 VitePress 的笔记管理系统",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -32,6 +32,8 @@
     "typecheck": "vue-tsc --noEmit -p tsconfig.build.json",
     "dev": "tsup --watch",
     "release": "node scripts/release.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "lint": "eslint . --max-warnings=0",
     "lint:fix": "eslint . --fix"
   },
@@ -69,6 +71,7 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.59.1",
+    "vitest": "^4.1.6",
     "vue-eslint-parser": "^10.4.0",
     "vue-tsc": "^3.2.7"
   },

package/types/config.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/types/config.ts
+ * types/config.ts
  *
  * 配置相关类型定义
  */

package/types/index.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/types/index.ts
+ * types/index.ts
  *
  * 类型定义统一导出
  */

package/types/note.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/types/note.ts
+ * types/note.ts
  *
  * 笔记相关类型定义
  */

package/vitepress/assets/icons/index.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/vitepress/assets/icons/index.ts
+ * vitepress/assets/icons/index.ts
  *
  * get icons:
  *   https://iconify.design/

package/vitepress/components/BilibiliOutsidePlayer/BilibiliOutsidePlayer.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/BilibiliOutsidePlayer/BilibiliOutsidePlayer.vue 
+-->
+
 <template>
   <iframe
     style="width: 100%; aspect-ratio: 16/9; margin: 1rem 0"

package/vitepress/components/CodeBlockFullscreen/CodeBlockFullscreen.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/CodeBlockFullscreen/CodeBlockFullscreen.vue 
+-->
+
 <template>
   <Teleport to="body">
     <Transition name="fullscreen-fade">

package/vitepress/components/CodeBlockFullscreen/index.ts

@@ -1,3 +1,11 @@
+/**
+ * vitepress/components/CodeBlockFullscreen/index.ts
+ * 
+ * 代码块全屏功能的组合式函数
+ * 负责在代码块上添加全屏和复制按钮，处理相关事件
+ * 使用 Vue 3 的 Composition API 实现，增强用户体验
+ */
+
 import { createApp, onMounted, onUnmounted } from 'vue'
 
 import CodeBlockFullscreen from './CodeBlockFullscreen.vue'

package/vitepress/components/CodeBlockFullscreen/styles.css

@@ -1,3 +1,7 @@
+/* 
+vitepress/components/CodeBlockFullscreen/styles.css
+*/
+
 /* 代码块操作按钮样式 */
 div[class*='language-'] {
   position: relative;

package/vitepress/components/Discussions/Discussions.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Discussions/Discussions.vue 
+-->
+
 <script setup lang="ts">
 import { useData } from 'vitepress/client'
 import { onMounted, onUnmounted, watch, computed } from 'vue'

package/vitepress/components/EnWordList/EnWordList.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/EnWordList/EnWordList.vue
+-->
+
 <script setup>
 import { marked } from 'marked'
 import { computed, ref, onMounted, onUnmounted, nextTick } from 'vue'

package/vitepress/components/EnWordList/RightClickMenu.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/EnWordList/RightClickMenu.vue 
+-->
+
 <template>
   <div
     v-if="show"

package/vitepress/components/Footprints/Footprints.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Footprints/Footprints.vue 
+-->
+
 <script setup>
 import { ref, onMounted, onBeforeUnmount, computed, nextTick } from 'vue'
 

package/vitepress/components/Layout/AboutModal.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/AboutModal.vue 
+-->
+
 <template>
   <!-- 使用 teleport 将 modal 放到 body 之下（避免父容器样式影响） -->
   <teleport to="body">

package/vitepress/components/Layout/AboutPanel.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/AboutPanel.vue 
+-->
+
 <template>
   <div class="timeModalContent">
     <!-- 笔记编号（仅笔记页显示） -->

package/vitepress/components/Layout/ContentCollapse.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/ContentCollapse.vue 
+-->
+
 <template>
   <div></div>
 </template>

package/vitepress/components/Layout/CustomSidebar.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/CustomSidebar.vue 
+-->
+
 <template>
   <div class="custom-sidebar-wrapper">
     <nav class="nav" ref="navRef">

package/vitepress/components/Layout/DocBeforeControls.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/DocBeforeControls.vue 
+-->
+
 <template>
   <div class="docBeforeContainer">
     <div class="leftArea">

package/vitepress/components/Layout/DocFooter.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/DocFooter.vue 
+-->
+
 <template>
   <nav class="custom-doc-footer" v-if="prev || next">
     <div class="container">

package/vitepress/components/Layout/ImagePreview.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/ImagePreview.vue 
+-->
+
 <template>
   <!-- #region img preview -->
   <div