Skip to content
返回博客Back to blog

写作Writing

在早期阶段,小型内容模型往往比大型 CMS 迁移更有用Small Content Models Beat Large CMS Migrations Early On

在内容形状真正稳定之前,一个窄而本地的 schema 往往比仓促上 CMS 更耐用。A narrow local schema often outlasts a big CMS decision until the content shape is actually stable.

前端Frontend
2026年4月10日April 10, 20266 分钟阅读6 min readLinfeng Chen更新于 2026年4月12日Updated April 12, 2026
content-modeling
mdx
typescript
routing

很多大型 CMS 迁移来得太早了,往往是在内容模型还没准备好的时候。这通常不是最好的时机。

什么东西最先开始起作用

一个小型的 TypeScript 内容层,通常立刻就能给我三样东西:

  1. 有类型的 routes
  2. 可预测的列表
  3. 以后更容易迁移

为什么本地优先有帮助

本地内容文件会把结构直接摊出来。这样一来,在引入更大系统之前,我就能先问对问题:

  • 现在到底有哪些内容?
  • 哪些字段已经稳定了?
  • 哪些 routes 必须是 canonical?
  • 哪些东西还应该继续当 draft?

一个不错的早期边界

Code
type Post = { title: string; slug: string; description: string; date: string; category: string; tags: string[]; };

重点并不是“永远不要用 CMS”。重点是等到内容形状真的值得被保存时,再去做那次迁移。

Big CMS migrations tend to arrive before the content model is ready for them. That is usually the wrong moment.

What keeps working

A small TypeScript layer gives me three things immediately:

  1. Typed routes
  2. Predictable lists
  3. Easy migration later

Why local first helps

Local content files make the structure visible. That means I can ask better questions before adding a larger system:

  • What content actually exists?
  • Which fields are stable?
  • Which routes need to be canonical?
  • What stays a draft?

A good early boundary

Code
type Post = { title: string; slug: string; description: string; date: string; category: string; tags: string[]; };

The point is not to avoid a CMS forever. The point is to wait until the shape is worth preserving.

相关工作Related work

和这篇笔记关联的项目与案例研究。Projects and case studies connected to this note.

项目Projects

AI 本地博客编辑器AI Local Blog Editor

一个面向技术写作的本地编辑与发布工作流,支持 AI 辅助起草与修订。A local editing workflow for drafting, revising, and publishing technical posts with AI assistance.

AI 系统ai-system
技术品牌系统Technical Brand System

一个面向案例、服务、写作与项目证明的可维护内容与作品集系统。A maintainable content and portfolio system for case studies, services, writing, and project proof.

产品product

案例研究Case studies

把静态索引改造成可维护的 AI 辅助发布工作流Turning a Static Index into a Maintainable AI-Assisted Publishing Workflow

一个无需先上 CMS、却能让笔记、来源与草稿输出保持对齐的发布系统。A publishing system that keeps notes, sources, and draft output aligned without forcing a CMS.

独立产品项目Independent product build
为建筑事务所打造更精致的作品集系统Building a Refined Portfolio System for Architecture Studios

一个以图片叙事为主、同时保持易维护的平静型作品集结构。A calm, image-led portfolio structure that still stays easy to maintain.

建筑事务所Architecture studio

相关文章Related posts

和这个主题相邻的更多笔记。More notes close to this topic.

把 KizunaIndex 做成公共索引之后,我学到的几件事Lessons from Building KizunaIndex as a Public Index

精选Featured
产品构建Product Building
2026年5月1日May 1, 20267 分钟阅读7 min read更新于 2026年5月3日Updated May 3, 2026

公共索引真正有用,往往不是因为页面多复杂,而是因为内容模型足够小、足够清楚、足够容易改。A public index gets more useful when the content model is small, explicit, and easy to revise.

nextjs
data-modeling
public-index
阅读全文Read article

用本地工具和云模型搭建个人 AI 工作台Building a Personal AI Workbench with Local Tools and Cloud Models

精选Featured
AI 工程AI Engineering
2026年5月8日May 8, 20268 分钟阅读8 min read更新于 2026年5月10日Updated May 10, 2026

一个实用的 AI 工作环境:能起草、测试和发布,又不会把流程缠在一起。A practical setup for drafting, testing, and shipping AI work without letting the workflow get tangled.

ai-agent
automation
codex
阅读全文Read article

为技术作品集网站设计真正有说服力的案例研究Designing Case Studies for Technical Portfolio Sites

精选Featured
产品构建Product Building
2026年5月5日May 5, 20266 分钟阅读6 min read更新于 2026年5月7日Updated May 7, 2026

怎样组织案例研究,才能证明判断力,而不只是展示结果。How to structure a case study so it proves judgment, not just output.

portfolio
case-study
writing
阅读全文Read article