# 实验规范

创建人员：Codex  
文件职责：记录 project B 实验员必须遵守的实验规范。本文件引用 common/exp-doc/实验规范.md，不得削弱 common 实验规范硬约束。  
管理规范/模板：../../common/exp-doc/实验规范.md  
引用文件：../../common/exp-doc/实验规范.md；../../common/exp-doc/实验环境创建指南.md

## 1. 基本口径

本项目所有实验员必须同时遵守 `../../common/exp-doc/实验规范.md` 和本文件。

本文件当前没有额外补充规则，但保留本项目核心实验文档说明，方便实验员直接理解本项目证据链。

## 2. 核心实验文档作用

| 文档 | 作用 |
|---|---|
| `实验总纲.md` | 记录本项目所有实验事项的背景、目标、边界、状态、结果包入口和结论 |
| `实验设计.md` | 记录本项目所有实验的设计、步骤、依赖、产物和判定标准 |
| `实验执行日志.md` | 记录本项目所有实验 run、输入、关键中间过程、中间数据路径、输出、异常、自检和重跑 |
| `实验存储体系.md` | 说明实验数据、结果包、图片、表 schema 和读取追踪方式 |
| `实验审计报告.md` | 记录设计审核、执行审核、复审结论，以及审核员发现的问题 |
| `实验问题记录.md` | 记录非审计来源实验问题；审计问题只在需要跨轮跟踪时登记索引 |

## 3. 本地目录口径

项目内实验文档使用相对路径。

项目级实验账本：

1. `实验总纲.md`
2. `实验设计.md`
3. `实验执行日志.md`

新实验默认追加到上述三本账本，不创建单实验独立总纲、设计或执行日志。

## 4. 执行日志补充口径

project B 的执行日志不能只记录开始和结果。每个 run 至少要记录：

1. 输入快照在哪里。
2. 每个关键中间步骤做了什么。
3. 中间数据或中间表保存在哪里。
4. 最终结果、图、summary、manifest 在哪里。
5. 每个关键步骤的行数、数量、hash 或等价校验。

需要审计员复核的中间数据应保存到 `../exp-data/result/<run_id>/intermediate/` 或等价正式结果包目录，不应只保存在 `../exp-data/tmp/`。