KizunaIndex 一开始只是一个很简单的公共索引表面,但真正有意思的部分从来不只是那个页面,而是它背后的结构。
最重要的教训
真正撑住系统的,是那个小而清楚的 schema,而不是视觉层。一旦内容原子被说清楚,很多事都会更容易判断:
- 什么算 source
- 什么算 entry
- 哪些内容需要 review
- 哪些东西可以后面再生成
经得住使用的形状
type Entry = { title: string; slug: string; summary: string; sourceLinks: string[]; status: "draft" | "ready" | "published"; };
为什么公开很有帮助
公共系统会逼着边界变清楚。
如果一个结构在别人眼里看起来很混乱,那它通常对构建者自己也同样混乱。正因为这样,KizunaIndex 对我来说不只是一个发布表面,它也是一次结构设计练习。
我会继续保留的东西
- 模型保持窄。
- 审阅步骤保持可见。
- 本地编辑优先。
- 在内容稳定后,再给 MDX 留更大的空间。
这个站点之所以成立,不是因为它特别聪明,而是因为它的模型一直能被人理解。这不算 glamorous,但通常比炫技更能长期扩展。