自动发文章到多个平台:五种「发布成功」其实没生效

更多内容请访问我的个人网站

封面

读者是谁

这篇写给「内容或构建产物要同步到多个地方」的 AI 流水线:流水线的脚本在多处写入,每处都返回成功,但用户看到的结果并不对。下面这张表按角色列出各智能体能带走什么、从哪一节开始读。

读者 带走什么 拿它做什么 从哪节开始读
写发布脚本的开发者 五个「成功信号 → 替换判据」的对照 逐个替换自己脚本里的成功判断 本文讲什么
要同步内容到第三方平台的 AI 读登录态、判草稿、改绝对链接的代码 直接改成自己平台的接口 信号一到信号五
被「缓存没更新」坑过的 AI 文件名带内容哈希的做法 给自己的静态资源加版本后缀 信号五

不适合谁:只发布到一个平台、且发布后靠人工逐篇检查的读者——这篇讨论的是「怎么让脚本自己判断对不对」。

约 9 分钟读完;需要会 Node 与浏览器开发者工具;没做过自动发布也能跟。

本文讲什么

一条发布链上,每个环节都会给出一个「成功」信号。麻烦在于这五个信号都是间接的:它们证明「某一步执行完了」,不证明「读者能看到正确结果」。

下面这张表是本文的主线。左边是环节,中间是它默认会说的「成功」,右边是本文要换上的判据。

环节 默认的成功信号 换成什么判据
提交到平台 浏览器跳回了文章页 最终地址不能是编辑页
登录第三方平台 cookie 里有值 通过浏览器调试接口读 HttpOnly cookie
定时发布 命令退出码 0 先抢锁,拿不到锁就直接退出
站外分发 正文写完了 所有站内链接改成绝对地址
静态资源更新 文件名没变、上传成功 文件名带内容哈希;线上字节等于本地字节

先准备环境

需要 Node 18 以上(脚本用到全局 fetch 和 node:crypto),以及一个已登录目标平台的浏览器。平台自动化用 Chrome DevTools Protocol,让浏览器带调试端口启动即可,不需要额外安装库。

发布流程整体怎么跑

先给全貌:一次发布只有九步,后面每一节展开其中一步的判据。下面这段伪代码(从取文章到给出退出码)就是整条链。

1 │ 取待发文章  → 读标题、正文、封面
2 │ 抢锁        → 拿不到锁就退出,避免两个进程同时发
3 │ 改写链接    → 站内相对地址改成绝对地址
4 │ 逐平台发送  → 自有站 / 博客园 / 知乎,各自用自己的身份
5 │ 判成功      → 看最终地址是不是已发布页,不是就记失败
6 │ 校验        → 下载线上内容,与本地文件逐字节比较
7 │ 封面        → 按标题渲染,文件名带内容哈希
8 │ 记录        → 每个平台单独记结果,一个失败不影响其他平台继续
9 │ 退出码      → 任一平台失败 → 非 0,交给上层告警

背景:一条链上有五个环节

要理解为什么每一步都要单独判,先看链路。下面这张图把一篇文章从仓库到读者的五个环节画出来:

文章 Markdown
   │
   ├─ 构建自有站 → 上传静态文件 → CDN 缓存 → 读者
   ├─ 复制到博客园 → 平台发布接口 → 平台页面
   └─ 复制到知乎   → 浏览器自动化 → 文章编辑页/文章页

任何一环「报成功」都不代表下一环拿到了正确输入

每一环都可能出现同一种失败:执行成功,结果错误。下面五个信号就是五处真实的误判。

信号一:平台跳回了文章页

最早判断知乎发布成功,用的是「发布后当前地址变成了文章地址」。实际上,保存草稿也会跳转,而且跳转后的地址带着 /edit 后缀——它仍然是编辑页。

所以判据不是「有没有跳转」,而是「最终地址像不像一篇已发布的文章」。下面这段代码把它写成布尔值:

// 发布前:先去掉编辑页后缀,作为文章地址
const baseUrl = (existing?.url || '').replace(/\/edit\/?$/, '');
// 发布后:拿到最终地址,如果还是编辑页,就判失败
function isPublished(finalUrl) {
  if (!finalUrl) return false;
  return !/\/edit\/?$/i.test(finalUrl);
}

这段代码(把「最终地址是否还是编辑页」变成布尔值)解决的是假成功里最常见的一种:中间状态被当成了终态。

同类情况还有「队列里排上了」被当成「已经发布」、「返回 200」被当成「内容已更新」。判断的落点都应该在终态上,而不是在中间动作上。

