调试手册

本目录收录知识库搭建和运维过程中遇到的问题及解决方案。

问题索引

文件	问题描述
CMS后台空白或报错.md	admin 页面空白、config.yml 加载失败、文件不显示
搜索无结果.md	搜索功能不工作、搜不到中文内容
构建失败.md	npm run build 报错及修复

工具脚本

文件	用途
add-frontmatter.js	批量为 docs 下所有 md 文件添加 slug + title frontmatter
fix-readme.js	为缺少 frontmatter 的 README.md 补全 title 字段