项目 · 工作记录
WordPress / Martech 排障与程序化改站
把「后台显示已保存但线上不对」这类隐性故障,变成可复现、可停止、可验证的检查流程,并用自建插件让 Agent 能安全地程序化改站。
01 / 问题
Martech 的故障通常没有报错。文章发布了但 SEO 字段没同步;Schema 在后台存在却和模板重复输出;GTM 工作区改对了但没发布;sitemap 停在上个月。
如果 Agent 只相信界面上的「已保存」,它会非常稳定地制造假完成。
02 / 系统
案例:文章发布后 sitemap 不更新。 这是一次完整的四段式排障:
| 阶段 | 内容 |
|---|---|
| 症状 | 通过 REST 发布的文章,线上 sitemap 长时间不出现,站长工具也抓不到;后台手动保存一次却会立刻正常。 |
| 追踪 | 顺着「谁负责重建 sitemap」查:SEO 插件的缓存重建只挂在后台保存动作和 cron 上,REST 发文这条路径根本不经过那两个钩子,所以缓存永远是旧的。 |
| 修复 | 自写一个小插件,在 REST 发文完成后主动触发 sitemap 重建,并校验新 slug 确实进入了索引文件。 |
| 验证 | 发一篇测试文 → 拉取线上 sitemap 核对 slug 与 lastmod → 站长工具复查。之后沉淀成发布后的固定检查项。 |
修复插件的核心就是补上那个从来没被触发的钩子,并且当场回读验证:
// 根因:SEO 插件的 sitemap 缓存监听只在后台 / cron 上下文挂载,
// 通过 REST 发文不会触发失效。修复:REST 写入后主动重建并校验。
add_action('rest_after_insert_post', function ($post) {
if ($post->post_status !== 'publish') return;
do_action('my_rebuild_sitemap'); // 调用插件的重建入口
my_verify_slug_in_sitemap($post->post_name); // 立刻回读 sitemap,找不到就记日志并告警
}, 10, 1);
简化示意,字段与真实协议一致,已去掉品牌与内部路径。
REST 桥接插件。 为了让 Agent 能改站又不误触,我把需要程序化操作的东西做成显式接口:SEO 标题 / 描述 / canonical 等字段、301 跳转规则、多语言镜像文案的写入与读取。这样改站动作是幂等的、可 diff 的、可回滚的,也不需要让自动化去点后台的按钮。
「UI 显示已保存 ≠ 真的对」的四层交叉验证:
- API 层
直接读回写入的字段,确认存的是我以为的值,而不是被另一个插件覆盖后的值。
- 页面源码层
抓线上 HTML,确认模板真的输出了它,并且没有重复输出两份 Schema 或两个 canonical。
- 第三方检测层
用结构化数据校验与站长工具确认外部解析结果,而不是自己看自己。
- 事件回传层
对邮件、电话、消息类点击事件,做一次真实点击,确认数据落到分析后台。
浏览器自动化没有「看到按钮就点」的授权。遇到未发布的工作区变更、来源不明的配置、或者可能影响线上数据的状态,流程必须停下,把决定交回给人。
03 / 我的角色
我负责把模糊的「SEO 好像不对」「数据怎么没进来」,拆成能逐层验证的系统状态:hook、字段同步、模板、缓存、标签、事件链。然后把一次排障沉淀成后续 Agent 可以直接复用的检查清单,而不是每次重新猜。
04 / 结果
实际修复过标题层级、SEO 标题截断、sitemap 新鲜度、重复 Schema 等问题,也完成过多类联系方式点击事件的跟踪配置。自建插件通道让批量页面改动可以程序化进行,这是产品上架流水线能跑起来的前提。
公开版本不展示域名、后台截图或账户数据。
05 / 证据
- sitemap 根因复盘的完整四段式
- 停止条件与跨层验证方法(本页上半部分)
- 依赖这条通道的上架流水线