@tnotesjs/core 0.2.2 → 0.3.0

package/README.md

@@ -69,7 +69,6 @@ export { default } from '@tnotesjs/core/vitepress/theme'
     "tn:push": "tnotes --push",
     "tn:pull": "tnotes --pull",
     "tn:create-notes": "tnotes --create-notes",
-    "tn:fix-timestamps": "tnotes --fix-timestamps",
     "tn:help": "tnotes --help",
     "tn:init-sub-repo": "tnotes --init-sub-repo"
   }

package/config/defaultConfig.ts

@@ -44,9 +44,6 @@ export function getDefaultConfig(repoName?: string): TNotesConfig {
       completed_notes_count: {},
       details: `${name} 知识库`,
       link: `https://tnotesjs.github.io/${name}/`,
-      created_at: Date.now(),
-      updated_at: Date.now(),
-      days_since_birth: 0,
     },
 
     // 端口配置（根据仓库名生成）
@@ -120,6 +117,32 @@ export function mergeConfig(
   return result
 }
 
+/**
+ * 根配置 root_item 中已废弃的字段
+ */
+const DEPRECATED_ROOT_ITEM_FIELDS = [
+  'created_at',
+  'updated_at',
+  'days_since_birth',
+] as const
+
+/**
+ * 剥离 root_item 中的废弃时间戳字段
+ * @returns 是否删除了字段
+ */
+export function stripDeprecatedRootItemFields(
+  rootItem: Record<string, unknown>,
+): boolean {
+  let stripped = false
+  for (const key of DEPRECATED_ROOT_ITEM_FIELDS) {
+    if (key in rootItem) {
+      delete rootItem[key]
+      stripped = true
+    }
+  }
+  return stripped
+}
+
 /**
  * 验证并补全配置
  * @param config - 现有配置
@@ -135,8 +158,14 @@ export function validateAndCompleteConfig(config: Record<string, any>): {
   // 深度合并配置
   const mergedConfig = mergeConfig(config, defaultConfig as any)
 
+  // 剥离 root_item 废弃字段
+  const rootItem = (mergedConfig.root_item || {}) as Record<string, unknown>
+  const stripped = stripDeprecatedRootItemFields(rootItem)
+  mergedConfig.root_item = rootItem
+
   // 检查是否有修改
-  const modified = JSON.stringify(config) !== JSON.stringify(mergedConfig)
+  const modified =
+    stripped || JSON.stringify(config) !== JSON.stringify(mergedConfig)
 
   return {
     config: mergedConfig as TNotesConfig,

package/config/index.ts

@@ -8,6 +8,12 @@ export {
   ConfigManager,
   getConfigManager,
 } from './ConfigManager'
+export {
+  getDefaultConfig,
+  mergeConfig,
+  validateAndCompleteConfig,
+  stripDeprecatedRootItemFields,
+} from './defaultConfig'
 export {
   ROOT_DIR_PATH,
   ROOT_README_PATH,

package/core/NoteIndexCache.ts

@@ -136,7 +136,13 @@ export class NoteIndexCache {
     }
 
     Object.assign(item.noteConfig, configUpdates)
-    item.noteConfig.updated_at = Date.now()
+    // 剥离内存中残留的废弃时间戳字段，避免后续写回时恢复
+    const noteConfigRecord = item.noteConfig as unknown as Record<
+      string,
+      unknown
+    >
+    delete noteConfigRecord.created_at
+    delete noteConfigRecord.updated_at
 
     logger.debug(`更新笔记配置: ${noteIndex}`, configUpdates)
   }

package/core/NoteManager.ts

@@ -210,8 +210,6 @@ export class NoteManager {
     'enableDiscussions',
     'description',
     'id',
-    'created_at',
-    'updated_at',
   ]
 
   /** 默认配置字段 */
@@ -224,6 +222,12 @@ export class NoteManager {
     description: '',
   } as const
 
+  /** 已废弃、写回时需剥离的笔记配置字段 */
+  private static readonly DEPRECATED_CONFIG_FIELDS = [
+    'created_at',
+    'updated_at',
+  ] as const
+
   /** 必需字段（不能缺失） */
   private static readonly REQUIRED_FIELDS = ['id'] as const
 
@@ -244,6 +248,7 @@ export class NoteManager {
     }
 
     let needsUpdate = false
+    const configRecord = config as Record<string, unknown>
 
     // 1. 检查必需字段 —— 缺失时直接返回 null，由 validateNotes() 统一报告
     for (const field of NoteManager.REQUIRED_FIELDS) {
@@ -257,32 +262,22 @@ export class NoteManager {
       NoteManager.DEFAULT_CONFIG_FIELDS,
     )) {
       if (!(key in config)) {
-        ;(config as Record<string, unknown>)[key] = defaultValue
+        configRecord[key] = defaultValue
         needsUpdate = true
         logger.info(`补充缺失字段 "${key}": ${configPath}`)
       }
     }
 
