v0.6.0 - 文档站体验、UI 视觉与维护系统增强版

本版本是「创游世界资料库」继 v0.5.0 - 文档站视觉升级与仓库清理版 之后的进一步体验增强版本。

v0.5.0 重点完成了文档站主样式统一、旧样式清理、仓库结构整理、侧边栏刷新、llms.txt、frontmatter 检查、UI 检查和构建验证。本版本在此基础上，继续围绕 全站 UI 氛围、文档元信息、维护者信息、搜索与链接治理、性能优化、Issue 反馈模板、README 项目入口和长期维护流程 做了一轮系统增强。

本版本的目标是让创游世界资料库从“更好看的文档站”继续升级为“更稳定、更专业、更适合长期维护和用户反馈的中文知识库产品”。

本次重点更新

• 深度优化 VitePress 文档站整体 UI 视觉体验。
• 新增终极 UI 视觉优化样式层，增强首页、功能卡片、按钮、表格、引用块、代码块、侧边栏、右侧目录、滚动条、深色模式和移动端体验。
• 新增全站氛围增强样式层，让渐变背景、玻璃感、正文卡片层次贯穿首页、文档页、侧边栏和页脚。
• 优化首页中间 Markdown 区域，让首页不再只是普通文档正文，而更像资料库控制台。
• 优化文档正文阅读体验，为文档主体增加更统一的视觉层次和柔和背景。
• 增强文档顶部元信息系统，支持写作日期、更新日期、字数、阅读时间、维护者、状态、难度和证据等级。
• 自动补全文档写作日期和更新日期，统一文档元数据。
• 支持日期悬浮显示更精确的时间信息。
• 增加维护者悬浮信息卡片，展示 GitHub、Gitee、Telegram、QQ 群等维护者信息。
• 清理正文中重复、错误或 AI 自动生成的更新时间脚注。
• 新增 Markdown 站内链接修复脚本，自动处理链接中空格导致的解析异常。
• 新增文档内容质量审计脚本，用于检查缺失 frontmatter、空链接、仓库路径、超长段落、标题层级跳跃等问题。
• 增强搜索引擎抓取配置，优化 robots.txt、sitemap、SEO 元信息和站点搜索友好度。
• 排除历史归档、自动目录、审计报告等低价值页面进入本地搜索索引。
• 增加 Cloudflare Pages 缓存规则和构建体积审计脚本，提升二次访问和后续性能定位能力。
• 新增 GitHub Issue 表单模板，方便用户反馈文档错误、失效链接、OCR 修正、资料建议和站点体验问题。
• 深度重构 README，让 GitHub 仓库首页更清晰、更像项目入口。
• 新增或完善内容质量审计、OCR 当前状态、导航体系说明等维护入口。
• 继续强化资料库“可导航、可追溯、可检索、可维护”的长期定位。

UI 与视觉体验增强

本版本对文档站视觉做了进一步打磨。

首页体验

• 首页 Hero 区域更有视觉中心和品牌感。
• 功能卡片增加更统一的圆角、阴影、渐变、hover 反馈和玻璃质感。
• 首页中间正文区域增加卡片化背景、连续渐变氛围和控制台式视觉层次。
• 推荐阅读路径、资料可信度说明、快速入口等内容更清晰。
• 页面整体从“普通 VitePress 文档首页”进一步升级为“创游世界资料库知识控制台”。

文档页体验

• 文档主体区域增加柔和玻璃卡片背景和渐变氛围。
• 标题层级、段落、列表、表格、引用块、代码块和分割线进一步优化。
• 元信息栏采用标签化展示，视觉上更接近正式知识库系统。
• 维护者信息支持悬浮卡片展示，增强开源项目可信度和联系入口。
• 深色模式下背景、卡片、文字、边框和阴影更统一。

导航与移动端体验

• 顶部导航、侧边栏、右侧目录、上一页/下一页、页脚细节继续优化。
• Gitee 镜像仓库入口和图标显示更明确。
• 移动端按钮、表格、正文卡片和页面背景做了适配，避免拥挤和溢出。
• 支持低动画偏好，减少对动画敏感用户的不适。

文档元信息系统

本版本重点增强了每篇文档的顶部信息栏。

现在文档可以展示：

• 写作日期
• 更新日期
• 字数统计
• 阅读时间
• 维护者
• 状态
• 难度
• 证据等级

其中：

• 写作日期优先来自 created / createdAt
• 更新日期优先来自 updated / updatedAt
• 日期在页面上简洁显示，鼠标悬浮时显示更精确时间
• 维护者支持悬浮卡片，展示 GitHub、Gitee、Telegram 和 QQ 群等信息

这让文档从普通 Markdown 页面更接近正式知识库文章。

内容治理与自动化维护

本版本新增和优化了多种维护脚本，使文档维护更加自动化：

• 站内链接空格修复脚本
• AI 更新时间脚注清理脚本
• 写作日期与更新日期同步脚本
• 文档内容质量审计脚本
• 搜索索引排除脚本
• 构建体积审计脚本
• 一键部署检查脚本
• UI 检查脚本增强

这些脚本可以帮助维护者快速发现和处理：

• 错误链接
• 空链接
• 过期日期
• 重复更新时间
• 缺失 frontmatter
• 超长段落
• 标题层级异常
• 历史归档干扰搜索
• 构建产物和缓存问题

维护方式从“逐篇手工检查”进一步升级为：

自动扫描 → 自动修复 → 人工确认 → 轻量检查 → 提交发布

搜索、SEO 与浏览性能

本版本继续增强搜索和性能体验：

• 修复站内链接中空格导致的 Markdown 链接解析异常。
• 优化 robots.txt 和 sitemap 配置，提升搜索引擎抓取友好度。
• 保留 VitePress 静态站点优势，继续支持搜索引擎读取页面正文。
• 排除历史归档、自动目录和审计报告等维护页面进入本地搜索索引。
• 添加 Cloudflare Pages _headers 缓存规则，提高静态资源二次访问速度。
• 增加构建体积审计脚本，为后续定位大 JS、搜索索引和资源体积问题打基础。

开源协作与反馈机制

本版本新增 GitHub Issue Forms，用于规范用户反馈。

目前支持：

• 文档内容错误反馈
• 失效链接 / 404 反馈
• OCR 资料修正
• 新资料 / 新专题建议
• 文档站体验问题

这样用户可以按模板提交页面链接、问题类型、建议修改、证据来源和截图说明，让反馈更容易处理。

README 与仓库入口优化

本版本继续优化 README，使 GitHub 仓库首页更清晰：

• 强化在线文档站入口
• 增加 GitHub / Gitee 镜像入口
• 明确项目简介、适合人群和仓库亮点
• 补充推荐阅读路线
• 补充本地运行、日常维护、一键部署检查说明
• 补充仓库结构、内容分类、证据等级、维护原则和贡献建议
• 增加 GitHub Issues 反馈入口

现在 README 不只是说明文件，也更像项目门户。

内容结构与资料库治理

本版本继续完善资料库治理体系：

• 优化首页资料入口
• 完善“按问题查资料”
• 完善“资料证据等级说明”
• 完善“OCR 当前状态与待补清单”
• 完善“内容质量审计清单”
• 完善“导航体系说明”
• 清理和归档部分历史报告、备份文件、冲突文件和临时文件
• 强化 .gitignore / .stignore，减少 Syncthing 冲突文件和构建产物进入仓库

项目继续从“资料集合”升级为：

有入口、有证据、有状态、有审计、有反馈、有维护流程的中文资料库系统。

本地验证

本版本建议至少通过以下检查：

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