docs: 大范围整改——以深度专题为核心重建文档站

结构重建:
- 删除无代码支撑的板块（algorithms/exercises/academy/architecture/research/playbook）
- 合并入门三页为单页 getting-started.md
- 合并 3 个 API 页为单页 reference/api.md
- 合并 FAQ 到 troubleshooting.md
- 合并 guides 为 profiling.md + optimization-playbook.md

内容重写:
- 重写 3 篇深度专题（memory-layout/simd/lock-free），引用仓库真实代码
- 新增 2 篇深度专题（cmake-build-system/modern-cpp-perf）
- 重写性能分析实战指南，所有命令使用仓库真实路径
- 重写优化决策手册，合并决策树与最佳实践
- 重写首页，突出'可验证'定位

基础设施精简:
- 删除 5 个自定义 Vue 组件（Citation/ComplexityBadge/DiagramCanvas/SectionIndex/BaseAwareLink）
- 移除 mermaid/llms 插件依赖
- 合并 4 个 CSS token 文件为单文件 style.css
- 更新测试匹配新结构
- 更新 examples README 中的文档链接

Author: LessUp

README.md

@@ -42,7 +42,7 @@
 | `examples/03-modern-cpp/` | constexpr、移动语义、reserve、ranges |
 | `examples/04-simd-vectorization/` | 自动向量化、intrinsics、SIMD 封装 |
 | `examples/05-concurrency/` | 原子操作、无锁队列、OpenMP |
-| `docs/` | VitePress 文档站，覆盖学院 / 架构 / 实践手册 / 参考 / 研究 |
+| `docs/` | VitePress 文档站，覆盖深度专题 / 实战指南 / API 参考 |
 
 ## 快速开始
 
@@ -74,8 +74,8 @@ cmake --preset=ubsan && cmake --build build/ubsan && ctest --preset=ubsan
 ## 文档入口
 
 - **文档站：** <https://lessup.github.io/cpp-high-performance-guide/>
-- **实践手册：** [`docs/zh/playbook/index.md`](docs/zh/playbook/index.md)
-- **参考：** [`docs/zh/reference/index.md`](docs/zh/reference/index.md)
+- **深度专题：** [`docs/zh/deep-dives/`](docs/zh/deep-dives/)
+- **API 参考：** [`docs/zh/reference/api.md`](docs/zh/reference/api.md)
 
 ## 技术栈
 

docs/.vitepress/config.ts

@@ -1,6 +1,4 @@
 import { defineConfig } from 'vitepress'
-import { withMermaid } from 'vitepress-plugin-mermaid'
-import llmstxt from 'vitepress-plugin-llms'
 
 const rawBase = process.env.VITEPRESS_BASE
 const base = rawBase
@@ -10,93 +8,23 @@ const base = rawBase
   : '/'
 
 const siteTitle = 'C++ 高性能指南'
-const siteDescription = '可运行的 C++ 性能工程文档，覆盖入门、指南、深度专题、算法、练习与参考。'
-const siteUrl = 'https://lessup.github.io'
-const canonicalBase = '/cpp-high-performance-guide/'
+const siteDescription = '可验证的现代 C++20 性能工程：内存布局、SIMD、无锁并发、构建系统，全部附带可运行代码与基准测试。'
 const currentYear = new Date().getFullYear()
 
