09 下一步:博客之后的四条路线
结论
这个系列只解决一件事:把博客部分讲清楚、跑起来。到这里,你应该能回答:
- 内容放在哪里,frontmatter 有哪些约束;
- Markdown 怎样经过校验、过滤和聚合变成 JSON;
- Nitro 接口怎样返回列表、详情、图片、RSS 和 sitemap;
- 页面怎样取数据、筛选标签、渲染正文;
- 样式和主题怎样分层,构建和镜像怎样生成。
再往下走,不再按「从零到一」的时间顺序,而按问题类型分流:
| 你想解决 | 去哪个系列 | 先读什么 |
|---|---|---|
| 聊天界面、SSE 解析、同源代理 | 搭建AI助手前端 | 01 需求 → 02 协议 → 03 解析 → 04 状态 → 07 代理 |
| RAG 服务、pgvector、LangGraph | AI助手后端实现 | 01 项目地图 → 03 配置 → 05 切片 → 07 检索 |
| 设计系统、部署、CI、无障碍细节 | 构建实践 | 01 设计 → 05 部署 → 07 CI → 10 无障碍 |
| 首屏性能、字体图片、AI 回答质量 | 如何优化 | 01 Lighthouse → 02 字体图片 → 03 AI 调优 |
问题与设计
为什么把 AI 拆出去
博客和 AI 助手是两条故障域不同的链路:
- 博客是只读内容,失败时页面 404 或构建失败,影响面清楚;
- AI 需要外部模型、向量检索和流式连接,延迟、成本和错误类型都不同;
- AI 接口目前没有鉴权、配额和限流,生产默认关闭;
- 前端聊天界面涉及 SSE 解析、会话状态和中断恢复,不适合塞进博客的实现路径里。
所以这个系列只讲博客。AI 前端和后端各自成系列,需要时再进入。这样读者不会在「只想跑一个博客」时被迫安装 Python、Postgres 和模型配置。
推荐顺序
如果目标是完整理解这个项目:
- 先读完本系列 01–08,确认博客能本地运行、能构建;
- 进入 搭建AI助手前端,理解浏览器怎样消费流式响应;
- 进入 AI助手后端实现,理解检索和生成;
- 回头看 构建实践,补部署、CI 和无障碍;
- 最后进入 如何优化,用测量而不是感觉做优化。
如果目标只是上线博客:
关键代码
继续之前,先把博客的质量门跑一遍:
cd frontend
npm run content:validate
npm run lint
npm run typecheck
npm run test
npm run build
如果准备改页面或样式,再补:
npm run lint:styles
npm run format:check
如果准备进入 AI 系列,先确认博客本身没有回归;AI 是可选链路,不应该让博客的构建依赖它。
验证
判断自己是否读懂,不看「看过」,看能不能回答具体问题:
- 为什么笔记的 slug 来自文件名,而长文的 slug 来自 frontmatter?
- 为什么日期要用
JSON_SCHEMA解析,而不是直接交给 YAML? - 为什么图片路径要在 Markdown 渲染时改写,而不是在页面里拼?
- 为什么标签筛选放在 URL 查询参数里,而不是组件内部状态?
- 为什么颜色用 CSS 自定义属性,而间距用 SCSS 变量?
- 为什么内容打进镜像,而不是运行时挂载?
能用自己的话回答,并能在仓库里指出对应文件,才算真正读懂。
边界
- 四条路线不是课程表,不需要按顺序全部读完;按当前问题跳读更有效。
- 系列之间共享代码和内容,但概念不重复解释;遇到不熟的术语,回到对应系列的基础篇。
- 站点仍在演进,已实现能力和计划项分开写;不要把这个仓库当成「所有功能都已上线」的成品。
- AI 接口目前没有鉴权、配额和限流,生产默认关闭;本地实验不等于可以公开部署。
- 性能结论依赖模型、内容分布、网络和硬件;不要照抄某次测量的分数。
博客部分到这里结束。接下来从 构建实践 继续,或者直接进入最关心的那一层。