Hugo

今天的执行回顾 13:00-14:30 核心深度任务：写作 今天按 cron-afternoon-execution 技能执行了下午执行块： 13:00-14:30（90min）：完成了一篇博客文章的撰写与发布流程 14:30-14:40：站立休息、喝水、远眺 14:40-16:00：流程化执行——构建、部署、验证 16:00-16:10：第二次 10min 休息 16:10-17:00：SOP 完善与复盘，更新了对应文档 14:40-16:00 流程化执行：构建与部署 按 Hugo 部署 SOP 执行了完整流程： hugo --gc --minify — 本地构建无错误 验证 baseURL = "https://ningop.com" — 未检测到 localhost 字样 wrangler pages deploy public/ --project-name=ningop-blog --branch=main --commit-dirty=true — 部署成功 多站点验证： 部署 URL：HTTP/2 200 ✓ 别名 URL：HTTP/2 200（首次 522 已过，edge propagation 完成） 自定义域 ningop.com：HTTP/2 200 ✓ 16:10-17:00 SOP 完善/复盘 将今天跑通的流程写成/update 了 SOP 文档。关键点记录： 原子部署：一次性完成 hugo --gc --minify + wrangler pages deploy，避免中间状态泄漏自定义域/CFG baseURL 不匹配 baseURL 检查：部署前 grep -rq 'localhost' public/ 必须 abort；确认 hugo.toml baseURL = "https://ningop.com" 部署后验证：优先验证 deployment URL（即时 200），再等 10-30s 验证自定义域（可能出现单次 522，属正常边缘传播） future date 陷阱：article date 必须 ≤ build机器当下的北京时间；若使用 date: YYYY-MM-DD 纯日期更稳健 frontmatter 统一：全站统一 YAML --- 格式，禁止 +++ TOML残留，否则 PaperMod 列表会静默跳过 hero 图位置： 必须紧接在 YAML --- 闭合后、第一个 ## 之前；错误位置会在文章内部渲染而非页头 日期归档问题：date 过老（如 2025-06）会沉到首页最底部 PaperMod 翻页之外；如需保持页首可见，建议 date 设为今日或适当适当 weight 微调 检查清单 & 下一步 检查项 状态 备注 文章路径 content/posts/ ✅ 非 blogs/ date 不超前 ✅ 2026-09-01 北京时间 Frontmatter YAML --- ✅ 无 +++残留 Hero 图在 --- 与第一个 ## 之间 ✅ 已验证渲染位置 baseURL = "https://ningop.com" ✅ 部署前确认 wrangler pages deploy 成功 ✅ 项目 ningop-blog 三站点验证通过 ✅ ningop.com / www.ningop.com / hugo.ningop.com 下一步：继续下一篇系列文章的写作，或根据需要在 content/posts/ 下创建新草稿。下一次 cron-afternoon-execution 块将在明天 13:00 触发。 ...

如果你已经第三次教 AI 同样的事情，问题可能不在 AI，而在工作流本身。 一、那些反复出现的「低级错误」 和 AI 助手协作写博客一段时间后，我开始注意到一个规律：同样的 bug 会以不同的面貌反复出现。 第一次是 +++ 残留在 YAML frontmatter 之后，导致 Hugo 解析失败，文章虽然能访问但首页根本看不到它。第二次是配图位置放错——AI 把 ![featured] 放在了二级标题下面，而不是文章开头。第三次是日期设成了未来，Hugo 直接跳过不生成。 每次修复完，我都以为「这次总该记住了」。但下一次，类似的问题又以新的形式出现。 这不是 AI 变笨了。这是流程的脆弱性在反复暴露。 二、7 个反复踩坑的具体场景 1. Frontmatter 格式混乱：YAML 与 TOML 混用 Hugo 支持 YAML (---)、TOML (+++) 和 JSON 三种 frontmatter。但如果一个项目里大部分文章用 YAML，突然插入一篇 TOML，PaperMod 的列表逻辑可能会跳过它——不是报错，就是安静地不显示。 2. +++ 残留：最隐蔽的错误 把 TOML 转成 YAML 时，如果前面的 --- 忘记删掉，或者后面跟着一串 +++，Hugo 不会报错。文章能 build，URL 能访问，但首页和分类列表里永远找不到它。hugo list all 显示正常，但 index.html 的 post-entry 列表里没有。 ...