-function assetPath(path: string): string {
-  const normalizedPath = path.replace(/^\/+/, '')
-  return `${base}${normalizedPath}`
-}
-
-function canonicalAssetUrl(path: string): string {
-  const normalizedPath = path.replace(/^\/+/, '')
-  return new URL(`${canonicalBase.replace(/^\/+/, '')}${normalizedPath}`, `${siteUrl}/`).toString()
-}
-
-const zhGettingStartedItems = [
-  { text: '先决条件', link: '/zh/getting-started/prerequisites' },
-  { text: '安装指南', link: '/zh/getting-started/installation' },
-  { text: '快速开始', link: '/zh/getting-started/quickstart' },
-]
-
-const zhGuidesItems = [
-  { text: '学习路径', link: '/zh/guides/learning-path' },
-  { text: '性能分析指南', link: '/zh/guides/profiling-guide' },
-  { text: '验证与 Sanitizer', link: '/zh/guides/validation' },
-  { text: '优化决策树', link: '/zh/guides/optimization-decision-tree' },
-  { text: '最佳实践', link: '/zh/guides/best-practices' },
-]
-
-const zhDeepDivesItems = [
-  { text: '内存布局', link: '/zh/deep-dives/memory-layout' },
-  { text: '无锁队列', link: '/zh/deep-dives/lock-free-queue' },
-  { text: 'SIMD 内部机制', link: '/zh/deep-dives/simd-internals' },
-]
-
-const zhAlgorithmsItems = [
-  { text: '排序算法', link: '/zh/algorithms/sorting' },
-  { text: '哈希算法', link: '/zh/algorithms/hashing' },
-]
-
-const zhExerciseItems = [
-  { text: '内存练习', link: '/zh/exercises/module-02-memory' },
-  { text: 'SIMD 练习', link: '/zh/exercises/module-04-simd' },
-  { text: '并发练习', link: '/zh/exercises/module-05-concurrency' },
-  { text: '解答', link: '/zh/exercises/solutions' },
-]
-
-const zhReferenceItems = [
-  { text: '内存工具', link: '/zh/reference/api/memory-utils' },
-  { text: 'SIMD Wrapper', link: '/zh/reference/api/simd-wrapper' },
-  { text: 'Benchmark 工具', link: '/zh/reference/api/benchmark-utils' },
-  { text: '常见问题', link: '/zh/reference/faq' },
-  { text: '故障排查', link: '/zh/reference/troubleshooting' },
-]
-
-export default withMermaid(defineConfig({
+export default defineConfig({
   title: siteTitle,
   description: siteDescription,
   base,
   cleanUrls: false,
   lastUpdated: true,
-  mermaid: {
-    startOnLoad: false,
-    securityLevel: 'strict',
-    flowchart: { useMaxWidth: true, htmlLabels: true },
-    sequence: { useMaxWidth: true },
-    gantt: { useMaxWidth: true },
-    theme: 'base',
-    themeVariables: {
-      fontFamily: 'Inter, system-ui, sans-serif',
-      fontSize: '14px',
-    },
-  },
   head: [
-    ['link', { rel: 'icon', type: 'image/svg+xml', href: assetPath('/logo.svg') }],
+    ['link', { rel: 'icon', type: 'image/svg+xml', href: `${base}logo.svg` }],
     ['meta', { name: 'theme-color', content: '#3476f6' }],
     ['meta', { property: 'og:type', content: 'website' }],
     ['meta', { property: 'og:site_name', content: siteTitle }],
     ['meta', { property: 'og:title', content: siteTitle }],
     ['meta', { property: 'og:description', content: siteDescription }],
-    ['meta', { property: 'og:image', content: canonicalAssetUrl('/og-card.png') }],
-    ['meta', { property: 'og:image:alt', content: 'C++ 高性能指南文档社交卡片' }],
     ['meta', { property: 'og:locale', content: 'zh_CN' }],
-    ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
-    ['meta', { name: 'twitter:image', content: canonicalAssetUrl('/og-card.png') }],
-    ['meta', { name: 'twitter:title', content: siteTitle }],
-    ['meta', { name: 'twitter:description', content: siteDescription }],
     ['meta', { name: 'keywords', content: 'C++, 性能, SIMD, 并发, CMake, 基准测试, 内存布局, 无锁队列' }],
   ],
   locales: {
@@ -116,12 +44,10 @@ export default withMermaid(defineConfig({
           copyright: `版权所有 © ${currentYear} C++ HPC Guide 贡献者`,
         },
         nav: [
-          { text: '入门', link: '/zh/getting-started/quickstart', activeMatch: '/zh/getting-started/' },
-          { text: '指南', link: '/zh/guides/learning-path', activeMatch: '/zh/guides/' },
+          { text: '入门', link: '/zh/getting-started', activeMatch: '/zh/getting-started' },
           { text: '深度专题', link: '/zh/deep-dives/memory-layout', activeMatch: '/zh/deep-dives/' },
-          { text: '算法', link: '/zh/algorithms/sorting', activeMatch: '/zh/algorithms/' },
-          { text: '练习', link: '/zh/exercises/module-02-memory', activeMatch: '/zh/exercises/' },
-          { text: '参考', link: '/zh/reference/faq', activeMatch: '/zh/reference/' },
+          { text: '实战指南', link: '/zh/guides/profiling', activeMatch: '/zh/guides/' },
+          { text: '参考', link: '/zh/reference/api', activeMatch: '/zh/reference/' },
         ],
         sidebar: {
           '/zh/': [
@@ -133,27 +59,33 @@ export default withMermaid(defineConfig({
             },
             {
               text: '入门',
-              items: zhGettingStartedItems,
-            },
-            {
-              text: '指南',
-              items: zhGuidesItems,
+              items: [
+                { text: '快速开始', link: '/zh/getting-started' },
+              ],
             },
             {
               text: '深度专题',
-              items: zhDeepDivesItems,
-            },
-            {
-              text: '算法',
-              items: zhAlgorithmsItems,
+              items: [
+                { text: '内存布局与缓存', link: '/zh/deep-dives/memory-layout' },
+                { text: 'SIMD 向量化', link: '/zh/deep-dives/simd-internals' },
+                { text: '无锁并发', link: '/zh/deep-dives/lock-free-queue' },
+                { text: '现代 CMake 构建', link: '/zh/deep-dives/cmake-build-system' },
+                { text: 'C++20 性能实践', link: '/zh/deep-dives/modern-cpp-perf' },
+              ],
             },
             {
-              text: '练习',
-              items: zhExerciseItems,
+              text: '实战指南',
+              items: [
+                { text: '性能分析实战', link: '/zh/guides/profiling' },
+                { text: '优化决策手册', link: '/zh/guides/optimization-playbook' },
+              ],
             },
             {
               text: '参考',
-              items: zhReferenceItems,
+              items: [
+                { text: 'API 参考', link: '/zh/reference/api' },
+                { text: '故障排查', link: '/zh/reference/troubleshooting' },
+              ],
             },
           ],
         },
@@ -179,23 +111,10 @@ export default withMermaid(defineConfig({
     search: { provider: 'local' },
     logo: {
       light: '/logo.svg',
-      dark: '/logo-dark.svg',
+      dark: '/logo.svg',
     },
     socialLinks: [
       { icon: 'github', link: 'https://github.com/LessUp/cpp-high-performance-guide' },
     ],
   },
-  vite: {
-    plugins: [llmstxt()],
-    build: {
-      rollupOptions: {
-        output: {
-          manualChunks(id) {
-            if (id.includes('mermaid')) return 'mermaid-lazy'
-            if (id.includes('katex')) return 'katex-lazy'
-          },
-        },
-      },
-    },
-  },
-}))
+})