轻量检查与维护流程
这份文档用于记录创游世界资料库的日常轻量维护方式。
它的目标不是替代完整构建，而是让日常小改、UI 微调、链接检查、同步文件清理、仓库健康巡检变得更稳定、更省时间。
日常小改优先使用
日常小改、文案调整、少量样式优化时，优先运行：
pnpm run quality:check
git diff --check
git status -sb
git diff --stat
如果这次改动主要集中在文档内容，也可以运行：
pnpm run docs:check:light
git diff --check
git status -sb
git diff --stat
同步文件清理
清理前先预览：
pnpm run docs:sync:clean:dry
确认没有误删风险后再清理：
pnpm run docs:sync:clean
这个命令只用于清理 Syncthing 冲突文件、临时下载文件、系统缩略图文件和回收站目录，不应该碰源码、Git、node_modules 或构建产物。
仓库健康巡检
需要生成轻量巡检报告时运行：
pnpm run docs:health:audit
报告会写入：
docs/维护与报告/仓库健康巡检报告.md
报告里的中低风险问题不一定都要立刻处理，但高风险问题需要优先检查。
什么时候再完整构建
日常小改不需要每次都完整构建。
以下情况再运行完整构建或更重的检查：
- 发布发行版前
- 大范围改动目录结构前后
- 修改 VitePress 配置、构建配置或依赖后
- 修改侧边栏、路由、主题入口、CI 配置后
- 部署前做最终确认时
提交前建议
提交前至少确认：
pnpm run quality:check
git diff --check
git status -sb
git diff --stat
如果输出没有明显错误，再使用 VS Code 或其他 Git 工具提交。