Git-based CMS 项目最容易低估的一件事,是“内容模型”其实横跨了至少三层。

第一层是源文件本身,也就是 Markdown、YAML frontmatter 和 JSON 单页配置。第二层是 CMS 配置,它决定编辑器看到哪些字段、字段叫什么、会被保存到哪里。第三层是前端读取逻辑,它最终决定这些字段以什么方式进入页面。

只改其中一层,暂时也许看起来能跑,但很快就会出现偏差。比如 Git 里已经改成双语字段了,CMS 还在按旧结构保存;或者 CMS 已经拆成中英两套 collection,前端却还在按单语列表读取。

这就是为什么这次改造里,所有目录、字段和层级调整都必须同时检查 YAML、内容文件、前端逻辑和路由。真正稳定的内容系统,不是“某一层能用”,而是四层在第二次编辑之后仍然对得上。