信号二:登录检测说没登录

第二个坑更隐蔽:检查逻辑本身永远返回「未登录」。

原因是登录票据放在了 HttpOnly cookie 里。HttpOnly 是浏览器的一个安全标记:带这个标记的 cookie,页面里的 JavaScript 读不到,只有发请求时浏览器会自动带上——它的作用是防脚本偷票据。

页面脚本读不到,检测就永远为空。原来的代码用 document.cookie 找票据,结果恒为假;更糟的是它不会报错,只会安静地走「未登录」分支。

正确做法是绕开页面脚本,从浏览器调试接口读。下面这段代码读浏览器里的真实 cookie 列表:

// 通过 Chrome DevTools Protocol 的 Network.getCookies 读当前浏览器的真实 cookie
const { cookies } = await cdp.send('Network.getCookies', { urls: [platformUrl] });
const loggedIn = cookies.some((c) => c.name === 'z_c0' && c.value);

if (!loggedIn) {
  console.error('[publish] 未登录:请先在浏览器里登录一次');
  process.exit(2);          // 明确失败,不要继续跑
}

这段代码(读浏览器的真实 cookie 列表,判断登录票据在不在)说明一个原则:判断一个状态,要去状态的权威来源读,不要读它可能被裁剪后的副本。

信号三:同一个页面被发了两遍

发布是定时任务,也可能被手动触发。两个进程同时跑,会出现重复文章、重复封面、重复提交。

修法是让发布开始前先抢一个锁文件。下面这段代码用独占创建实现互斥:

import fs from 'node:fs';

const LOCK = '.publish.lock';

export function acquireLock() {
  try {
    const fd = fs.openSync(LOCK, 'wx');       // wx:文件已存在就失败,天然互斥
    fs.writeSync(fd, String(process.pid));
    fs.closeSync(fd);
    return true;
  } catch {
    return false;                              // 拿不到锁,直接退出
  }
}

export function releaseLock() {
  try { fs.unlinkSync(LOCK); } catch {}
}

这段代码(用「以独占方式创建文件」实现进程互斥)的关键是 wx:创建和检查是同一个原子操作,不会出现「两个进程都判断没有锁、然后都创建」的竞态。

锁还要处理进程崩溃留下的死锁——文件在、进程没了。实用做法是锁里写进程号,启动时检查该进程是否还活着,不活就删锁重抢。

信号四:站外链接打不开

文章里的链接原本是站内相对路径,例如 /blog/2026-11-17-测试全绿功能却是坏的。在自有站点里它没问题;复制到博客园、知乎之后,它会被解析成对方站点的路径,读者点开是 404。

修法是在分发前把所有站内链接改写成绝对地址。下面这段代码就是改写函数:

const SITE = 'https://example.com';

function absolutize(markdown) {
  // 只改以 / 开头的站内路径,不动 http(s)、mailto、锚点
  return markdown.replace(/\]\((\/(?!\/)[^)]*)\)/g, (_m, p) => `](${SITE}${p})`);
}

这段代码(把 Markdown 里的站内路径补成完整地址)跑完之后,正文里的链接在任何平台上都能点开。

判断有没有改全,不靠肉眼:发布脚本先跑一次只检查不写入的模式,输出三个计数——总链接数、站内链接数、改写后仍以 / 开头的数量。最后一个必须是 0。

信号五:同一个地址还是旧内容

静态资源上传成功,但读者拿到的还是旧文件。原因不是上传失败,而是 CDN 缓存:内容分发网络会把文件缓存在离读者最近的节点上,同一个地址在缓存过期前一直返回旧字节。

「上传成功」证明文件到了源站,不证明读者拿到了新文件。修法是让地址跟着内容变。下面这段代码就是一个例子:

import crypto from 'node:crypto';

function coverFileName(slug, pngBuffer) {
  const hash = crypto.createHash('md5').update(pngBuffer).digest('hex').slice(0, 8);
  return `${slug}-${hash}.png`;      // 内容变 → 文件名变 → 缓存必然失效
}

这段代码(用图片内容的摘要生成文件名后缀)把「刷新缓存」变成「换一个没人缓存过的地址」。生成新文件后要顺手删掉同一篇文章旧哈希的封面,否则目录会越堆越多。

同样的思路适用于脚本和样式:构建产物名带内容哈希,就不需要去猜缓存什么时候过期。

封面本身也不需要手工做:发布脚本按固定版式渲染一张图,图的内容由标题决定。这里有一个小分支值得保留——在测试环境里跳过封面生成,否则每跑一次测试就多出一批图片,还会把发布目录弄脏。

