先给结论：dry-run 发布前验证要解决什么问题
RankPilot OS dry-run 发布前验证的核心作用，是在正式写入站点前检查字段、权限与风险。它应帮助发布人员先确认“准备写入什么”“是否有权写入”“写入后可能带来什么影响”，再决定是否进入正式发布流程。
本文围绕文章目标 RankPilot OS dry-run 发布前验证：如何在写入站点前检查字段、权限与风险 展开。当前目标为 article，handle 为 rankpilot-os-dry-run，已有 SEO description 为“RankPilot OS dry-run 发布验证流程”。本文仅说明发布前验证思路，不代表一次最终写入、发布或变更记录。
写入站点前需要核对的字段
dry-run 阶段应先把待写入字段列清楚，并逐项确认字段是否完整、是否与预期一致、是否存在误覆盖风险。对于文章类内容，建议重点核对以下字段：
- 标题：确认标题是否为计划发布的文章标题，避免将草稿标题、测试标题或错误主题写入站点。
- handle：确认 handle 是否为
rankpilot-os-dry-run，并检查是否与当前内容主题一致。 - SEO description：确认描述是否为“RankPilot OS dry-run 发布验证流程”，或确认是否需要在正式写入前调整。
- 正文内容：检查正文是否完整覆盖发布前验证主题，是否包含字段检查、权限检查、风险检查、FAQ、内部链接方向、对比模块和决策指导模块。
- 页面类型：确认目标类型为 article，避免把文章内容写入错误的页面类型或流程。
- 更新时间语境：当前目标快照包含 updated_at 信息，可用于识别当前资源状态，但不应把它误写成最终发布完成证明。
字段检查的重点不是追求内容已经“最终完美”，而是确认即将写入的字段与发布意图一致，并且没有明显缺失、错位或误覆盖。
权限检查：确认谁可以写入，写入范围是什么
发布前还需要确认操作者或系统是否具备必要权限。这里不应假设任何具体权限模型，而应以站点实际权限配置为准，检查当前执行方是否被允许对目标文章、目标字段或目标流程进行写入。
权限检查可围绕三个问题展开：
- 是否有权访问目标资源：确认执行方可以访问当前 article 目标。
- 是否有权修改相关字段：确认标题、handle、SEO description、正文等字段是否在允许写入范围内。
- 是否有权进入正式发布流程：dry-run 通过不等于自动发布，应确认后续正式写入或发布动作是否仍需额外审批或人工复核。
如果权限不清楚，应先暂停正式写入，并转向权限配置、角色管理或访问控制说明页面进行确认。
风险检查：在写入前识别可能影响站点的变更
dry-run 不能保证完全无风险，也不应被理解为自动修复工具。它更适合作为正式写入前的最后检查层，帮助发布人员提前识别风险并决定是否继续。
常见风险检查方向包括：
- 字段缺失风险：标题、handle、SEO 描述或正文关键部分是否为空、缺失或与主题不一致。
- 误覆盖风险：待写入字段是否可能覆盖已有内容，尤其是 SEO 字段和正文内容。
- 权限不足风险：执行方是否没有明确写入权限，或权限范围与计划动作不匹配。
- 流程跳步风险：是否绕过必要审核，直接从 dry-run 进入正式发布。
- 主题偏离风险：内容是否偏离“RankPilot OS dry-run 发布前验证”这一主题。
当风险较高或信息不足时，应先补充字段、确认权限、完成审核，再重新执行发布前验证。
dry-run 与直接发布的对比
| 流程 | 主要目的 | 适用场景 | 主要风险 |
|---|---|---|---|
| dry-run 发布前验证 | 在写入站点前检查字段、权限与风险 | 需要复核标题、handle、SEO 描述、正文和发布条件时 | 如果只看结果不做人工判断，仍可能遗漏上下文风险 |
| 直接发布或直接写入 | 把内容或字段正式写入站点 | 字段、权限、审核和风险判断都已完成后 | 如果未提前复核，可能出现误写入、字段错配或权限问题 |
因此，dry-run 不应替代正式发布流程，而应放在正式写入之前，作为降低误写入和误发布风险的检查步骤。
如何判断是否可以进入正式写入
可以把 dry-run 结果当作一份发布前决策清单。只有当以下条件都完成复核后，才建议进入正式写入或发布流程：
- 字段一致：标题、handle、SEO description、正文内容和页面类型与发布意图一致。
- 权限明确：执行方具备必要访问和写入权限，且后续发布动作不违反站点流程。
- 风险可接受：没有未处理的字段缺失、误覆盖、权限不足或流程跳步风险。
- 下一步清楚：发布流程说明、权限检查清单、SEO 字段检查清单或风险审核资料已确认。
如果任一条件无法确认，应停止进入正式写入，先回到对应问题进行修正或复核。
决策指导：dry-run 结果出来后怎么处理
- 全部通过：字段、权限和风险均已复核，可准备进入正式写入或发布流程。
- 字段有疑问：先修正标题、handle、SEO description 或正文，再重新进行发布前验证。
- 权限不明确：先查看权限配置、角色管理或访问控制说明，不建议继续写入。
- 风险较高：先进入风险审核、发布清单或回滚策略相关流程，确认可接受后再继续。
- 流程不清楚：优先查找发布流程或内容写入流程说明，避免把 dry-run 当成最终发布动作。
FAQ：发布前验证的常见追问
RankPilot OS dry-run 发布前验证的核心目的是什么？
核心目的是在正式写入站点前检查待写入字段、站点权限与潜在风险，帮助发布人员判断是否可以进入下一步。
写入站点前应该检查哪些字段？
至少应检查标题、handle、SEO description、正文内容和页面类型。当前目标快照支持的关键信息包括标题、handle rankpilot-os-dry-run、article 类型，以及 SEO description“RankPilot OS dry-run 发布验证流程”。
发布前为什么要确认权限？
因为字段正确并不代表执行方一定有权写入。权限检查可以降低未经授权写入、写入范围不清或流程跳步的风险。
dry-run 发现风险时应该如何处理？
应暂停正式写入，先定位风险来源。字段问题先修字段，权限问题先查权限，流程或影响不清时先进入审核或风险复核。
dry-run 验证通过后是否可以直接正式写入站点？
不应只因为 dry-run 通过就自动写入。仍应确认字段、权限、风险和后续发布流程都已完成复核，再进入正式写入。
内部链接机会与下一步
目标快照中的 related_links 为空，因此本文不添加具体内部链接 URL。后续可以在站点中补充以下方向的相关页面或文章：
- 发布流程说明页面：帮助读者理解 dry-run 后如何进入正式写入或发布步骤。
- 权限配置或访问控制页面：支持权限检查，确认执行方是否具备必要写入权限。
- SEO 字段检查清单页面：用于复核标题、SEO 描述、handle 等字段。
- 发布风险或审核清单文章：帮助处理 dry-run 发现的字段缺失、权限不足或站点写入风险。
最终判断
RankPilot OS dry-run 发布前验证应被视为正式写入站点前的最后检查层，而不是最终发布操作记录。只有字段一致、权限明确、风险可接受，并且下一步发布流程或支持页面已经确认后，才应进入正式写入或发布流程。