docs/VALIDATION.md

# 验证范围 / Validation scope

此次权重发布完成了以下检查：

- 六个 OSS 源文件下载后验证 CRC64，并重新检查源对象大小和 ETag；两个模型文件均保留原始 SHA256。
- safetensors 张量偏移、形状、字节数和 dtype 检查通过；FLUX 的 451 个 BF16 张量键名与形状完全匹配仓库中在 meta 设备构造的模型。
- 脱敏后的 FLUX 配置可构造 `PolicyConfig`，原始代码的 manifest 校验函数通过；使用启动脚本默认采样参数时配置校验通过。
- π0.5 元数据通过 `torch.load(weights_only=True)` 读取；模型／数据关键配置与仓库 `pi05_umi_v3` 对应，checkpoint 归一化字段均为 20 维。
- 246 个 Python 文件和 5 个 shell 文件语法检查通过；2 项启动参数测试和 2 项现有 checkpoint 预检查测试通过。

下载后可在仓库根目录单独校验 checkpoint（不检查外部编码器）：

```bash
python scripts/verify_assets.py --model flux --checkpoint checkpoints/flux_fold_clothes_bf16 --checkpoint-only --verify-hashes
python scripts/verify_assets.py --model pi05 --checkpoint checkpoints/pi05_fold_clothes/epoch_2 --checkpoint-only
```

此次检查没有把完整模型张量加载到运行设备，没有执行 GPU 前向推理，也未验证外部 VAE／文本编码器／tokenizer 或实机叠衣效果。采样参数的配置有效性不等于任务效果验证。此前源码发布的离线接口、记录和 mock 协议测试记录保留在 `validation.json`；本次权重检查详情见 [checkpoint_validation.json](checkpoint_validation.json)。

This release checks source-object integrity, safetensors structure, FLUX meta-model key/shape compatibility, sanitized manifests and safe π0.5 metadata/config wiring. Model tensors were not materialized on a runtime device. External encoders/tokenizer, GPU forward inference and physical-robot performance remain untested. See the JSON report for exact checks.