跳到主要内容
Ed. notes

09 下一步:博客之后的四条路线

长文 · 2026-11-12 · 合集第 10 / 10 篇

  • 阅读路线
  • 构建日志
  • 工程化
  • AI
第 10 / 10 篇 · 查看全部章节 → 当前: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 和模型配置。

推荐顺序

如果目标是完整理解这个项目:

  1. 先读完本系列 01–08,确认博客能本地运行、能构建;
  2. 进入 搭建AI助手前端,理解浏览器怎样消费流式响应;
  3. 进入 AI助手后端实现,理解检索和生成;
  4. 回头看 构建实践,补部署、CI 和无障碍;
  5. 最后进入 如何优化,用测量而不是感觉做优化。

如果目标只是上线博客:

  1. 本系列 03–08;
  2. 构建实践 的部署和 CI 篇;
  3. 如何优化 的前端性能两篇。

关键代码

继续之前,先把博客的质量门跑一遍:

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 接口目前没有鉴权、配额和限流,生产默认关闭;本地实验不等于可以公开部署。
  • 性能结论依赖模型、内容分布、网络和硬件;不要照抄某次测量的分数。

博客部分到这里结束。接下来从 构建实践 继续,或者直接进入最关心的那一层。