上一篇讲了需求与架构，这一篇讲架构之后更磨人的部分：内容生产线。房子盖好只是开始，让内容持续、稳定、不变形地流进来，才是这座知识库真正难的地方。过程里有两次推倒重来，都写在下面。

先立契约：内容怎么进库

知识库的内容来源不止我一个：旧专栏要迁、案例在别处生产、工具档案由 AI 按流程产出。来源一多，第一件要锁死的就是交付格式。

最终契约很朴素：一篇一个 HTML 文件，头部是元数据（标题、slug、所属栏、排序、状态），正文是纯结构化 HTML。导入脚本做三件事——校验必填字段、按 slug 判断插入还是更新、挂到正确的栏。有两条设计值得单独说。

内容以数据库记录存在，文件只是运输工具。导入之后文件不参与线上任何渲染，线上没有「内容文件」这个概念。好处是权限、排序、状态全部是数据库里的一列，改起来是一句 UPDATE，不用碰文件。