这份笔记对应本站当前的内容字段，目标是让一次修改既方便 Agent 执行，也方便读者理解。
先判断这次改动是什么
修正错字可以直接修改正文。如果结论、操作步骤或适用条件发生变化，就需要写明改了什么。完整重写成另一篇文章时，则要处理旧文章和新版的关系。
不要为了让首页看起来活跃而刷新日期。日期应该对应实际发生的内容变化。
对实质更新留下简短说明
下面是字段示例，并非一条已经发生的修订记录：
updatedDate: 2026-09-11
revisionNote: 补充草稿预览的适用范围，并纠正构建命令。说明应当足够具体。比起“优化内容”，读者更容易理解“补充了哪个前提、纠正了哪一步”。本站会检查更新时间不能早于发布时间，并要求修订说明同时提供日期。
整篇替代时保留旧地址
文件路径就是文章地址。直接把旧文件重命名，会让此前的收藏和引用失去目标。
更稳妥的做法是保留旧文件，在旧文中标记已经被新版替代，并填写新版文章的文件 ID。旧文仍然可读，页面会给出跳转入口。新的目标必须已经发布，不能形成互相替代的循环。
发布前确认读者的阅读路径
从旧文进入新版，再检查新版的系列目录、来源和相关文章。最后运行构建及回归测试，确认站内链接和草稿隔离没有被破坏。
这套约定的完整背景见让 Agent 维护博客：先把内容边界写清楚。如果发现本站内容需要修正，可以通过页面底部的纠错入口说明原文位置和依据。