-    // 3. 确保时间戳字段存在
-    // 这里仅用 Date.now() 占位，确保字段不缺失。
-    // 真实的 git 时间戳由 tn:fix-timestamps 命令统一校准。
-    const now = Date.now()
-    if (!config.created_at) {
-      config.created_at = now
-      needsUpdate = true
-      logger.info(
-        `检测到 ${configPath} 缺失  created_at 字段，请执行 tn:fix-timestamps 校准为笔记首次 git commit 的时间）`,
-      )
-    }
-    if (!config.updated_at) {
-      config.updated_at = now
-      needsUpdate = true
-      logger.info(
-        `检测到 ${configPath} 缺失  updated_at 字段，请执行 tn:fix-timestamps 校准为笔记最后一次 git commit 的时间）`,
-      )
+    // 3. 剥离已废弃字段（created_at / updated_at）
+    for (const key of NoteManager.DEPRECATED_CONFIG_FIELDS) {
+      if (key in configRecord) {
+        delete configRecord[key]
+        needsUpdate = true
+        logger.info(`移除废弃字段 "${key}": ${configPath}`)
+      }
     }
 
-    // 4. 按字段顺序排序
+    // 4. 按字段顺序排序（仅保留白名单字段）
     const sortedConfig = this.sortConfigKeys(config as NoteConfig)
 
     // 5. 写回文件（如果有变更）
@@ -295,20 +290,14 @@ export class NoteManager {
   }
 
   /**
-   * 按指定顺序排序配置对象的键
+   * 按指定顺序排序配置对象的键（仅保留已知字段，丢弃废弃/未知字段）
    */
   private sortConfigKeys(config: NoteConfig): NoteConfig {
     const configRecord = config as unknown as Record<string, unknown>
     const sorted: Record<string, unknown> = {}
 
     for (const key of NoteManager.FIELD_ORDER) {
-      if (key in config) {
-        sorted[key] = configRecord[key]
-      }
-    }
-
-    for (const key of Object.keys(config)) {
-      if (!(key in sorted)) {
+      if (key in configRecord) {
         sorted[key] = configRecord[key]
       }
     }
@@ -383,7 +372,6 @@ export class NoteManager {
       throw new Error(`Invalid config for note: ${noteInfo.dirName}`)
     }
 
-    config.updated_at = Date.now()
     this.writeNoteConfig(noteInfo.configPath, config)
     logger.info(`Updated config for note: ${noteInfo.dirName}`)
   }

package/dist/{chunk-5Y5IYS6C.js → chunk-UJG3UU5X.js}

@@ -32,10 +32,7 @@ function getDefaultConfig(repoName) {
       title: cleanName,
       completed_notes_count: {},
       details: `${name} \u77E5\u8BC6\u5E93`,
-      link: `https://tnotesjs.github.io/${name}/`,
-      created_at: Date.now(),
-      updated_at: Date.now(),
-      days_since_birth: 0
+      link: `https://tnotesjs.github.io/${name}/`
     },
     // 端口配置（根据仓库名生成）
     port: 8e3,
@@ -86,11 +83,29 @@ function mergeConfig(target, source) {
   }
   return result;
 }
+var DEPRECATED_ROOT_ITEM_FIELDS = [
+  "created_at",
+  "updated_at",
+  "days_since_birth"
+];
+function stripDeprecatedRootItemFields(rootItem) {
+  let stripped = false;
+  for (const key of DEPRECATED_ROOT_ITEM_FIELDS) {
+    if (key in rootItem) {
+      delete rootItem[key];
+      stripped = true;
+    }
+  }
+  return stripped;
+}
 function validateAndCompleteConfig(config) {
   const repoName = config.repoName || "TNotes.default";
   const defaultConfig = getDefaultConfig(repoName);
   const mergedConfig = mergeConfig(config, defaultConfig);
-  const modified = JSON.stringify(config) !== JSON.stringify(mergedConfig);
+  const rootItem = mergedConfig.root_item || {};
+  const stripped = stripDeprecatedRootItemFields(rootItem);
+  mergedConfig.root_item = rootItem;
+  const modified = stripped || JSON.stringify(config) !== JSON.stringify(mergedConfig);
   return {
     config: mergedConfig,
     modified
@@ -195,6 +210,7 @@ function getConfigManager() {
 
 export {
   getDefaultConfig,
+  stripDeprecatedRootItemFields,
   ConfigManager,
   getConfigManager
 };