@tnotesjs/core 0.6.1 → 0.8.0

package/markdown/components.ts

@@ -0,0 +1,86 @@
+export type TNotesComponentKind =
+  | 'block-component'
+  | 'inline-component'
+  | 'container'
+  | 'fenced-language'
+
+export interface TNotesComponentDescriptor {
+  name: string
+  aliases?: string[]
+  kind: TNotesComponentKind
+  editable: 'visual' | 'source-only' | 'placeholder'
+}
+
+/**
+ * Runtime-neutral registry shared by Desk and other TNotes clients. It does not
+ * import Vue or VitePress and is therefore safe in Node/Electron workers.
+ */
+export const TNOTES_COMPONENTS: readonly TNotesComponentDescriptor[] = [
+  {
+    name: 'BilibiliVideo',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'WordList',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Footprints',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'NotesTable',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Tooltip',
+    kind: 'inline-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Mindmap',
+    aliases: ['MindmapPreview'],
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Mermaid',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Discussions',
+    kind: 'block-component',
+    editable: 'placeholder',
+  },
+  {
+    name: 'SidebarCard',
+    kind: 'block-component',
+    editable: 'placeholder',
+  },
+  { 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' },
+] as const
+
+export function findTNotesComponent(
+  name: string,
+): TNotesComponentDescriptor | undefined {
+  const normalized = name.toLowerCase()
+  return TNOTES_COMPONENTS.find(
+    (component) =>
+      component.name.toLowerCase() === normalized ||
+      component.aliases?.some((alias) => alias.toLowerCase() === normalized),
+  )
+}

package/markdown/index.ts

@@ -0,0 +1,17 @@
+export {
+  NOTE_TOC_END_TAG,
+  NOTE_TOC_START_TAG,
+  formatTNotesNote,
+} from './noteFormatter'
+export type {
+  FormatTNotesNoteInput,
+  FormatTNotesNoteResult,
+} from './noteFormatter'
+export {
+  TNOTES_COMPONENTS,
+  findTNotesComponent,
+} from './components'
+export type {
+  TNotesComponentDescriptor,
+  TNotesComponentKind,
+} from './components'

package/markdown/noteFormatter.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+  findTNotesComponent,
+  formatTNotesNote,
+  TNOTES_COMPONENTS,
+} from './index'
+
+describe('TNotes Markdown contract', () => {
+  it('exposes runtime-neutral component descriptors', () => {
+    expect(findTNotesComponent('NotesTable')?.name).toBe('NotesTable')
+    expect(findTNotesComponent('WordList')?.name).toBe('WordList')
+    expect(findTNotesComponent('BilibiliVideo')?.name).toBe('BilibiliVideo')
+    expect(findTNotesComponent('N')).toBeUndefined()
+    expect(findTNotesComponent('SWIPER')?.kind).toBe('container')
+    expect(findTNotesComponent('Mermaid')?.editable).toBe('visual')
+    expect(TNOTES_COMPONENTS.some((item) => item.name === 'markmap')).toBe(false)
+    expect(TNOTES_COMPONENTS.some((item) => item.name === 'mindmap')).toBe(true)
+  })
+
+  it('restores missing generated markers without interpreting fenced headings', async () => {
+    const result = await formatTNotesNote({
+      content: '## Heading\n\n~~~md\n### source\n~~~\n',
+      noteIndex: '0042',
+      title: 'Answer',
+      repoOwner: 'tnotesjs',
+      repoName: 'TNotes.fixture',
+      noteConfig: {
+        id: 'answer',
+        bilibili: [],
+        tnotes: [],
+        yuque: [],
+        done: false,
+        enableDiscussions: false,
+      },
+      prettier: false,
+    })
+
+    expect(result.content).toContain('<!-- region:toc -->')
+    expect(result.content).toContain('<!-- endregion:toc -->')
+    expect(result.generatedToc).toEqual(['- [1. Heading](#1-heading)'])
+    expect(result.content).toContain('~~~md\n### source\n~~~')
+  })
+})

package/markdown/noteFormatter.ts

