功能总览 ​

本文作为入口，快速了解主题能力与文档结构。

主题架构 ​

• 框架：VitePress 1.x（默认主题二次开发）
• 样式：TailwindCSS + 自定义样式层
• 组件：自定义 Vue 组件（图标、卡片、文章索引等）
• 工具：脚本生成索引、校验与清理，文章元信息工具

功能清单 ​

• 导航系统与站点布局
• 侧边栏与目录生成（多级折叠）
• 首页与列表页布局（文章索引、卡片）
• 文章元信息与 SEO（frontmatter、permalink、createTime）
• 主题样式与 Tailwind 配置
• 自定义组件库（图标、按钮、卡片等）
• 构建优化与分包、体积告警处理
• 部署与发布流程

近期更新 ​

• 背景光效：
  • 首页 Hero 发散光晕（径向/扇形渐变，深浅色适配）
  • 文档页右上角主光源（在 #VPContent 外溢扩散，暖色叠加，过渡至页面底色）
• 顶部导航：
  • 明/暗模式分别设色，支持透明观感预览
• VitePress 变量覆写：
  • 统一品牌蓝系（--vp-c-brand-1/2/3 等），代码块/按钮/背景等系统变量重设
• 版权声明模块：
  • 通过 doc-footer-before 注入卡片；作者/链接来源有优先级；索引页默认不显示；支持 frontmatter 开关

文档导航 ​

• 导航与布局
• 侧边栏与目录
• 首页与文章列表
• 样式与 Tailwind
• 组件库
• 构建与优化
• 部署与运维
• 自动索引
• 路径导航
• 版权声明模块
• 评论系统 - Twikoo 集成