# 验证工具故障恢复轨迹


按[任务包规范](/zh/data/task-packages)组织文件，并记录与精确版本对应的证据。

编写一个工具使用场景，让缺少前置条件时出现可观察的失败。恢复轨迹应记录尝试、修复和检查点。本例使用新的临时目录，故意让一个文件起初不存在。

## 编写与验证

先定义恢复前后的可观察状态。按顺序记录工具事件和实际退出状态。第 1 层验证器应要求同一次运行中既出现失败尝试，又达到成功检查点。恢复结论以这些记录为依据。需要时，可以另外评价说明的质量。

## 校准与修正

用相同输入重放失败和恢复过程，再删掉失败事件作反例。固定环境、采集格式、验证器版本和试验标识。事件丢失时记为采集不完整。验证结果与故障原因、修复记录分开保存，原始终端输出保留在内部。

## 可运行示例

用 Python 3.12 运行。脚本在临时目录中启动三个实际的子进程。它检查最终读取成功前是否记录了失败和修复。

```bash
python3.12 - <<'PY'
from pathlib import Path
from subprocess import run
from sys import executable
from tempfile import TemporaryDirectory

with TemporaryDirectory() as directory:
    root = Path(directory)
    read = "print(open('ready.txt').read(), end='')"
    commands = [read, "open('ready.txt', 'w').write('ready')", read]
    events = [run([executable, "-c", command], cwd=root, capture_output=True, text=True)
              for command in commands]

def passes(trace):
    return [event.returncode for event in trace] == [1, 0, 0] and trace[-1].stdout == "ready"

assert passes(events)
assert not passes(events[1:])
print("ordered recovery pass, missing failure event fails")
PY
```

制作轨迹集时，为每次运行保留验证结果和稳定的证据引用。标明此样例是脚本执行的，结论限于这个受控场景的检查点行为。
