我的本地写作流程：从空白文件到 push

这篇是示例文章，演示代码块、列表和长文的阅读体验。

三步

1. npm run new post "标题" —— 生成带完整 frontmatter 的文件
2. 写正文，npm run dev 实时预览
3. git push —— 剩下的交给托管平台

第 1 步是刻意设计的。手写 frontmatter 一定会漏字段，漏了 summary 列表页就是空的，漏了 categories 文章就没有入口。让脚本替你填。

# 生成一篇文章
npm run new post "什么样的笔记值得写下来"

# 生成小说新章节（自动取下一个章号）
npm run new novel "灯塔"

为什么不用网页后台

用过一段时间 Sveltia CMS。它确实能让我在 iPad 上发文，但代价是：多一个要维护的组件、一套和 Zod schema 平行的字段定义、以及一个 OAuth 代理。

后来我发现自己 95% 的时间都在电脑前。剩下那 5%，在 GitHub 仓库页按一下 .，用 github.dev 改 Markdown 就够了——它不需要任何额外的东西。

一条经验

工具链的复杂度应该和实际需求匹配，而不是和「可能会有的需求」匹配。

先上线一个能发文的版本，比先搭一套完美的发布系统重要得多。