v0.5.0 - 文档站视觉升级与仓库清理版

本版本围绕「创游世界资料库」的文档站视觉体验、主题结构、仓库清理、导航维护和长期工程化管理进行了一轮系统优化。

在上一版 v0.4.0 已经完成自动目录、侧边栏、内容扩展和多平台发布流程增强的基础上，本版本进一步聚焦「更好看、更干净、更稳定、更适合长期维护」的目标，让文档站从“能用的资料库”继续向“专业化中文知识库”演进。

本次重点更新

• 统一 VitePress 文档站主题样式，新增并启用 cysj-pro.css 作为主样式文件。
• 优化首页、功能卡片、正文排版、表格、引用块、代码块、深色模式等视觉体验。
• 清理旧版主题样式文件，减少多套 CSS 叠加带来的维护混乱。
• 优化 .gitignore 与同步忽略规则，减少本地备份、构建产物、Syncthing 冲突文件进入仓库的风险。
• 更新文档 UI 检查脚本，确保主题入口、布局组件、页面信息组件、操作组件、主样式文件和静态资源完整。
• 新增 llms.txt，提升 AI 检索、搜索工具和后续知识库索引的可理解性。
• 重新生成 VitePress 自动侧边栏与自动文档目录，增强文档导航体验。
• 调整部分文档结构，让格式示例、错误优化清单等内容归入更合适的维护分类。
• 完成本地 frontmatter 检查、UI 检查与 VitePress 构建验证。

UI 与阅读体验优化

本版本重点提升了文档站的整体观感：

• 首页 Hero 区域更加清爽、有层次感。
• 功能卡片增加更统一的圆角、阴影、渐变和 hover 反馈。
• 正文标题、段落、列表、表格、引用块和代码块的阅读体验进一步优化。
• 深色模式下的背景、卡片和文字对比度更加统一。
• 页面整体风格从“普通文档页”进一步升级为“现代化资料库界面”。

整体方向是：减少杂乱样式堆叠，保留清爽、现代、专业的中文知识库视觉体验。

仓库清理与结构整理

本版本对仓库中容易造成维护混乱的内容进行了清理和整理：

• 移除旧版 UI 样式文件，统一由新的主样式文件负责视觉覆盖。
• 清理本地备份、临时文件、冲突文件和构建缓存相关内容。
• 加强 .gitignore，避免后续重复提交无意义文件。
• 保留原始资料目录，不破坏资料追溯链路。
• 更新 UI 检查脚本，使后续维护时可以快速判断关键文件是否完整。

这一步让仓库结构更清晰，也让后续继续扩写文档、优化主题、发布版本时更稳定。

自动化与维护改进

本版本继续强化文档站的工程化维护能力：

• pnpm run docs:frontmatter:check 检查通过。
• pnpm run docs:ui:check 检查通过。
• pnpm run docs:sidebar 成功重新生成侧边栏与自动目录。
• pnpm run docs:build 构建成功。

本次验证说明当前文档结构、主题入口、UI 组件和 VitePress 构建流程可以正常工作。

当前项目定位

「创游世界资料库」仍然保持以下长期目标：

• 资料可导航
• 结论可追溯
• 内容可检索
• 结构可维护
• 适合玩家学习
• 适合 AI 检索与知识库构建

本版本主要不是单纯增加资料数量，而是提升整个资料库的质量、稳定性和专业观感。

已知说明

• 部分 OCR、专题研究和证据链内容仍处于整理、复核和持续完善阶段。
• 文档站后续仍会继续优化首页信息层级、SEO、搜索体验和内容分类。
• 如果使用 Syncthing 同步项目目录，建议继续忽略构建产物、缓存目录和临时文件，避免 Windows 下出现文件占用或权限冲突。

后续计划

• 继续优化首页，使其更像“创游世界知识库控制台”。
• 继续完善脚本系统、组件机制、变量广播、UI 交互和项目设计专题。
• 继续补齐 OCR 资料、编号映射、证据等级和待验证清单。
• 继续增强 SEO、站点搜索、AI 检索友好度和多平台发布流程。
• 后续考虑进一步优化构建体积、代码分包和文档站加载性能。

本地验证

本版本已通过以下命令验证：

pnpm run docs:frontmatter:check
pnpm run docs:ui:check
pnpm run docs:build