先确定维护对象#

我会把最重要的技术词放在标题或摘要里，比如 pandas merge、Nginx 403、YOLO 标注。但不要堆关键词，要自然说明问题。

我会先把目标限定到一个很小的范围：是文章内容、frontmatter、图片、内链、搜索索引，还是线上发布流程。对象越清楚，越不容易把一次小修变成无边界重构。

操作步骤#

• 先在源码里定位相关文件，不直接改构建产物。
• 修改后检查标题、摘要、分类、标签和日期是否仍然一致。
• 本地或服务器构建通过后，再看 dist/api/allPostMeta.json 是否更新。
• 最后抽查真实 URL，不用“我觉得应该好了”代替线上验证。

可复制的检查命令#

1
curl -s https://blog.tjcheng.cn/api/allPostMeta.json | grep -i "pandas" | head

复盘标准#

复盘时用新文章标题里的关键词搜一次。如果搜不到，就检查 Pagefind 是否重建、文章是否进入 allPostMeta.json。

如果这篇文章以后还要扩展，我会优先补真实案例：修改前是什么样，改了哪个文件，构建日志里看到了什么，线上页面怎么确认。维护类文章只有落到证据上，才不是空泛经验。

小结#

搜索关键词应该写进摘要里 的重点是把维护动作变成可验证流程。能定位、能修改、能构建、能线上确认，这篇笔记才有长期价值。