diff --git a/docs/guides/context-delivery.md b/docs/guides/context-delivery.md index 2127d50ba5..ce225476b4 100644 --- a/docs/guides/context-delivery.md +++ b/docs/guides/context-delivery.md @@ -227,6 +227,28 @@ is not the raw authority response; a missing `should_run` is not a denial. Do not change an experiment's frozen mode, source or clock by changing machine settings. Trials retain their explicit configuration and original authority. +### Roll back to another runtime + +To disable progressive or differential presentation, use the existing settings +on the current runtime. An older release may read fewer persisted formats. +Qualify the exact target on the affected Host and authority provider before +switching: + +1. On isolated state, verify that the target reads the current Goal + requirements and the original capture. Include + [record-format outcomes](../reference/goal-acceptance-observations.md#long-horizon-record-storage) + when present. Reading a saved capture alone does not show that the target + can read current authority or finish its pending settlement. +2. Quiesce new admissions on the affected entrypoint. Retain the original + runtime, captures and receipts; reconcile in-flight Turns through that + runtime and their original identities. +3. Switch only to a target that can read the retained state and continue + work. Before reopening normal scheduling, check that new admission sees + the same requirements and that the earlier effects remain settled once. + If the target cannot read the current format, keep a compatible runtime + and use its presentation settings. Never restore an older authority + snapshot over committed requirements. + ### Troubleshoot without changing task history | Observation | Check next | diff --git a/docs/guides/context-delivery.zh-CN.md b/docs/guides/context-delivery.zh-CN.md index e395398265..07b1151127 100644 --- a/docs/guides/context-delivery.zh-CN.md +++ b/docs/guides/context-delivery.zh-CN.md @@ -173,6 +173,20 @@ CLI 使用同一个 `context_delivery` 机器 namespace,详见 展示封装不是原始权威响应;封装中缺少 `should_run` 不表示拒绝准入。不能通过改机器 设置改变某个实验冻结的模式、来源或时钟;trial 保留原显式配置与权限。 +### 回退到另一个运行时 + +只需关闭渐进或差分展示时,在当前运行时使用原有设置即可。旧版可能支持较少的 +持久化格式;切换前,应在受影响的宿主和状态后端上验证确切的目标版本: + +1. 在隔离状态上确认目标版本能读当前 Goal 的验收要求及原捕获。若已采用 + [记录格式](../reference/goal-acceptance-observations.md#long-horizon-record-storage), + 应覆盖该格式。能打开历史捕获,不说明它能读取当前权威状态或完成仍待结算的轮次。 +2. 暂停受影响入口的新准入。保留原运行时、捕获和回执,用原运行时和原身份核对、 + 结清在途 Turn。 +3. 只切换到可读保留状态且能继续工作的版本。恢复常规调度前,确认新准入仍看到原 + 验收要求,且此前效果只结算过一次。若目标版本不能读当前格式,就保留兼容运行时, + 用它的设置关闭展示。不要用旧权威快照覆盖已提交的验收要求。 + ### 排障不改写任务历史 | 观察 | 下一检查 |