维护记录

完成的工作

  • 拉取 origin/master 的 18 个新提交（fast-forward），并同步 PaperMod 子模块到 v8.0-139 ✅
  • 创建新文章 content/posts/20260817[05hog4].md（标题「文章的变化」），作者口述风格，半角逗号占位符写法，参考近期 20260807[01jma3].md 的日志类 frontmatter ✅
  • 用 rename-posts.js 由 body 算出 hash 并重命名占位文件为 20260817[05hog4].md ✅
  • 用 gen-covers.js --files ... --force 生成封面 static/images/covers/20260817[05hog4].svg（teal / patternConcentric）✅
  • 手动修正 front matter 中 cover.image 引用（rename-posts 不会同步更新 cover 路径，这是已知 bug）⚠️
  • hugo --minify 构建通过，新页面 public/posts/2026081705hog4/ 正常生成，封面路径正确解析 ✅
  • 更新 content/claudelog/2026-08-17.md ✅

遇到的问题

  • gen-covers.js --files 接受相对路径时会被脚本拼接成 content/posts/content/posts/...，必须传 basename（不带 content/posts/ 前缀） ⚠️ - 已规避
  • rename-posts.js 在重命名占位文件后不会同步更新 front matter 里的 cover.image 路径 ⚠️ - 已手动修正；建议下次让用户或脚本执行后立即检查 front matter 完整性

下次建议

  • 可以考虑给 rename-posts.js 加一个 --sync-cover-fm 开关，自动同步 cover.image 引用，避免遗漏
1raw=$(hashed-slug)
2old="images/covers/<oldSlug>.svg"
3new="images/covers/<newSlug>.svg"
4raw.replace(old, new)