@tnotesjs/core 0.1.24 → 0.1.26

package/config/defaultConfig.ts

@@ -0,0 +1,145 @@
+/**
+ * config/defaultConfig.ts
+ *
+ * TNotes 项目配置默认值模板
+ */
+
+import type { TNotesConfig } from '../types'
+
+/**
+ * 生成默认配置
+ * @param repoName - 仓库名称（必需）
+ * @returns 默认配置对象
+ */
+export function getDefaultConfig(repoName?: string): TNotesConfig {
+  const name = repoName || 'TNotes.default'
+  const cleanName = name.replace('TNotes.', '')
+
+  return {
+    // 基础信息
+    author: 'tnotesjs',
+    repoName: name,
+    keywords: [name],
+    id: '', // 由外部生成的 UUID
+
+    // Sidebar 配置
+    sidebarShowNoteId: true,
+
+    // 忽略目录
+    ignore_dirs: [
+      '.vscode',
+      '0000',
+      'assets',
+      'node_modules',
+      'hidden',
+      'demos',
+    ],
+
+    // 根目录项配置
+    root_item: {
+      icon: {
+        src: `https://cdn.jsdelivr.net/gh/tnotesjs/imgs@main/assets/icon--${cleanName}.svg`,
+      },
+      title: cleanName,
+      completed_notes_count: {},
+      details: `${name} 知识库`,
+      link: `https://tnotesjs.github.io/${name}/`,
+      created_at: Date.now(),
+      updated_at: Date.now(),
+      days_since_birth: 0,
+    },
+
+    // 端口配置（根据仓库名生成）
+    port: 8000,
+
+    // 菜单项
+    menuItems: [
+      {
+        text: '🏠 Home',
+        link: '/',
+      },
+      {
+        text: '📒 TNotes',
+        link: 'https://tnotesjs.github.io/notes',
+      },
+      {
+        text: '📂 TNotes.yuque',
+        link: 'https://www.yuque.com/tdahuyou/tnotes.yuque',
+      },
+    ],
+
+    // 社交链接
+    socialLinks: [
+      {
+        link: 'https://www.yuque.com/tdahuyou',
+        icon: {
+          svg: '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path fill="currentColor" d="M17.28 2.955c2.97.203 3.756 2.342 3.84 2.597l1.297.096c.13 0 .169.18.054.236c-1.323.716-1.727 2.17-1.49 3.118c.09.358.254.69.412 1.02c.307.642.651 1.418.707 2.981c.117 3.24-2.51 6.175-5.789 6.593c1.17-1.187 1.815-2.444 2.12-3.375c.606-1.846.508-3.316.055-4.44a4.46 4.46 0 0 0-1.782-2.141c-1.683-1.02-3.22-1.09-4.444-.762c.465-.594.876-1.201 1.2-1.864c.584-1.65-.102-2.848-.704-3.519c-.192-.246-.061-.655.305-.655c1.41 0 2.813.02 4.22.115M3.32 19.107c1.924-2.202 4.712-5.394 7.162-8.15c.559-.63 2.769-2.338 5.748-.533c.878.532 2.43 2.165 1.332 5.51c-.803 2.446-4.408 7.796-15.76 5.844c-.227-.039-.511-.354-.218-.687z"/></svg>',
+        },
+      },
+      {
+        link: 'https://space.bilibili.com/407241004',
+        icon: {
+          svg: '<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024"><g fill="currentColor"><path d="M310.134 596.45c-7.999-4.463-16.498-8.43-24.997-11.9a274 274 0 0 0-26.996-7.438c-2.5-.992-2.5.991-2.5 1.487c0 7.934.5 18.843 1.5 27.768c1 7.438 2 15.372 4 22.81c0 .496 0 .991.5 1.487c.999.992 1.999 1.488 2.999.496c7.999-4.463 15.998-8.43 22.997-13.388c7.499-5.454 15.498-11.9 21.997-18.347c1.5-1.487 0-2.479.5-2.975m323.96-11.9a274 274 0 0 0-26.997-7.438c-2.5-.992-2.5.991-2.5 1.487c0 7.934.5 18.843 1.5 27.768c1 7.438 2 15.372 4 22.81c0 .496 0 .991.5 1.487c1 .992 2 1.488 3 .496c7.999-4.463 15.998-8.43 22.997-13.388c7.499-5.454 15.498-11.9 21.997-18.347c2-1.487.5-2.479.5-2.975c-7.5-4.463-16.498-8.43-24.997-11.9"/><path d="M741.496 112H283c-94.501 0-171 76.5-171 171.5v458c.5 94 77 170.5 170.999 170.5h457.997c94.5 0 171.002-76.5 171.002-170.5v-458c.497-95-76.002-171.5-170.502-171.5m95 343.5h15.5v48h-15.5zm-95.5-1.5l2 43l-13.5 1.5l-5-44.5zm-23.5 0l4 45.5l-14.5 1.5l-6.5-47.5h17zm-230.498 1.5h15v48h-15zm-96-1.5l2 43l-13.5 1.5l-5-44.5zm-23.5 0l4 45.5l-14.5 2l-6-47.5zm-3.5 149C343.498 668.5 216 662.5 204.5 660.5C195.5 499 181.5 464 170 385l54.5-22.5c1 71.5 9 185 9 185s108.5-15.5 132 47c.5 3 0 6-1.5 8.5m20.5 35.5l-23.5-124h35.5l13 123zm44.5-8l-27-235l33.5-1.5l21 236H429zm34-175h17.5v48H467zm41 190h-26.5l-9.5-126h36zm209.998-43C693.496 668 565.997 662 554.497 660c-9-161-23-196-34.5-275l54.5-22.5c1 71.5 9 185 9 185s108.5-15.5 132 46.5c.5 3 0 6-1.5 8.5m19.5 36l-23-124h35.5l13 123zm45.5-8l-27.5-235l33.5-1.5l21 236h-27zm33.5-175h17.5v48h-13zm41 190h-26.5l-9.5-126h36z"/></g></svg>',
+        },
+      },
+      {
+        link: `https://github.com/tnotesjs/${name}`,
+        icon: 'github',
+      },
+    ],
+  }
+}
+
+/**
+ * 深度合并配置
+ * @param target - 目标对象（现有配置）
+ * @param source - 源对象（默认配置）
+ * @returns 合并后的配置
+ */
+export function mergeConfig(
+  target: Record<string, any>,
+  source: Record<string, any>
+): Record<string, any> {
+  const result = { ...target }
+
+  for (const key in source) {
+    if (!(key in result)) {
+      // 如果字段不存在，直接添加
+      result[key] = source[key]
+    } else if (
+      typeof source[key] === 'object' &&
+      source[key] !== null &&
+      !Array.isArray(source[key])
+    ) {
+      // 如果是对象（非数组），递归合并
+      result[key] = mergeConfig(result[key] || {}, source[key])
+    }
+    // 如果字段已存在且不是对象，保留现有值
+  }
+
+  return result
+}
+
+/**
+ * 验证并补全配置
+ * @param config - 现有配置
+ * @returns 补全后的配置和是否进行了修改
+ */
+export function validateAndCompleteConfig(config: Record<string, any>): {
+  config: TNotesConfig
+  modified: boolean
+} {
+  const repoName = config.repoName || 'TNotes.default'
+  const defaultConfig = getDefaultConfig(repoName)
+
+  // 深度合并配置
+  const mergedConfig = mergeConfig(config, defaultConfig as any)
+
+  // 检查是否有修改
+  const modified = JSON.stringify(config) !== JSON.stringify(mergedConfig)
+
+  return {
+    config: mergedConfig as TNotesConfig,
+    modified,
+  }
+}

