Repository navigation
v0.3.0 - AI 文档工程与自动目录增强版
这是 cysj-data 的第三个正式发布版本。
本版本重点从“阅读体验优化”进一步升级为“AI 文档工程化维护”。在上一版 v0.2.0 完成文档站 UI 轻量化、顶部元信息栏、底部维护入口和阅读体验优化的基础上,本版本进一步引入自动目录生成、AI 自动文档建设报告、后续研究路线图、待验证问题清单、FAQ/避坑内容、组件与编辑器基础专题等内容,使资料库更适合长期扩写、AI 检索、结构化维护和 VitePress 文档站持续迭代。
本次重点
- 新增 AI 自动化文档建设报告,用于记录 AI 辅助整理、扩写、优化文档的过程与结果。
- 新增后续研究路线图,用于规划资料库中长期内容补齐、专题扩展和研究方向。
- 新增待验证问题清单,用于统一收集需要进一步核实、补充证据或人工复核的问题。
- 新增自动侧边栏与自动目录生成脚本,可根据
docs目录结构自动生成 VitePress 侧边栏和文档目录页。 - 新增或强化知识库总索引,让用户能更容易从全局理解资料库结构。
- 新增创游世界新手常见问题快速查询内容,降低新用户查找成本。
- 新增或优化常见问题与避坑指南,提升资料库的实用性。
- 新增组件添加界面深度解析,进一步补齐脚本系统和组件体系相关资料。
- 新增创游世界编辑器基础入门,帮助新手理解编辑器核心功能。
- 批量优化文档 frontmatter、元数据和前言结构,提高 SEO、搜索和 AI 检索友好度。
- 更新自动生成文档目录,修复部分链接冲突,并补充必要文档条目。
新增内容
AI 文档工程
本版本新增了面向长期维护的 AI 文档建设记录体系,用于沉淀 AI 参与资料整理、文档补全、结构优化、报告生成和后续规划的过程。
新增内容包括:
- AI 自动文档建设报告
- 后续研究路线图
- 待验证问题清单
- 自动生成文档目录
- 自动侧边栏生成脚本
这些内容让资料库不再只是静态文档集合,而是逐步形成“扫描 → 整理 → 补齐 → 审计 → 优化 → 生成报告”的持续维护流程。
自动目录与侧边栏
本版本新增 scripts/generate-sidebar.mjs,用于自动扫描 docs 目录中的 Markdown 文件,并生成:
- VitePress 自动侧边栏配置
- 自动生成文档目录页面
这样以后新增文档后,不需要每次手动维护目录,只需要运行:
pnpm run docs:sidebar