@tnotesjs/core 0.7.0 → 0.8.0

package/commands/update/UpdateCommand.ts

@@ -0,0 +1,219 @@
+/**
+ * commands/update/UpdateCommand.ts
+ *
+ * 更新命令 - 使用 ReadmeService
+ */
+
+import { existsSync, readFileSync, writeFileSync } from 'fs'
+
+import { ROOT_CONFIG_PATH, ROOT_TOC_PATH, stripDeprecatedRootItemFields } from '../../config'
+import { ReadmeService, NoteService } from '../../services'
+import { logger, LogLevel, parseTocCompletedNotes } from '../../utils'
+import { BaseCommand } from '../BaseCommand'
+
+import type { TNotesConfig } from '../../types'
+
+export class UpdateCommand extends BaseCommand {
+  private readmeService: ReadmeService
+  private noteService: NoteService
+  private quiet: boolean = false
+
+  constructor() {
+    super('update')
+    this.readmeService = ReadmeService.getInstance()
+    this.noteService = NoteService.getInstance()
+  }
+
+  /**
+   * 设置 quiet 模式
+   *
+   * 在 quiet 模式下，只显示 WARN 级别以上的日志
+   */
+  setQuiet(quiet: boolean): void {
+    this.quiet = quiet
+    if (quiet) {
+      logger.setLevel(LogLevel.WARN)
+    } else {
+      logger.setLevel(LogLevel.INFO)
+    }
+  }
+
+  protected async run(): Promise<void> {
+    await this.updateCurrentRepo()
+  }
+
+  /**
+   * 更新当前知识库
+   */
+  private async updateCurrentRepo(): Promise<void> {
+    const startTime = Date.now()
+
+    // 扫描一次笔记，复用于后续步骤
+    const notes = this.noteService.getAllNotes()
+
+    // 修正所有笔记的标题
+    if (!this.quiet) {
+      this.logger.info('正在修正笔记标题...')
+    }
+    const fixedCount = await this.noteService.fixAllNoteTitles(notes)
+    if (!this.quiet && fixedCount > 0) {
+      this.logger.success(`修正了 ${fixedCount} 个笔记标题`)
+    }
+
+    // 更新知识库（传入已扫描的笔记列表，避免重复扫描）
+    await this.readmeService.updateAllReadmes({ notes })
+
+    // 更新 root_item 配置
+    await this.updateRootItem()
+
+    const duration = Date.now() - startTime
+
+    if (this.quiet) {
+      // quiet 模式：只显示简洁的完成信息
+      this.logger.success(`知识库更新完成 (${duration}ms)`)
+    } else {
+      this.logger.success('知识库更新完成')
+    }
+  }
+
+  /**
+   * 更新 root_item 配置
+   * 更新当前月份的完成笔记数量，并自动补齐从最后已有月份到当前月份之间的所有缺失月份。
+   */
+  private async updateRootItem(): Promise<void> {
+    try {
+      // 读取当前配置
+      const configContent = readFileSync(ROOT_CONFIG_PATH, 'utf-8')
+      const config: TNotesConfig = JSON.parse(configContent)
+
+      // 1. 读取根目录 TOC.md
+      if (!existsSync(ROOT_TOC_PATH)) {
+        throw new Error('根目录 TOC.md 不存在')
+      }
+
+      const tocContent = readFileSync(ROOT_TOC_PATH, 'utf-8')
+
+      // 2. 解析完成笔记数量
+
+      const { completedCount } = parseTocCompletedNotes(tocContent)
+
+      // 3. 生成当前月份的键名（如 '25.12'）
+      const now = new Date()
+      const yearShort = String(now.getFullYear()).slice(-2)
+      const monthStr = String(now.getMonth() + 1).padStart(2, '0')
+      const currentKey = `${yearShort}.${monthStr}`
+
+      // 4. 更新完成数量，并补齐所有相邻月份之间的缺失
+      const existing = { ...(config.root_item.completed_notes_count || {}) }
+      const _countsBeforeFix = Object.keys(existing).length
+
+      existing[currentKey] = completedCount
+      const fixed = fillMissingMonthGaps(existing, currentKey)
+
+      // 5. 更新 root_item
+      config.root_item = {
+        ...config.root_item,
+        completed_notes_count: fixed,
+      }
+
+      // 删除旧字段（向后兼容）
+      delete (config.root_item as any).completed_notes_count_last_month
+      stripDeprecatedRootItemFields(
+        config.root_item as unknown as Record<string, unknown>,
+      )
+
+      // 写入配置文件
+      writeFileSync(ROOT_CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8')
+
+      if (!this.quiet) {
+        const filledCount = Object.keys(fixed).length - _countsBeforeFix
+        const filledMsg = filledCount > 0 ? `，补齐 ${filledCount} 个缺失月份` : ''
+        this.logger.success(
+          `root_item 配置已更新: ${currentKey} 月完成 ${completedCount} 篇笔记${filledMsg}`,
+        )
+      }
+    } catch (error) {
+      if (!this.quiet) {
+        this.logger.error(
+          `更新 root_item 失败: ${
+            error instanceof Error ? error.message : String(error)
+          }`,
+        )
+      }
+      throw error
+    }
+  }
+}
+
+/**
+ * 补齐 completed_notes_count 中所有相邻月份之间的缺口
+ * 遍历排序后的所有 key，发现非连续的月份就插入前一个月份的值
+ */
+function fillMissingMonthGaps(
+  counts: Record<string, number>,
+  currentKey: string,
+): Record<string, number> {
+  const existingKeys = Object.keys(counts).sort()
+  const result: Record<string, number> = {}
+
+  // 将 currentKey 加入集合以确保覆盖到当前月
+  const keySet = new Set(existingKeys)
+  keySet.add(currentKey)
+  const allKeys = Array.from(keySet).sort()
+
+  let prevValue = 0
+  let lastKey: string | null = null
+
+  for (const key of allKeys) {
+    if (lastKey !== null) {
+      // 检查 lastKey 和 key 之间是否有缺口
+      const missing = generateMissingMonthKeys(lastKey, key)
+      for (const midKey of missing) {
+        result[midKey] = prevValue
+      }
+    }
+    result[key] = counts[key] ?? prevValue
+    prevValue = result[key]
+    lastKey = key
+  }
+
+  return result
+}
+
+/**
+ * 生成两个 YY.MM 格式月份键之间的所有缺失月份键（不含两端）
+ *
+ * @example
+ *   generateMissingMonthKeys('26.04', '26.06') // => ['26.05']
+ *   generateMissingMonthKeys('25.12', '26.02') // => ['26.01']
+ *   generateMissingMonthKeys('26.04', '26.04') // => []
+ */
+function generateMissingMonthKeys(fromKey: string, toKey: string): string[] {
+  const parseKey = (key: string) => {
+    const [yy, mm] = key.split('.').map(Number)
+    return { year: 2000 + yy, month: mm }
+  }
+
+  const from = parseKey(fromKey)
+  const to = parseKey(toKey)
+
+  const missing: string[] = []
+  let year = from.year
+  let month = from.month
+
+  while (true) {
+    month++
+    if (month > 12) { month = 1; year++ }
+
+    const shortYear = String(year).slice(-2)
+    const paddedMonth = String(month).padStart(2, '0')
+    const candidateKey = `${shortYear}.${paddedMonth}`
+
+    if (candidateKey === toKey) break
+    if (year > to.year || (year === to.year && month > to.month)) break
+
+    missing.push(candidateKey)
+  }
+
+  return missing
+}

package/commands/update/index.ts

@@ -0,0 +1,7 @@
+/**
+ * commands/update/index.ts
+ *
+ * Update 命令统一导出
+ */
+
+export { UpdateCommand } from './UpdateCommand'

package/commands/update-completed-count/UpdateCompletedCountCommand.ts

@@ -0,0 +1,208 @@
+/**
+ * commands/update-completed-count/UpdateCompletedCountCommand.ts
+ *
+ * 更新完成笔记数量历史记录命令
+ * 基于 Git 历史统计最近 12 个月（近 1 年）的每月完成笔记数量
+ */
+
+import { execSync } from 'child_process'
+import { readFileSync, writeFileSync } from 'fs'
+
+import { ROOT_DIR_PATH, ROOT_CONFIG_PATH, stripDeprecatedRootItemFields } from '../../config'
+import { parseReadmeCompletedNotes, parseTocCompletedNotes } from '../../utils'
+import { BaseCommand } from '../BaseCommand'
+
+import type { TNotesConfig } from '../../types'
+
+
+
+export class UpdateCompletedCountCommand extends BaseCommand {
+  constructor() {
+    super('update-completed-count')
+  }
+
+  protected async run(): Promise<void> {
+    await this.updateCurrentRepo()
+  }
+
+  /**
+   * 更新当前知识库
+   */
+  private async updateCurrentRepo(): Promise<void> {
+    const startTime = Date.now()
+
+    try {
+      // 读取当前配置
+      const configContent = readFileSync(ROOT_CONFIG_PATH, 'utf-8')
+      const config: TNotesConfig = JSON.parse(configContent)
+
+      this.logger.info('开始更新完成笔记数量历史记录...')
+
+      // 计算所有月份的完成笔记数量
+      const completedNotesCountHistory =
+        await this.getCompletedNotesCountHistory()
+
+      // 更新配置
+      config.root_item = {
+        ...config.root_item,
+        completed_notes_count: completedNotesCountHistory,
+      }
+      stripDeprecatedRootItemFields(
+        config.root_item as unknown as Record<string, unknown>,
+      )
+
+      // 写入配置文件
+      writeFileSync(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(
+        `历史数据更新完成: 共 ${monthKeys.length} 个月, 当前 ${currentKey} 月完成 ${currentCount} 篇笔记 (${duration}ms)`,
+      )
+    } catch (error) {
+      this.logger.error(
+        `更新失败: ${error instanceof Error ? error.message : String(error)}`,
+      )
+      throw error
+    }
+  }
+
+  /**
+   * 获取历史每个月的 completed_notes_count（最近12个月）
+   *
+   * 逻辑:
+   * 1. 计算最近12个月的范围（当前月份往前推11个月）
+   * 2. 遍历这12个月，从 Git 历史中读取 TOC.md（回退 README.md）
+   * 3. 解析获取完成笔记数量
+   * 4. 返回对象 { '25.01': 0, '25.02': 1, ..., '25.12': 15 }
+   */
+  private async getCompletedNotesCountHistory(): Promise<
+    Record<string, number>
+  > {
+    try {
+      // 1. 计算最近12个月的范围
+      const now = new Date()
+      const currentYear = now.getFullYear()
+      const currentMonth = now.getMonth() // 0-11 (0=January, 11=December)
+
+      // 计算第一个月（当前月往前推11个月）
+      // 例如：当前是 2025年12月(11)，往前推11个月 => 2025年1月(0)
+      let firstYear = currentYear
+      let firstMonth = currentMonth - 11
+
+      // 处理跨年情况
+      if (firstMonth < 0) {
+        firstYear = currentYear - 1
+        firstMonth = 12 + firstMonth
+      }
+
+      const result: Record<string, number> = {}
+      let prevCount = 0
+
+      // 2. 遍历最近12个月
+      for (let i = 0; i < 12; i++) {
+        const targetYear = firstYear + Math.floor((firstMonth + i) / 12)
+        const targetMonth = (firstMonth + i) % 12
+
+        // 生成键名 (如 '25.01', '25.12')
+        const yearShort = String(targetYear).slice(-2)
+        const monthStr = String(targetMonth + 1).padStart(2, '0')
+        const key = `${yearShort}.${monthStr}`
+
+        // 尝试从 Git 历史获取
+        try {
+          const count = await this.getMonthCompletedCount(
+            targetYear,
+            targetMonth,
+            prevCount,
+          )
+          result[key] = count
+          prevCount = count
+          this.logger.info(`✓ ${key}: ${count} 篇`)
+        } catch (error) {
+          // 该月没有提交或解析失败，使用上一个月的值
+          result[key] = prevCount
+          this.logger.warn(`${key}: 无数据，使用 ${prevCount}（上月值）`)
+        }
+      }
+
+      return result
+    } catch (error) {
+      this.logger.error(
+        `获取历史数据失败: ${
+          error instanceof Error ? error.message : String(error)
+        }`,
+      )
+      return {}
+    }
+  }
+
+  /**
+   * 获取指定月份的完成笔记数量
+   * @param year - 年份
+   * @param month - 月份 (0-11)
+   * @param fallbackCount - 回退值（如果该月没有数据）
+   * @returns 完成笔记数量
+   */
+  private async getMonthCompletedCount(
+    year: number,
+    month: number,
+    fallbackCount: number = 0,
+  ): Promise<number> {
+    // 计算该月的最后一天
+    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`
+
+    // 查找该月最后一次修改 TOC.md 或 README.md 的提交
+    let commitHash = execSync(
+      `git log --until="${untilDate}" --format=%H -1 -- TOC.md`,
+      {
+        cwd: ROOT_DIR_PATH,
+        encoding: 'utf-8',
+      },
+    ).trim()
+
+    let filePath = 'TOC.md'
+
+    if (!commitHash) {
+      commitHash = execSync(
+        `git log --until="${untilDate}" --format=%H -1 -- README.md`,
+        {
+          cwd: ROOT_DIR_PATH,
+          encoding: 'utf-8',
+        },
+      ).trim()
+      filePath = 'README.md'
+    }
+
+    if (!commitHash) {
+      // 该月没有提交，返回回退值
+      return fallbackCount
+    }
+
+    // 读取该提交中的文件内容
+    let fileContent: string
+    try {
+      fileContent = execSync(`git show ${commitHash}:${filePath}`, {
+        cwd: ROOT_DIR_PATH,
+        encoding: 'utf-8',
+      })
+    } catch (error) {
+      // 文件在该提交中不存在
+      return fallbackCount
+    }
+
+    // 解析完成笔记数量
+    const { completedCount } =
+      filePath === 'TOC.md'
+        ? parseTocCompletedNotes(fileContent)
+        : parseReadmeCompletedNotes(fileContent)
+    return completedCount
+  }
+}

package/commands/update-completed-count/index.ts

@@ -0,0 +1,5 @@
+/**
+ * commands/update-completed-count/index.ts
+ */
+
+export { UpdateCompletedCountCommand } from './UpdateCompletedCountCommand'

package/dist/markdown/index.cjs

@@ -7,26 +7,22 @@ var _chunk7FEANCT6cjs = require('../chunk-7FEANCT6.cjs');
 // markdown/components.ts
 var TNOTES_COMPONENTS = [
   {
-    name: "BilibiliOutsidePlayer",
-    aliases: ["B"],
+    name: "BilibiliVideo",
     kind: "block-component",
     editable: "visual"
   },
   {
-    name: "EnWordList",
-    aliases: ["E"],
+    name: "WordList",
     kind: "block-component",
     editable: "visual"
   },
   {
     name: "Footprints",
-    aliases: ["F"],
     kind: "block-component",
     editable: "visual"
   },
   {
     name: "NotesTable",
-    aliases: ["N"],
     kind: "block-component",
     editable: "visual"
   },
@@ -36,7 +32,8 @@ var TNOTES_COMPONENTS = [
     editable: "visual"
   },
   {
-    name: "MindmapPreview",
+    name: "Mindmap",
+    aliases: ["MindmapPreview"],
     kind: "block-component",
     editable: "visual"
   },
@@ -57,14 +54,14 @@ var TNOTES_COMPONENTS = [
   },
   { name: "swiper", kind: "container", editable: "visual" },
   { name: "code-group", kind: "container", editable: "visual" },
+  { name: "footprints", kind: "container", editable: "visual" },
   { name: "details", kind: "container", editable: "visual" },
   { name: "info", kind: "container", editable: "visual" },
   { name: "tip", kind: "container", editable: "visual" },
   { name: "warning", kind: "container", editable: "visual" },
   { name: "danger", kind: "container", editable: "visual" },
   { name: "mermaid", kind: "fenced-language", editable: "visual" },
-  { name: "mindmap", kind: "fenced-language", editable: "visual" },
-  { name: "markmap", kind: "fenced-language", editable: "visual" }
+  { name: "mindmap", kind: "fenced-language", editable: "visual" }
 ];
 function findTNotesComponent(name) {
   const normalized = name.toLowerCase();

package/dist/markdown/index.js

@@ -7,26 +7,22 @@ import {
 // markdown/components.ts
 var TNOTES_COMPONENTS = [
   {
-    name: "BilibiliOutsidePlayer",
-    aliases: ["B"],
+    name: "BilibiliVideo",
     kind: "block-component",
     editable: "visual"
   },
   {
-    name: "EnWordList",
-    aliases: ["E"],
+    name: "WordList",
     kind: "block-component",
     editable: "visual"
   },
   {
     name: "Footprints",
-    aliases: ["F"],
     kind: "block-component",
     editable: "visual"
   },
   {
     name: "NotesTable",
-    aliases: ["N"],
     kind: "block-component",
     editable: "visual"
   },
@@ -36,7 +32,8 @@ var TNOTES_COMPONENTS = [
     editable: "visual"
   },
   {
-    name: "MindmapPreview",
+    name: "Mindmap",
+    aliases: ["MindmapPreview"],
     kind: "block-component",
     editable: "visual"
   },
@@ -57,14 +54,14 @@ var TNOTES_COMPONENTS = [
   },
   { name: "swiper", kind: "container", editable: "visual" },
   { name: "code-group", kind: "container", editable: "visual" },
+  { name: "footprints", kind: "container", editable: "visual" },
   { name: "details", kind: "container", editable: "visual" },
   { name: "info", kind: "container", editable: "visual" },
   { name: "tip", kind: "container", editable: "visual" },
   { name: "warning", kind: "container", editable: "visual" },
   { name: "danger", kind: "container", editable: "visual" },
   { name: "mermaid", kind: "fenced-language", editable: "visual" },
-  { name: "mindmap", kind: "fenced-language", editable: "visual" },
-  { name: "markmap", kind: "fenced-language", editable: "visual" }
+  { name: "mindmap", kind: "fenced-language", editable: "visual" }
 ];
 function findTNotesComponent(name) {
   const normalized = name.toLowerCase();