@@ -0,0 +1,237 @@
+import { generateAnchor } from '../utils/generateAnchor'
+
+import type { WorkspaceNoteConfig } from '../workspace/types'
+
+export const NOTE_TOC_START_TAG = '<!-- region:toc -->'
+export const NOTE_TOC_END_TAG = '<!-- endregion:toc -->'
+
+/**
+ * Lazy-loads prettier so consumers that never format (e.g. the read-only Nav
+ * VS Code extension) don't pay the top-level import cost / don't break their
+ * bundle (prettier's ESM entry crashes inside a CJS bundle at load time).
+ */
+async function prettierFormat(
+  content: string,
+  options: { parser: string; proseWrap: string; endOfLine: string },
+): Promise<string> {
+  const module = await import('prettier')
+  const prettier = (module as { default?: typeof import('prettier') }).default ?? module
+  return prettier.format(content, options as Parameters<typeof prettier.format>[1])
+}
+
+export interface FormatTNotesNoteInput {
+  content: string
+  noteIndex: string
+  title: string
+  repoOwner: string
+  repoName: string
+  noteConfig: WorkspaceNoteConfig
+  prettier?: boolean
+}
+
+export interface FormatTNotesNoteResult {
+  content: string
+  generatedTitle: string
+  generatedToc: string[]
+}
+
+function generatedNoteTitle(input: FormatTNotesNoteInput): string {
+  const dirName = `${input.noteIndex}. ${input.title}`
+  const encodedDirName = encodeURIComponent(dirName)
+  const repositoryUrl = `https://github.com/${input.repoOwner}/${input.repoName}/tree/main/notes`
+  return `# [${dirName}](${repositoryUrl}/${encodedDirName})`
+}
+
+function ensureGeneratedTitle(lines: string[], generatedTitle: string): void {
+  if (lines.length === 0) {
+    lines.push(generatedTitle)
+    return
+  }
+
+  lines[0] = lines[0].replace(/^\uFEFF/, '')
+  if (lines[0].trimStart().startsWith('# ')) {
+    lines[0] = generatedTitle
+    return
+  }
+
+  lines.unshift(generatedTitle, '')
+}
+
+function ensureTocRegion(lines: string[]): { start: number; end: number } {
+  let start = lines.findIndex((line) => line.trim() === NOTE_TOC_START_TAG)
+  let end = lines.findIndex(
+    (line, index) => index > start && line.trim() === NOTE_TOC_END_TAG,
+  )
+
+  if (start >= 0 && end > start) return { start, end }
+
+  if (start >= 0) lines.splice(start, 1)
+  if (end >= 0) lines.splice(end > start ? end - 1 : end, 1)
+
+  let insertAt = 1
+  while (insertAt < lines.length && lines[insertAt].trim() === '') insertAt++
+  lines.splice(
+    insertAt,
+    0,
+    '',
+    NOTE_TOC_START_TAG,
+    '',
+    NOTE_TOC_END_TAG,
+    '',
+  )
+  start = insertAt + 1
+  end = insertAt + 3
+  return { start, end }
+}
+
+interface Heading {
+  level: number
+  text: string
+}
+
+function normalizeHeadings(lines: string[]): Heading[] {
+  const headings: Heading[] = []
+  const counters = { h2: 0, h3: 0 }
+  let fence: { marker: '`' | '~'; length: number } | null = null
+  let inHtmlComment = false
+
+  for (let index = 0; index < lines.length; index++) {
+    const line = lines[index]
+    const fenceMatch = line.match(/^\s{0,3}(`{3,}|~{3,})/)
+    if (fenceMatch) {
+      const marker = fenceMatch[1][0] as '`' | '~'
+      if (!fence) {
+        fence = { marker, length: fenceMatch[1].length }
+      } else if (fence.marker === marker && fenceMatch[1].length >= fence.length) {
+        fence = null
+      }
+      continue
+    }
+    if (fence) continue
+
+    if (inHtmlComment) {
+      if (line.includes('-->')) inHtmlComment = false
+      continue
+    }
+    const commentStart = line.indexOf('<!--')
+    if (commentStart >= 0) {
+      const commentEnd = line.indexOf('-->', commentStart + 4)
+      if (commentEnd < 0) inHtmlComment = true
+      if (line.trimStart().startsWith('<!--')) continue
+    }
+
+    const match = line.match(/^(#{2,6})\s+(.+?)\s*#*\s*$/)
+    if (!match) continue
+
+    const level = match[1].length
+    const plainText = match[2]
+      .replace(/^\d+(?:\.\d+)+\.?\s+|^\d+\.\s+/, '')
+      .trim()
+    let text = plainText
+
+    if (level === 2) {
+      counters.h2 += 1
+      counters.h3 = 0
+      text = `${counters.h2}. ${plainText}`
+    } else if (level === 3) {
+      counters.h3 += 1
+      text = `${counters.h2}.${counters.h3}. ${plainText}`
+    }
+
+    lines[index] = `${'#'.repeat(level)} ${text}`
+    headings.push({ level, text })
+  }
+
+  return headings
+}
+
+function buildHeadingToc(headings: Heading[]): string[] {
+  return headings.map((heading) => {
+    const indent = ' '.repeat(Math.max(0, heading.level - 2) * 2)
+    return `${indent}- [${heading.text}](#${generateAnchor(heading.text)})`
+  })
+}
+
+function stringArray(value: unknown): string[] {
+  return Array.isArray(value)
+    ? value.filter((item): item is string => typeof item === 'string')
+    : []
+}
+
+function buildResourceToc(input: FormatTNotesNoteInput): string[] {
+  const bilibili = stringArray(input.noteConfig.bilibili)
+  const relatedTNotes = stringArray(input.noteConfig.tnotes)
+  const yuque = stringArray(input.noteConfig.yuque)
+  if (bilibili.length + relatedTNotes.length + yuque.length === 0) return []
+
+  const lines: string[] = ['::: details 📚 相关资源', '']
+  if (bilibili.length > 0) {
+    lines.push(
+      '- [📺 bilibili（笔记视频资源）](https://space.bilibili.com/407241004)',
+      ...bilibili.map(
+        (bvid, index) =>
+          `  - [bilibili.${input.repoName}.${input.noteIndex}.${index + 1}](https://www.bilibili.com/video/${bvid})`,
+      ),
+    )
+  }
+  if (relatedTNotes.length > 0) {
+    lines.push(
+      '- [📒 TNotes（相关知识库）](https://tnotesjs.github.io/TNotes/)',
+      ...relatedTNotes.map(
+        (repoName) =>
+          `  - [TNotes.${repoName}](https://tnotesjs.github.io/TNotes.${repoName}/)`,
+      ),
+    )
+  }
+  if (yuque.length > 0) {
+    const base = 'https://www.yuque.com/tdahuyou/tnotes.yuque/'
+    lines.push(
+      `- [📂 TNotes.yuque（笔记附件资源）](${base})`,
+      ...yuque.map(
+        (slug) =>
+          `  - [TNotes.yuque.${input.repoName.replace('TNotes.', '')}.${input.noteIndex}](${base}${slug})`,
+      ),
+    )
+  }
+  lines.push('', ':::', '')
+  return lines
+}
+
+export async function formatTNotesNote(
+  input: FormatTNotesNoteInput,
+): Promise<FormatTNotesNoteResult> {
+  let content = input.content.replace(/\r\n?/g, '\n')
+  if (input.prettier !== false) {
+    content = await prettierFormat(content, {
+      parser: 'markdown',
+      proseWrap: 'never',
+      endOfLine: 'lf',
+    })
+  }
+
+  const lines = content.replace(/\n$/, '').split('\n')
+  const title = generatedNoteTitle(input)
+  ensureGeneratedTitle(lines, title)
+  let region = ensureTocRegion(lines)
+  const headings = normalizeHeadings(lines)
+
+  // Heading normalization does not add/remove lines, but resolving the region
+  // again makes the invariant explicit and protects future format extensions.
+  region = ensureTocRegion(lines)
+  const toc = buildHeadingToc(headings)
+  const resources = buildResourceToc(input)
+  lines.splice(
+    region.start + 1,
+    region.end - region.start - 1,
+    '',
+    ...resources,
+    ...toc,
+    '',
+  )
+
+  return {
+    content: `${lines.join('\n').replace(/\n{3,}$/g, '\n\n')}\n`,
+    generatedTitle: title,
+    generatedToc: toc,
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tnotesjs/core",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "TNotes 知识库核心框架 —— 基于 VitePress 的笔记管理系统",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -34,14 +34,17 @@
     "./vitepress/*": "./vitepress/*"
   },
   "files": [
+    "commands/",
     "config/",
     "core/",
+    "markdown/",
     "services/",
     "utils/",
     "dist/",
     "templates/",
     "vitepress/",
-    "types/"
+    "types/",
+    "workspace/"
   ],
   "scripts": {
     "build": "tsup",
@@ -61,7 +64,8 @@
     "vue": "^3.5.0"
   },
   "dependencies": {
-    "@tnotesjs/mindmap-core": "^0.2.1",
+    "@tnotesjs/mindmap-core": "^0.2.2",
+    "@tnotesjs/ui": "^0.1.1",
     "echarts": "^6.0.0",
     "github-slugger": "^2.0.0",
     "markdown-it-container": "^4.0.0",

package/services/file-watcher/folderChangeHandler.ts

@@ -5,11 +5,12 @@
  */
 
 import { existsSync, promises as fsPromises } from 'fs'
-import { join } from 'path'
+import { dirname, join } from 'path'
 
 import { safeExecute } from './internal'
 import { REPO_NOTES_URL } from '../../config/constants'
 import { generateNoteTitle } from '../../config/templates'
+import { reconcileTocFromFiles } from '../reconcileToc'
 
 import type { EventScheduler } from './eventScheduler'
 import type { WatchState } from './watchState'
@@ -17,7 +18,6 @@ import type { NoteIndexCache } from '../../core/NoteIndexCache'
 import type { Logger } from '../../utils'
 import type { NoteService } from '../note/service'
 import type { ReadmeService } from '../readme/service'
-import type { TocService } from '../toc/service'
 
 const RENAME_REVERT_DELAY_MS = 2000
 
@@ -41,8 +41,6 @@ interface FolderChangeHandlerConfig {
   noteService: NoteService
   /** README 服务实例 */
   readmeService: ReadmeService
-  /** TOC 服务实例 */
-  tocService: TocService
   /** 笔记索引缓存实例 */
   noteIndexCache: NoteIndexCache
   /** 日志记录器 */
@@ -89,7 +87,7 @@ export class FolderChangeHandler {
   }
 
   async handleFolderDeletion(deletedFolderName: string): Promise<void> {
-    const { scheduler, watchState, noteIndexCache, tocService, logger } =
+    const { scheduler, watchState, noteIndexCache, logger, notesDir } =
       this.config
 
     if (scheduler.getUpdating()) return
@@ -106,12 +104,11 @@ export class FolderChangeHandler {
       watchState.clearNoteCaches(deletedFolderName)
       noteIndexCache.delete(noteIndex)
 
-      // 更新根 README.md、sidebar.json
+      // files→TOC 对齐（Workspace）：TOC 行随目录消失而移除
       await safeExecute(
         `删除笔记 ${noteIndex}`,
         async () => {
-          await tocService.deleteNoteFromToc(noteIndex)
-          await tocService.regenerateSidebar()
+          await reconcileTocFromFiles(dirname(notesDir))
           this.config.onNoteStructureChanged?.(`watcher:delete:${noteIndex}`)
         },
         logger,
@@ -202,7 +199,7 @@ export class FolderChangeHandler {
     noteIndex: string,
     newName: string,
   ): Promise<void> {
-    const { noteIndexCache, tocService, logger, notesDir } = this.config
+    const { noteIndexCache, logger, notesDir } = this.config
 
     logger.info(`笔记索引未变 (${noteIndex})，只更新标题`)
     noteIndexCache.updateFolderName(noteIndex, newName)
@@ -214,8 +211,12 @@ export class FolderChangeHandler {
       logger,
     )
 
-    await tocService.renameNoteInToc(noteIndex, newName)
-    await tocService.regenerateSidebar()
+    // files→TOC 对齐（Workspace）：标题以目录名为准，行位置/完成标记保留
+    await safeExecute(
+      `标题重命名同步目录 ${noteIndex}`,
+      () => reconcileTocFromFiles(dirname(notesDir)),
+      logger,
+    )
     this.config.onNoteStructureChanged?.(`watcher:rename-title:${noteIndex}`)
     logger.success(`标题更新完成`)
   }
@@ -266,11 +267,16 @@ export class FolderChangeHandler {
     oldNoteIndex: string,
     newNoteIndex: string,
   ): Promise<void> {
-    const { noteService, noteIndexCache, tocService, logger } = this.config
+    const { noteService, noteIndexCache, logger, notesDir } = this.config
 
     logger.info(`笔记索引变更: ${oldNoteIndex} → ${newNoteIndex}`)
 
-    await tocService.deleteNoteFromToc(oldNoteIndex)
+    // files→TOC 对齐（Workspace）：旧索引行随目录消失移除，新索引行按编号追加
+    await safeExecute(
+      `索引变更同步目录 ${oldNoteIndex}→${newNoteIndex}`,
+      () => reconcileTocFromFiles(dirname(notesDir)),
+      logger,
+    )
 
     const newNote = noteService.getNoteByIndex(newNoteIndex)
 
@@ -278,8 +284,6 @@ export class FolderChangeHandler {
       noteIndexCache.delete(oldNoteIndex)
       noteIndexCache.add(newNote)
 
-      await tocService.appendNoteToToc(newNoteIndex)
-      await tocService.regenerateSidebar()
       this.config.onNoteStructureChanged?.(
         `watcher:rename-index:${oldNoteIndex}->${newNoteIndex}`,
       )

package/services/file-watcher/globalUpdateCoordinator.ts

@@ -1,25 +1,26 @@
 /**
  * services/file-watcher/globalUpdateCoordinator.ts
  *
- * 全局更新协调：应用配置更新、更新 README 列表
+ * 全局更新协调：应用配置更新、更新 README 列表。
+ * TOC/sidebar 的写入统一走 Workspace 的 `toc.reconcileFromFiles()`
+ * （0004 方案 B），不再直接操作 TocService。
  */
 
+import { dirname } from 'path'
+
 import { safeExecute } from './internal'
+import { reconcileTocFromFiles } from '../reconcileToc'
 
 import type { WatchEvent } from './internal'
-import type { NoteIndexCache } from '../../core/NoteIndexCache'
 import type { Logger } from '../../utils'
 import type { ReadmeService } from '../readme/service'
-import type { TocService } from '../toc/service'
 
 
 interface GlobalUpdateCoordinatorConfig {
+  /** 笔记目录路径 */
+  notesDir: string
   /** README 服务实例，用于更新笔记 README */
   readmeService: ReadmeService
-  /** TOC 服务实例，用于更新 TOC.md 与 sidebar */
-  tocService: TocService
-  /** 笔记索引缓存实例 */
-  noteIndexCache: NoteIndexCache
   /** 日志记录器 */
   logger: Logger
 }
@@ -30,26 +31,19 @@ export class GlobalUpdateCoordinator {
   async applyConfigUpdates(changedNoteIndexes: string[]): Promise<void> {
     if (changedNoteIndexes.length === 0) return
 
-    const { tocService, noteIndexCache, logger } = this.config
-
-    logger.info('检测到笔记状态变化，增量更新全局文件...')
-
-    for (const noteIndex of changedNoteIndexes) {
-      await safeExecute(
-        `增量更新 ${noteIndex}`,
-        async () => {
-          const item = noteIndexCache.getByNoteIndex(noteIndex)
-          await tocService.updateNoteInToc(
-            noteIndex,
-            item?.noteConfig || {},
-          )
-          logger.info(`增量更新 TOC.md 中的笔记: ${noteIndex}`)
-        },
-        logger,
-      )
-    }
-
-    await tocService.regenerateSidebar()
+    const { logger, notesDir } = this.config
+
+    logger.info('检测到笔记状态变化，同步全局文件...')
+
+    // files→TOC 对齐（Workspace）：config.done 等以文件为真值，
+    // 同步到 TOC 行标记与 sidebar。
+    await safeExecute(
+      '配置变更同步目录',
+      () => reconcileTocFromFiles(dirname(notesDir)),
+      logger,
+    )
+
+    logger.info(`已同步配置变更的笔记: ${changedNoteIndexes.join(', ')}`)
   }
 
   async updateNoteReadmesOnly(events: WatchEvent[]): Promise<void> {

package/services/file-watcher/service.ts

@@ -24,7 +24,6 @@ import { NoteIndexCache } from '../../core/NoteIndexCache'
 import { logger } from '../../utils'
 import { NoteService } from '../note/service'
 import { ReadmeService } from '../readme/service'
-import { TocService } from '../toc/service'
 
 import type { WatchEvent } from './internal'
 
@@ -49,7 +48,6 @@ export class FileWatcherService {
   private adapter!: FsWatcherAdapter
   private noteService!: NoteService
   private readmeService!: ReadmeService
-  private tocService!: TocService
   private noteIndexCache!: NoteIndexCache
   private unlockTimer: NodeJS.Timeout | null = null
 
@@ -68,7 +66,6 @@ export class FileWatcherService {
   private init(): void {
     this.noteService = NoteService.getInstance()
     this.readmeService = ReadmeService.getInstance()
-    this.tocService = TocService.getInstance()
     this.noteIndexCache = NoteIndexCache.getInstance()
 
     this.watchState = this.initWatchState()
@@ -103,7 +100,6 @@ export class FileWatcherService {
       scheduler: this.scheduler,
       noteService: this.noteService,
       readmeService: this.readmeService,
-      tocService: this.tocService,
       noteIndexCache: this.noteIndexCache,
       logger,
       onRenameSuccess: (payload) => {
@@ -228,9 +224,8 @@ export class FileWatcherService {
 
   private initCoordinator(): GlobalUpdateCoordinator {
     return new GlobalUpdateCoordinator({
+      notesDir: this.notesDir,
       readmeService: this.readmeService,
-      tocService: this.tocService,
-      noteIndexCache: this.noteIndexCache,
       logger,
     })
   }

package/services/index.ts

@@ -8,7 +8,6 @@ export { FileWatcherService } from './file-watcher'
 export { GitService } from './git'
 export { NoteService } from './note'
 export { ReadmeService } from './readme'
-export { TocService } from './toc'
 export { VitepressService } from './vitepress'
 export { InitSubRepoService } from './init-sub-repo'
 export * from './init-sub-repo/initSubRepoLogic'

package/services/note/service.ts

@@ -8,7 +8,7 @@ import { writeFileSync, readFileSync, promises as fsPromises } from 'fs'
 import { join } from 'path'
 import { v4 as uuidv4 } from 'uuid'
 
-import { NOTES_PATH, CONSTANTS, REPO_NOTES_URL } from '../../config/constants'
+import { NOTES_PATH, CONSTANTS, REPO_NOTES_URL, ROOT_DIR_PATH } from '../../config/constants'
 import {
   generateNoteTitle,
   getNewNoteReadmeBody,
@@ -16,7 +16,7 @@ import {
 import { NoteIndexCache } from '../../core/NoteIndexCache'
 import { NoteManager } from '../../core/NoteManager'
 import { ensureDirectory, logger } from '../../utils'
-import { TocService } from '../toc/service'
+import { reconcileTocFromFiles } from '../reconcileToc'
 
 import type { NoteInfo, NoteConfig } from '../../types'
 
@@ -247,10 +247,8 @@ export class NoteService {
       logger.info(`检测到全局字段变更 (${noteIndex})，正在增量更新全局文件...`)
 
       // 使用增量更新
-      const tocService = TocService.getInstance()
-
-      await tocService.updateNoteInToc(noteIndex, updates)
-      await tocService.regenerateSidebar()
+      // files→TOC 对齐（Workspace）：config 已写盘，同步 TOC 行标记与 sidebar
+      await reconcileTocFromFiles(ROOT_DIR_PATH)
 
       logger.info(`全局文件增量更新完成 (${noteIndex})`)
     } else {