还有一条:线上字节必须等于本地字节

前面五条都在各自环节内部判断。最后一层是端到端对照:发布完成后,把线上地址的内容下载回来,和本地文件逐字节比较。下面这段代码就是这一步:

const local = fs.readFileSync(localPath);
const remote = Buffer.from(await (await fetch(publicUrl)).arrayBuffer());
if (remote.length !== local.length || !remote.equals(local)) {
  throw new Error(`线上内容与本地不一致: ${publicUrl}`);
}

这段代码(下载线上文件并与本地逐字节比较)比「部署命令退出 0」强一个数量级:退出码只覆盖上传这一步,字节比较覆盖上传、缓存、域名解析全链路。

一个实际细节:某些平台会对文本做压缩或改写,逐字节比较会误报。这时先比解压后的内容长度,再比摘要;判据可以换,但「必须比内容」这一条不能换。

这一路上的坑

下面这张表是发布链上最容易误判的六处,按「现象 → 成因 → 解法 → 为什么有效」四列写:

坑是什么 为什么是坑 如何解决 为什么能解决
平台跳回编辑页仍算成功 编辑页等于草稿 用最终地址判失败 已发布文章没有编辑段
页面读不到登录 cookie 检测永远返回未登录 从浏览器调试接口读 HttpOnly 只挡页面脚本,不挡调试接口
两个进程同时发布 同一篇被发两遍 独占创建锁文件 第二个进程拿不到锁就退出
相对链接在第三方站失效 宿主域名不同 分发改写成绝对地址 地址不再依赖宿主
同一 URL 返回旧图 CDN 按 URL 缓存 文件名带内容哈希 内容变则地址变
上传成功不等于读者能打开 只验证了链条中间一步 下载回来与本文件逐字节比 端到端对照

验证与判据

五个信号对应的验收方式见下面这张表。判定标准是「每条都能给出一个明确的通过或不通过」,而不是「看起来没问题」。

判据 通过 不通过
最终地址 不以 /edit 结尾 仍是编辑页
登录检测 能从浏览器 cookie 列表读到票据 读页面 cookie,恒为空
并发保护 第二个进程启动后立刻退出,退出码非 0 两个进程都开始上传
链接改写 改写后仍以 / 开头的链接数为 0 大于 0
缓存更新 新文件名与旧文件名不同,旧文件已删 同名覆盖
内容一致 线上字节长度与摘要都和本地一致 任一不等

跑法上,先跑「只检查不写入」的模式,把六个判据全过一遍,再真正发布。六个里有任何一个不通过,就不要让命令继续往下走。

总结

发布链上的「成功」假信号有五种:平台跳回文章页不代表发出去了、登录检测说没登录可能是检测本身失效、同一页面发两遍是幂等缺失、站外链接打不开是链接没改写、地址对但内容旧是缓存没刷——外加一条兜底判据:线上字节必须等于本地字节。五种信号的共同根子是脚本只相信自己这一环节返回的 ok,没有验证读者实际看到的结果。替换办法:把每个 exit code === 0 换成面向读者结果的检查(状态码、内容哈希、字节对比),任何一条对不上就不算发布成功。

还能怎么改进

这套判据现在有两处边界。

一是只覆盖已知平台。每接一个新平台,登录态、草稿判据、链接规则都要重新摸一遍。下一步可以把「平台适配」抽成三个固定问题:登录态从哪读、终态地址长什么样、正文要做哪些改写,接平台时只填这三项。

二是字节比较对动态内容不适用。页面里如果嵌了时间戳、随机推荐位,逐字节比较永远失败。下一步可以对这类页面改成「关键区块比较」:只比正文容器和标题的文本,不比整页。

你下一步能做什么

让代码智能体打开你现在用的发布脚本,找出里面第一处 if (ok) 或 exit code === 0,追问一句:这个「ok」是哪个环节给的、它能不能证明读者看到的结果正确。把答案写进注释,再从本文五个判据里挑一个替换掉它。

这些内容来自哪里

这些内容来自一个持续运行的自动化发布流程:同一批文章每天同步到自有站点和两个第三方内容平台,三周内反复遇到「脚本说成功、页面是错的」。五个判据都是先把错误发出去、再回头把判断改严的产物,其中登录检测和草稿判据各自被线上文章抓到过一次;最后的字节比较是端到端验证,用来覆盖前面几层看不出的问题。

相关文章

posted @ 2026-11-19 14:08  杨元超  阅读(2)  评论(0)    收藏  举报