Blogger 集成测试：面向可验证发布的实施清单
一个 Blogger 集成测试：实施清单只有在它能证明线上发布结果时才有用，而不仅仅是证明 API 调用成功。正确的通过条件是一个源 URL 能返回 200，使用预期的封面和元数据，保持可被索引，并留下足够的证据，便于另一位操作员重放发布流程。
这个版本面向那些需要一份实施清单的团队，他们可以把这份清单运行在真实的 Blogger 驱动工作流上：创建源草稿、发布它、验证公开路由、生成已配置的翻译，并记录监控路径。本文将发布视为一份发布契约，而不是一次性的 CMS 操作。
当代理、脚本或 CI 任务负责发布路径，而团队需要一个持久的源公开 URL 供搜索、分析和发布 QA 使用时，请使用这份清单。
这个 Blogger 集成测试：实施清单必须证明什么
工作流应回答四个问题：
| 问题 | 通过条件 | 需要保存的证据 |
|---|---|---|
| 源文章是否已发布？ | 源文章以最终 slug、标题、分类和封面 URL 发布 | 创建载荷、创建响应、发布响应 |
| 公开路由是否有效？ | 源 URL 返回 200，与预期标题/正文匹配，且没有 noindex 指令 | 响应头、HTML 回读、canonical 检查 |
| 本地化是否运行？ | 每个已配置的目标语言都有已发布文章和可用路由 | 翻译目标文件、载荷、响应、路由检查 |
| 团队之后能否度量结果？ | 记录了 GSC URL、GA4 路径、CTA 路径和发布时间戳 | 发布报告和度量说明 |
这避免了最常见的误判：API 接受了请求，但公开页面是过期的、缺失的，或者被阻止了。
门禁 1：冻结发布输入
在任何写入之前，先冻结定义发布标识的字段。
| 输入 | 所需值 |
|---|---|
| 站点 URL | https://tokentest.io |
| 站点 ID | 运行时中的当前 Blogger 站点 ID |
| 源语言 | 已配置的源语言，通常为 en |
| 目标语言 | 排除源语言后的站点配置语言键 |
| 分类 | 实时分类端点值，而不是凭记忆猜测 |
| Slug | 小写、连字符化、最终且唯一 |
| 规范 URL | 由生产站点 URL 和最终源 slug 构建 |
| 作者 | 稳定的公开署名 |
在本次运行中，slug 为 blogger-integration-test-implementation-checklist-13-3。这个后缀使发布可追踪，并将其与之前的清单文章区分开来。
门禁 2：验证文章包
文章包是内容生成与 Blogger 之间的契约。
| 工件 | 检查项 |
|---|---|
| Markdown 正文 | 仅面向客户的文章，不包含内部备注 |
| HTML 正文 | 与 Markdown 含义一致，且没有重复的页面级 H1 |
| Meta 标题 | 自然包含主关键词 |
| Meta 描述 | 说明实施价值并包含主关键词 |
| 摘要 | 简洁且针对该清单 |
| 内部链接 | 指向可用的 TokenTest 指南 |
| 外部链接 | 技术性说明使用稳定的官方来源 |
| CTA | 为开发者提供一个实际的下一步 |
对于 Blogger 集成测试：实施清单，HTML 正文应保持在页面标题级别以下。重复的 H1 会让路由 QA 变得杂乱，并可能削弱渲染后的页面结构。
这份清单还应避免流程信息泄露：不要包含机密、审阅者问题、私有 API 响应以及任务看板元数据。
Gate 3: 上传封面并证明 URL 一致性
不要把本地图片路径放进文章载荷中。请先上传封面，并复用返回的公共 URL。
| 封面检查 | 通过条件 |
|---|---|
| 具体性 | 该图片专为本文制作，而非重复使用 |
| 文件有效性 | 文件可作为图片打开，且不是空文件 |
| 公共上传 | 上传 API 返回一个公共资源 URL |
| 载荷使用 | cover_image_url 等于已上传的 URL |
| 本地化一致性 | 源文和本地化文章使用相同的封面 URL |
| 替代文本 | 包含一次主关键词，并描述视觉内容 |
封面应展示发布流水线、路由验证、翻译以及证据采集。这样读者和审阅者就能清楚理解其目的。
Gate 4: 使用有边界的重试规则创建源草稿
保存请求体和原始响应。如果创建失败，只能使用相同的 slug 和相同的发布标识重试。
If create returns a post ID, store it and publish that exact post.
If create returns validation errors, fix only the rejected fields and retry the same slug.
If create times out, check whether the slug already exists before creating another draft.
If a retry would change slug, category, language, or canonical URL, stop and record a recovery note.Blogger 集成测试：实施清单应防止公开页面重复，而不是把它们隐藏在重试循环后面。
Gate 5: 发布源内容并验证公共路由
只有当公共源路由通过读回验证后，发布才算完成。
| 路由信号 | 预期结果 |
|---|---|
| HTTP 状态 | 200 |
| 重定向次数 | 没有意外重定向 |
| 最终 URL | 与预期的源 slug 匹配 |
| 标题文本 | 与已发布文章标题匹配 |
| 已知正文句子 | 出现在 HTML 回读中 |
| Canonical | 自引用的源 URL |
| Robots meta | 没有 noindex 指令 |
X-Robots-Tag | 没有 noindex 指令 |
| 封面图像 | 页面或 API 回读中出现公开上传的封面 URL |
Google Search Central 将 noindex 记录为一种可能阻止页面出现在搜索结果中的指令。这就是为什么路由检查需要同时检查 HTML 和响应头。
门槛 6：一次本地化一个目标语言
如果站点已配置目标语言，本地化就是发布流程的一部分。
{
"source_language": "en",
"target_languages": ["zh"],
"source": "SEO_BLOGGER_LANGUAGE_KEYS"
}每次请求只生成并发布一种目标语言。对于每种语言，保存载荷、原始响应、API 回读以及本地化路由检查。如果中文成功了，但路由仍然是 404，则应报告部分发布，而不是误报成功。
门槛 7：记录可测量性就绪状态
一个 SEO 发布工作流只有在团队知道稍后去哪里查看结果时，才算完整。
| 测量字段 | 示例 |
|---|---|
| 源公开 URL | https://tokentest.io/blog/{slug} |
| GSC 检查 URL | 相同的源公开 URL |
| GA4 路径 | /blog/{slug} |
| 本地化路径 | /zh/blog/{slug} |
| CTA 目标 | TokenTest 评估或提示预算工作流 |
| 后续指标 | 点击、展示次数、参与会话、转化 |
不要在上线当天编造表现数据。如果无法访问 GSC 或 GA4，请明确记录这一缺口。
门槛 8：保留 token 预算证据
AI 辅助发布可以是正确的，但仍可能变得过于昂贵。
| 步骤 | 预算信号 |
|---|---|
| 锚定 | 源文件数量和总上下文大小 |
| 起草 | 输入 token、输出 token、重试次数 |
| 翻译 | 每种语言的 token 使用量和重试次数 |
| QA | 公开回读和验证调用 |
| 恢复 | 重试是否会重新发送整篇文章上下文 |
这正是 TokenTest 适合这个工作流的地方：一次发布在技术上可以有效，但仍可能未能通过其预算策略。
复制粘贴清单
Blogger 集成测试：实施清单
输入
[ ] 已记录生产站点 URL。
[ ] Blogger 站点 ID 来自当前环境。
[ ] 已配置源语言。
[ ] 目标语言从已配置的语言键中解析。
[ ] 分类从实时分类端点解析。
[ ] Slug 为最终值，使用小写、连字符分隔且唯一。
[ ] 规范 URL 由最终源 slug 构建。
内容包
[ ] Markdown 为最终版且面向客户。
[ ] HTML 在语义上与 Markdown 一致。
[ ] HTML 正文不包含重复的页面级 H1。
[ ] 元标题包含主要关键词。
[ ] 元描述包含主要关键词。
[ ] 摘要具体且简洁。
[ ] 内部链接相关且可访问。
[ ] 外部技术参考为官方或稳定来源。
封面
[ ] 封面图片专用于本文。
[ ] 封面文件可打开且非空。
[ ] 封面上传返回公开 URL。
[ ] 源载荷使用公开封面 URL。
[ ] 本地化文章保留相同的封面 URL。
源发布
[ ] 创建载荷已保存。
[ ] 创建响应已保存。
[ ] 源文章 ID 已存在。
[ ] 发布响应已保存。
[ ] 源状态为已发布。
[ ] 重试行为已记录。
路由验证
[ ] 源 URL 返回 HTTP 200。
[ ] 最终 URL 与预期 slug 一致。
[ ] 在回读内容中出现已知文章句子。
[ ] 规范链接为自引用。
[ ] 不存在 robots meta noindex。
[ ] 不存在 X-Robots-Tag noindex。
[ ] 封面 URL 出现在页面或 API 证据中。
本地化
[ ] 翻译目标文件已保存。
[ ] 每个目标语言都保存一份载荷。
[ ] 每个目标语言都保存一份响应。
[ ] 每条本地化路由均返回 HTTP 200。
[ ] 按语言报告翻译失败。
衡量
[ ] 已记录 GSC URL。
[ ] 已记录 GA4 页面路径。
[ ] 已记录 CTA 路径。
[ ] 已记录发布时间戳。
[ ] 后续指标为点击、展示、参与会话和转化。
Token 预算
[ ] 已记录草稿 token 预算。
[ ] 已按语言记录翻译 token 预算。
[ ] 已记录重试预算。
[ ] 预算回归将使工作流失败。最终验收规则
只有当源文章已发布、公开源 URL 返回 200、已配置的翻译已发布并验证、可索引性未显示 noindex 指令，并且证据包包含原始载荷和响应时，Blogger 集成测试：实施清单才算通过。
源公开 URL：https://tokentest.io/blog/blogger-integration-test-implementation-checklist-13-3