跳到正文
返回博客
作者
Zinian
发布时间
2026年5月1日
阅读时间
7 分钟阅读

产品构建

把 KizunaIndex 做成公共索引之后,我学到的几件事

公共索引真正有用,往往不是因为页面多复杂,而是因为内容模型足够小、足够清楚、足够容易改。

KizunaIndex 一开始只是一个很简单的公共索引表面,但真正有意思的部分从来不只是那个页面,而是它背后的结构。

最重要的教训

真正撑住系统的,是那个小而清楚的 schema,而不是视觉层。一旦内容原子被说清楚,很多事都会更容易判断:

  • 什么算 source
  • 什么算 entry
  • 哪些内容需要 review
  • 哪些东西可以后面再生成

经得住使用的形状

Code
type Entry = { title: string; slug: string; summary: string; sourceLinks: string[]; status: "draft" | "ready" | "published"; };

为什么公开很有帮助

公共系统会逼着边界变清楚。
如果一个结构在别人眼里看起来很混乱,那它通常对构建者自己也同样混乱。正因为这样,KizunaIndex 对我来说不只是一个发布表面,它也是一次结构设计练习。

我会继续保留的东西

  1. 模型保持窄。
  2. 审阅步骤保持可见。
  3. 本地编辑优先。
  4. 在内容稳定后,再给 MDX 留更大的空间。

这个站点之所以成立,不是因为它特别聪明,而是因为它的模型一直能被人理解。这不算 glamorous,但通常比炫技更能长期扩展。

相关工作

和这篇笔记关联的项目与案例研究。

项目

Kizuna Index

把分散的参考资料整理成一个可维护、可持续发布的索引表面。

产品
AI 本地博客编辑器

一个面向技术写作的本地编辑与发布工作流,支持 AI 辅助起草与修订。

AI 系统

案例研究

把静态索引改造成可维护的 AI 辅助发布工作流

一个无需先上 CMS、却能让笔记、来源与草稿输出保持对齐的发布系统。

独立产品项目

相关文章

和这个主题相邻的更多笔记。

为技术作品集网站设计真正有说服力的案例研究

精选
产品构建
2026年5月5日6 分钟阅读更新于 2026年5月7日

怎样组织案例研究,才能证明判断力,而不只是展示结果。

portfolio
case-study
writing
阅读全文

为什么建筑工作室官网不该只是作品墙

产品构建
2026年5月28日8 分钟阅读

一次 MILANO UNITO ARCHITETTURA 网站复盘:从页面职责、多语言内容模型和上线验证,看建筑工作室官网如何变成可维护的系统。

web-studio
product-building
nextjs
阅读全文

CityPlayer:不只是活动列表,而是本地活动系统

产品构建
2026年5月18日9 分钟阅读

一次 CityPlayer 复盘:如何把米兰本地活动信息整理成可维护的发布、后台和验证流程。

cityplayer
product-building
react
阅读全文

下一步

继续浏览文章列表,或者把这篇文章里的问题展开成一次具体讨论。