我以为它上线了,部署记录里没有这个 commit
上午我打开自己那套分析后台,想看一眼前阵子做的 SEO 分析功能,翻了半天菜单没找到入口。
我的第一反应是「入口藏得太深」,或者「权限没开」。于是我问了一句:这个功能上线了吗?
答案是没有上线。更准确地说:它一次都没发出去过。代码在这台机器的本地工作区里躺着,没提交,自然也不在生产上。
我记住的是「我做过」,不是「它跑着」
这件事让我有点不舒服,不是因为功能没上,而是因为我居然会记错。
后来想明白了:我记的是设计它的那几个小时——阈值怎么定、导出要什么格式、哪些异常值得报警。这些我记得很清楚。但「推上去、构建过、在浏览器里点开过」这一步,我没有任何记忆,因为它没发生。
我确认的方式很简单:去看生产上到底跑的是哪个 commit。最近一次成功的部署停在 11 月 20 日晚上的 2f9fb0e8,那个版本里没有这些页面。本地工作区里有,生产上没有,中间断的就是「提交 + 发布 + 点一遍验证」这最后一段。
从那之后我给自己定了一条:判断一个功能发没发,只看部署记录里的 commit,不看本地代码里有什么、也不看我记得什么。记得是最不可靠的那一层证据。
发射前先看有没有会咬人的地方
决定当天就发。但在跑测试之前,我先让模型把新增的出站请求过了一遍,因为这次加的两个东西都会主动去抓别人的页面:页面审计会拉你自己站点的 HTML,通知会把摘要推到 Webhook。
查出来一个我看着挺别扭的地方:校验 DNS 和真正发请求是两次独立解析。也就是先查一次域名解析看它是不是内网地址,通过之后再交给 HTTP 客户端,而客户端会自己再解析一次。中间这段时间,答案可以变。
我没上什么复杂方案,就是让请求直接连到已经校验过的那个地址去,省掉第二次解析。这里能选的其实不少——可以引一个专门的防护库,也可以只在这一层做地址固定。我选了后者,理由是:这个改动能被测试完整覆盖,而引一个依赖会让我以后排查网络问题时多一个不知道从哪冒出来的变量。
10 条规则,不用 LLM,也不用第三方接口
这套东西最核心的部分不是页面,是一张判定表。我没有接任何 SEO 接口,也没有让模型替我下结论,全部基于本地已经同步好的搜索后台快照算,一共 10 条规则,每条给一个 0–100 的分数和一句能看懂的理由:
| 规则 | 触发条件(与上一周期比) |
|---|---|
| 展示涨、点击跌 | 展示在涨而点击在跌,先怀疑标题摘要 |
| 搜索词点击下跌 | 单条搜索词点击下跌 ≥ 10 |
| 页面点击下跌 | 单页点击下跌 ≥ 10 |
| 页面展示下跌 | 单页展示下跌 ≥ 500 |
| 站点单引擎下跌 | 点击 ≥ 10 或展示 ≥ 500 |
| 只有一家跌 | 一个引擎跌、另一个稳,先查单引擎的索引 |
| 两家一起跌 | 同时跌,怀疑全站层面出了问题 |
| 引擎没数据 | 某引擎已连但长期零流量 |
| 搜索与站内背离 | 搜索点击 ≥ 20 且没跌,站内访客却少 ≥ 20 人、跌幅 ≥ 30% |
| 页面自身有毛病 | HTTP 错误、noindex、软 404、缺 title/H1/canonical |
严重度按影响面给:点击变化 ≥ 20 或展示 ≥ 1000 算高,其余算中;分数权重是高 40、中 25、低 12,再按流量叠加。
为什么坚持不用模型来写结论?因为这些判断我半年后需要能复算。一条「这个词掉了 12 个点击」是我能自己回去对数字的;一句「这个页面表现不佳,建议优化内容」,我除了信它没别的办法。顺带一个细节:位次在这个系统里只作为证据附注出现,不参与任何判定。位次是曝光加权出来的均值,曝光结构一变它就会自己动,拿它当结论很容易自己吓自己。
数字
- 全量测试 4,225 项,外加 51 项 doctest,零失败、1 项跳过。
- 提交
49ae2031:45 个文件,+7,451 / −40。 - 生产切到这个 commit 后健康检查通过,我登录进去逐个点:关键词与页面异动、URL 索引检查、通知推送三个入口都可见可开,导出 Markdown 在生产上返回的是有效附件,进到单站详情能看到排障工具箱。
图里是这 7,451 行的去向。界面模板只有 313 行,其余大头在判定规则、审计和通知。这个比例比我预想的更偏「算」而不是「画」,也是这次唯一让我觉得钱花对的地方。
我放弃了什么
放弃了「每天把所有站点全量抓一遍」。 一开始想的是定时把每个站的页面都拉下来审,想着数据全一点总没错。真算了一下请求量和误报率就放弃了:站点一多,这条定时任务会变成一台小机器的主要负担,而它换来的多是「这个页面 title 有点长」这种不用天天看的东西。最后改成按需审计,外加一个「一键审计下跌页面」——只审那些已经在掉流量的页,把算力花在有嫌疑的地方。
放弃了让它替我判断排名。 上面说过,位次只当附注。少一个看起来很专业的「排名变化」指标,换来的是一条结论我永远能自己复核。
还欠半截
下午又加了一段:把这些结果也开给 MCP,传站点就查单站,不传就是当前 key 能看到的全部站点,报告结构和网页导出的一致;批量查索引状态一次最多 10 条,Sitemap 按站分页。回归 391 项,零失败、1 项跳过。
但到写这篇的时候,这部分还在本地没提交。我不打算在文章里把它写成已上线——按上午刚定的那条规矩,它没有出现在任何一次部署记录里,那就是没上线。