stateful-workflow-maintenance git:20261105.ad61539A

Immutable. This exact content never changes and is served at /api/v1/blob/2ae5478207fe4a69.

---
name: stateful-workflow-maintenance
description: "维护和迁移能从保存点继续、含历史凭证或会对外发布的批处理流程。适用于清理旧入口、统一保存格式、恢复失败批次和核验上线。保留原始材料、运行记录和费用，按实际依赖选择检查范围。"
---

# 维护可续跑的生产流程

先读项目的执行规则、正常入口和完成条件。按用户已授权的范围处理数据、请求、提交和发布。本文提供判断方法，具体权限、默认值、锁和停止条件以项目为准。

## 何时使用与不适用

适合：

- 维护、清理或迁移带保存点、历史凭证、失败恢复或对外发布的批处理与发布流程。
- 统一内部格式、废弃旧入口、继续中断批次、核验上线，同时保留原始材料、记录和费用。
- 同一份材料被另一语言、进程、仓库或已发行客户端读取，需要一并核对。

不适合：

- 一次性、无保存点、无历史凭证也不对外发布的小脚本；直接写针对该任务的检查更合适。
- 代替项目自己的执行规则、权限、费用或发布授权。本文只给方法，实际范围以项目规则和实现为准。
- 为通过检查而改写历史记录、补造来源、手工填写完成状态或清零费用。
- 纯文案修改，或与流程状态、数据归属和发布无关的界面调整。

## 清理或迁移前查实际依赖

1. 查谁写入、谁读取、谁在中断后继续，以及谁从另一语言、进程、仓库或已发行客户端读取。同样检查命令别名、定时任务、动态加载、构建模板、测试和历史回放。文件名旧、搜索不到导入或仅能在旧数据中找到，都需要结合这些入口判断。
2. 分开处理现用内部格式、公开接口、正式发行号、原始凭证和已经退役的写入能力。经授权统一内部格式时，让当前写入使用稳定名称和明确的结构身份。对需要保留的旧记录先验证原字节和原格式，再转成当前程序可用的视图。公开接口先对照实际消费者，决定保留边界转换还是协调一起迁移。
3. 历史声明指向旧提示词、源文件或程序时，保存可定位的原对象。逐字检查、字段兼容和继续执行是不同能力。原材料缺失时保留阻断，不能重算一份新摘要冒充原证明，也不能让旧记录重新获得写入、请求或发布资格。
4. 并行工作时分开写入范围，指定共享清单和跨边界接口的整合者。用独立目录跑夹具，检查时记录实际提交。最终在目标分支核对远端、合入状态和实际改动，保护用户未提交的文件。

至少检查新写后回读、真实旧记录读取以及关键拒绝路径。跨语言用同一材料核对两边的输出。依赖公开消费者时，用实际构建或读取入口检查。区分隔离夹具、明确绑定的真实旧记录回放和完整工程验收。只删除已查明无现行用途的入口与文件。

## 运行失败时先保住已有结果

- 普通单项失败先保存，完成当轮其他项目，再收集全部剩余失败。认证、共同依赖、保存等运行级故障按项目规则停止新派发，妥善保存正在执行的结果。
- 区分内容错误、来源缺损、格式不兼容、程序误判、原记录变化与服务故障。核对原来源、最新失败、待完成义务、候选、尝试与费用，再选恢复入口。
- 已保存的输出先用原输入和真实记录重新核验。内容合格、只差可验证的格式或状态时，优先复用原结果。程序误判用真实保存稿复现，配上应继续拒绝的反例，再修共同规则。遇到来源缺失或原稿变化时解决实际阻断。
- 局部修改应绑定准确的原句或数据位置、原稿摘要和修改依据。重建结果后确认范围外内容保持一致，再走正常校验。提交前持锁重读原稿和关键依赖，确认它们没有在准备期间变化。
- 重试保留旧失败、已发请求和真实费用。需要追加请求时按用户和项目授权登记新增消耗。请求预览、通过缓存、外层批次轮数和只读证明各有自己的用途。项目已有持续付费授权时，按项目规则登记必要的新窗口、清单和实际消耗后继续，不重复征求同意；授权只覆盖必要的执行与恢复，不改变来源、完成和发布资格的核验。

## 发布后按同一份产物收尾

1. 从审查结果确认目标文件和字节，发布时保护工作区里的其他改动。记录实际远端提交或发布对象。
2. 绑定这次发布核对构建与部署。旧提交成功、当前提交已推送和对应站点已部署分别记录。等待部署期间用阶段日志或服务状态观察，完整核验只在需要时运行。
3. 按发布清单核对目标网页或下载。按任务分别检查可访问性、最终地址、精确标题、页面结构或下载字节。先读工具实际判定条件，基础探测留下的缺口用相应检查补齐。
4. 状态汇报说清已完成的阶段、仍在等待的具体事项和验证范围。最终记录至少能找到发布对象、审查材料和外部验收结果。只有已授权的全部收尾条件满足后才报告完成。

## 交付前检查清单

- [ ] 写入方、读取方、中断恢复、跨语言/进程/仓库/客户端消费者和命令别名已列全；删除前确认没有现行用途。
- [ ] 现用内部格式、公开接口、正式发行号、原始凭证和退役写入能力分开处理。
- [ ] 旧记录能定位原字节和原格式；材料缺失时保留阻断，没有用新摘要冒充原证明。
- [ ] 新写后回读、真实旧记录读取和关键拒绝路径都有实际结果；跨语言用同一材料核对。
- [ ] 失败批次先完成整轮并保存，再只续真实可重试的失败集合；原失败、尝试和费用没有被清零。
- [ ] 局部修改绑定原句或数据位置、原稿摘要和依据，范围外内容保持一致。
- [ ] 提交前持锁重读原稿和关键依赖；并行工作时只改分配的写入范围。
- [ ] 发布对象、对应构建与部署、目标页面或下载字节分别核验；状态汇报写明未验证的部分。
- [ ] 新增或追加付费轮次按项目规则登记，持续授权范围内不重复征求同意。