package/dist/{chunk-BSTQOJVE.js → chunk-4KG6RXFS.js}

@@ -1,7 +1,7 @@
 import {
   ConfigManager,
   getConfigManager
-} from "./chunk-O4DCXHOV.js";
+} from "./chunk-AGSL3VZE.js";
 
 // utils/errorHandler.ts
 var TNotesError = class _TNotesError extends Error {
@@ -95,10 +95,6 @@ var createError = {
 
 // utils/logger.ts
 var Logger = class _Logger {
-  level;
-  prefix;
-  timestamp;
-  colors;
   constructor(config2 = {}) {
     this.level = config2.level ?? 1 /* INFO */;
     this.prefix = config2.prefix ?? "";
@@ -624,9 +620,10 @@ var REPO_NOTES_URL = `https://github.com/${author}/${repoName}/tree/main/notes`;
 
 // core/NoteManager.ts
 var NoteManager = class _NoteManager {
-  static instance;
-  /** 笔记索引正则：4 位数字开头，后接小数点 */
-  static NOTE_INDEX_REGEX = /^(\d{4})\./;
+  static {
+    /** 笔记索引正则：4 位数字开头，后接小数点 */
+    this.NOTE_INDEX_REGEX = /^(\d{4})\./;
+  }
   constructor() {
   }
   /**
@@ -778,30 +775,36 @@ var NoteManager = class _NoteManager {
     }
     return indexMap;
   }
-  /** 配置字段顺序 */
-  static FIELD_ORDER = [
-    "bilibili",
-    "tnotes",
-    "yuque",
-    "done",
-    "category",
-    "enableDiscussions",
-    "description",
-    "id",
-    "created_at",
-    "updated_at"
-  ];
-  /** 默认配置字段 */
-  static DEFAULT_CONFIG_FIELDS = {
-    bilibili: [],
-    tnotes: [],
-    yuque: [],
-    done: false,
-    enableDiscussions: false,
-    description: ""
-  };
-  /** 必需字段（不能缺失） */
-  static REQUIRED_FIELDS = ["id"];
+  static {
+    /** 配置字段顺序 */
+    this.FIELD_ORDER = [
+      "bilibili",
+      "tnotes",
+      "yuque",
+      "done",
+      "category",
+      "enableDiscussions",
+      "description",
+      "id",
+      "created_at",
+      "updated_at"
+    ];
+  }
+  static {
+    /** 默认配置字段 */
+    this.DEFAULT_CONFIG_FIELDS = {
+      bilibili: [],
+      tnotes: [],
+      yuque: [],
+      done: false,
+      enableDiscussions: false,
+      description: ""
+    };
+  }
+  static {
+    /** 必需字段（不能缺失） */
+    this.REQUIRED_FIELDS = ["id"];
+  }
   /**
    * 验证并修复配置文件
    * @param configPath - 配置文件路径
@@ -1143,14 +1146,16 @@ var COMMAND_OPTIONS = {
 // core/NoteIndexCache.ts
 import { join as join2 } from "path";
 var NoteIndexCache = class _NoteIndexCache {
-  static instance = null;
-  /** noteIndex -> NoteIndexItem 的映射 */
-  byNoteIndex = /* @__PURE__ */ new Map();
-  /** configId (UUID) -> noteIndex 的映射，用于快速反向查询 */
-  byConfigId = /* @__PURE__ */ new Map();
-  /** 是否已完成初始化 */
-  _initialized = false;
   constructor() {
+    /** noteIndex -> NoteIndexItem 的映射 */
+    this.byNoteIndex = /* @__PURE__ */ new Map();
+    /** configId (UUID) -> noteIndex 的映射，用于快速反向查询 */
+    this.byConfigId = /* @__PURE__ */ new Map();
+    /** 是否已完成初始化 */
+    this._initialized = false;
+  }
+  static {
+    this.instance = null;
   }
   /**
    * 获取单例实例
@@ -1444,8 +1449,6 @@ var TocGenerator = class {
 
 // core/ReadmeGenerator.ts
 var ReadmeGenerator = class {
-  tocGenerator;
-  configManager;
   constructor() {
     this.tocGenerator = new TocGenerator();
     this.configManager = ConfigManager.getInstance();
@@ -1582,11 +1585,6 @@ var ReadmeGenerator = class {
 
 // services/readme/service.ts
 var ReadmeService = class _ReadmeService {
-  static instance;
-  noteManager;
-  readmeGenerator;
-  configManager;
-  noteIndexCache;
   constructor() {
     this.noteManager = NoteManager.getInstance();
     this.readmeGenerator = new ReadmeGenerator();
@@ -2138,11 +2136,8 @@ var NEW_NOTES_README_MD_TEMPLATE = `
 - todo
 `;
 var NoteService = class _NoteService {
-  static instance;
-  noteManager;
-  noteIndexCache;
-  ignoredConfigPaths = /* @__PURE__ */ new Set();
   constructor() {
+    this.ignoredConfigPaths = /* @__PURE__ */ new Set();
     this.noteManager = NoteManager.getInstance();
     this.noteIndexCache = NoteIndexCache.getInstance();
   }
@@ -2434,25 +2429,21 @@ var DEFAULT_BATCH_BUFFER_MS = 2e3;
 var EventScheduler = class {
   constructor(config2) {
     this.config = config2;
+    /** 待处理的文件变更事件队列 */
+    this.pendingEvents = /* @__PURE__ */ new Map();
+    /** 防抖定时器 */
+    this.updateTimer = null;
+    /** 批量更新恢复定时器 */
+    this.batchResumeTimer = null;
+    /** 记录最近的变更时间戳 */
+    this.recentChanges = [];
+    /** 标记是否正在更新，避免循环触发 - 类似一把更新行为锁 */
+    this.isUpdating = false;
     this.debounceMs = config2.debounceMs ?? DEFAULT_DEBOUNCE_MS;
     this.batchWindowMs = config2.batchWindowMs ?? DEFAULT_BATCH_WINDOW_MS;
     this.batchThreshold = config2.batchThreshold ?? DEFAULT_BATCH_THRESHOLD;
     this.batchBufferMs = config2.batchBufferMs ?? DEFAULT_BATCH_BUFFER_MS;
   }
-  /** 待处理的文件变更事件队列 */
-  pendingEvents = /* @__PURE__ */ new Map();
-  /** 防抖定时器 */
-  updateTimer = null;
-  /** 批量更新恢复定时器 */
-  batchResumeTimer = null;
-  /** 记录最近的变更时间戳 */
-  recentChanges = [];
-  /** 标记是否正在更新，避免循环触发 - 类似一把更新行为锁 */
-  isUpdating = false;
-  debounceMs;
-  batchWindowMs;
-  batchThreshold;
-  batchBufferMs;
   /**
    * 设置更新状态锁，用于防止在执行耗时更新操作时被新的文件变更事件打断
    *
@@ -2574,9 +2565,9 @@ var UPDATE_UNLOCK_DELAY_MS = 500;
 var FolderChangeHandler = class {
   constructor(config2) {
     this.config = config2;
+    /** 活跃的定时器 ID 集合，用于统一清理 */
+    this.activeTimers = /* @__PURE__ */ new Set();
   }
-  /** 活跃的定时器 ID 集合，用于统一清理 */
-  activeTimers = /* @__PURE__ */ new Set();
   /**
    * 清理所有活跃定时器，释放资源
    *
@@ -2773,9 +2764,9 @@ import { basename, dirname, join as join5, sep } from "path";
 var FsWatcherAdapter = class {
   constructor(config2) {
     this.config = config2;
+    /** 文件系统监听器实例 */
+    this.watcher = null;
   }
-  /** 文件系统监听器实例 */
-  watcher = null;
   start() {
     const { logger: logger2 } = this.config;
     if (this.watcher) {
@@ -2893,11 +2884,11 @@ var FOLDER_RENAME_DETECT_WINDOW_MS = 500;
 var RenameDetector = class {
   constructor(config2) {
     this.config = config2;
+    /** 待处理的文件夹重命名 */
+    this.pendingFolderRename = null;
+    /** 文件夹重命名检测定时器 */
+    this.folderRenameTimer = null;
   }
-  /** 待处理的文件夹重命名 */
-  pendingFolderRename = null;
-  /** 文件夹重命名检测定时器 */
-  folderRenameTimer = null;
   handleFsRename(folderName) {
     const { notesDir, dirCache, logger: logger2, onDelete, onRename } = this.config;
     const folderPath = join6(notesDir, folderName);
@@ -2962,13 +2953,13 @@ import { join as join7 } from "path";
 var WatchState = class {
   constructor(config2) {
     this.config = config2;
+    /** 文件哈希缓存 */
+    this.fileHashes = /* @__PURE__ */ new Map();
+    /** 笔记目录缓存 */
+    this.noteDirCache = /* @__PURE__ */ new Set();
+    /** 笔记配置缓存 */
+    this.configCache = /* @__PURE__ */ new Map();
   }
-  /** 文件哈希缓存 */
-  fileHashes = /* @__PURE__ */ new Map();
-  /** 笔记目录缓存 */
-  noteDirCache = /* @__PURE__ */ new Set();
-  /** 笔记配置缓存 */
-  configCache = /* @__PURE__ */ new Map();
   /**
    * 获取指定文件的 MD5 哈希值，若文件不存在或读取失败返回 null
    *
@@ -3124,25 +3115,16 @@ var RENAME_BROADCAST_PATH = "/__tnotes_broadcast_rename";
 var FileWatcherService = class _FileWatcherService {
   constructor(notesDir = NOTES_DIR_PATH) {
     this.notesDir = notesDir;
+    this.unlockTimer = null;
     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 {
+    this.instance = null;
+  }
   static getInstance() {
     return _FileWatcherService.instance;
   }
@@ -3367,8 +3349,6 @@ var FileWatcherService = class _FileWatcherService {
 
 // core/GitManager.ts
 var GitManager = class {
-  logger;
-  dir;
   constructor(dir, logger2) {
     this.dir = dir;
     this.logger = logger2?.child("git") || new Logger({ prefix: "git" });
@@ -3725,9 +3705,8 @@ var GitManager = class {
 // core/ProcessManager.ts
 import { spawn } from "child_process";
 var ProcessManager = class {
-  processes = /* @__PURE__ */ new Map();
-  logger;
   constructor() {
+    this.processes = /* @__PURE__ */ new Map();
     this.logger = new Logger({ prefix: "process" });
     process.on("exit", () => {
       this.killAll();
@@ -3848,7 +3827,6 @@ var ProcessManager = class {
 
 // services/git/service.ts
 var GitService = class {
-  gitManager;
   constructor() {
     this.gitManager = new GitManager(ROOT_DIR_PATH);
   }
@@ -3885,19 +3863,12 @@ var GitService = class {
     await this.gitManager.sync({ commitMessage });
     logger.info("Sync completed successfully");
   }
-  /**
-   * 获取 Git 状态
-   * @returns Git 状态信息
-   */
-  async getStatus() {
-    return await this.gitManager.getStatus();
-  }
   /**
    * 检查是否有未提交的更改
    * @returns 是否有未提交的更改
    */
   async hasChanges() {
-    const status = await this.getStatus();
+    const status = await this.gitManager.getStatus();
     return status.hasChanges;
   }
   /**
@@ -3935,7 +3906,6 @@ import {
 import { join as join8 } from "path";
 var BIRTH_DATE = (/* @__PURE__ */ new Date("1999-06-29T00:00:00+08:00")).getTime();
 var TimestampService = class {
-  noteManager;
   constructor() {
     this.noteManager = NoteManager.getInstance();
   }
@@ -4235,26 +4205,42 @@ var TimestampService = class {
 // services/vitepress/service.ts
 import { spawn as spawn2 } from "child_process";
 var VitepressService = class _VitepressService {
-  /** VitePress 开发服务器默认端口 */
-  static DEFAULT_DEV_PORT = 5173;
-  /** VitePress 预览服务器默认端口 */
-  static DEFAULT_PREVIEW_PORT = 4173;
-  /** 开发服务器进程 ID 后缀 */
-  static PROCESS_ID_DEV_SUFFIX = "vitepress-dev";
-  /** 预览服务器进程 ID 后缀 */
-  static PROCESS_ID_PREVIEW_SUFFIX = "vitepress-preview";
-  /** 服务启动超时时间（毫秒） */
-  static SERVER_STARTUP_TIMEOUT = 6e4;
-  /** 端口释放等待超时时间（毫秒） */
-  static PORT_RELEASE_TIMEOUT = 3e3;
-  /** 进程清理等待时间（毫秒） */
-  static PROCESS_CLEANUP_DELAY = 3e3;
-  /** 显示启动服务状态行间隔（毫秒） */
-  static SERVER_STATUS_LINE_INTERVAL = 1e3;
-  /** 默认包管理器 */
-  static DEFAULT_PACKAGE_MANAGER = "pnpm";
-  processManager;
-  configManager;
+  static {
+    /** VitePress 开发服务器默认端口 */
+    this.DEFAULT_DEV_PORT = 5173;
+  }
+  static {
+    /** VitePress 预览服务器默认端口 */
+    this.DEFAULT_PREVIEW_PORT = 4173;
+  }
+  static {
+    /** 开发服务器进程 ID 后缀 */
+    this.PROCESS_ID_DEV_SUFFIX = "vitepress-dev";
+  }
+  static {
+    /** 预览服务器进程 ID 后缀 */
+    this.PROCESS_ID_PREVIEW_SUFFIX = "vitepress-preview";
+  }
+  static {
+    /** 服务启动超时时间（毫秒） */
+    this.SERVER_STARTUP_TIMEOUT = 6e4;
+  }
+  static {
+    /** 端口释放等待超时时间（毫秒） */
+    this.PORT_RELEASE_TIMEOUT = 3e3;
+  }
+  static {
+    /** 进程清理等待时间（毫秒） */
+    this.PROCESS_CLEANUP_DELAY = 3e3;
+  }
+  static {
+    /** 显示启动服务状态行间隔（毫秒） */
+    this.SERVER_STATUS_LINE_INTERVAL = 1e3;
+  }
+  static {
+    /** 默认包管理器 */
+    this.DEFAULT_PACKAGE_MANAGER = "pnpm";
+  }
   constructor() {
     this.processManager = new ProcessManager();
     this.configManager = ConfigManager.getInstance();
@@ -4448,10 +4434,9 @@ var VitepressService = class _VitepressService {
 var BaseCommand = class {
   constructor(name) {
     this.name = name;
+    this.options = {};
     this.logger = logger.child(name);
   }
-  logger;
-  options = {};
   /** 命令描述（从静态配置读取） */
   get description() {
     return COMMAND_DESCRIPTIONS[this.name];
@@ -4481,7 +4466,6 @@ var BaseCommand = class {
 
 // commands/note/UpdateNoteConfigCommand.ts
 var UpdateNoteConfigCommand = class extends BaseCommand {
-  noteService;
   constructor() {
     super("update-note-config");
     this.noteService = NoteService.getInstance();
@@ -4533,8 +4517,6 @@ var UpdateNoteConfigCommand = class extends BaseCommand {
 import { existsSync as existsSync8, renameSync, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "fs";
 import { join as join9 } from "path";
 var RenameNoteCommand = class extends BaseCommand {
-  noteService;
-  readmeService;
   constructor() {
     super("rename-note");
     this.noteService = NoteService.getInstance();
@@ -4642,6 +4624,7 @@ export {
   ReadmeService,
   NoteService,
   FileWatcherService,
+  GitManager,
   GitService,
   TimestampService,
   VitepressService,

package/dist/{chunk-O4DCXHOV.js → chunk-AGSL3VZE.js}

@@ -99,11 +99,8 @@ function validateAndCompleteConfig(config) {
 
 // config/ConfigManager.ts
 var ConfigManager = class _ConfigManager {
-  static instance;
-  config = null;
-  configPath;
-  rootPath;
   constructor(rootPath) {
+    this.config = null;
     if (rootPath) {
       this.rootPath = rootPath;
     } else {