# 实验存储体系

创建人员：management.admin  
文件职责：记录 `project-info` 项目实验数据、结果包、图片、日志、schema 和读取追踪方式。  
管理规范/模板：../../common/exp-doc/实验存储体系创建指南.md；../../common/exp-doc/实验环境创建指南.md。  
引用文件：实验规范.md；实验总纲.md；实验设计.md；实验执行日志.md；实验审计报告.md。  
记录方式：存储体系入口；目录、结果包命名、schema 或读取规则变化时维护更新。

## 1. 目录映射

| 路径 | 作用 | 状态 |
|---|---|---|
| `../exp-data/raw/` | 原始输入索引、抽样数据或外部文件引用 | 已创建 |
| `../exp-data/result/` | 正式结果包、manifest、summary、readout 和可复核中间产物 | 已创建 |
| `../exp-data/img/` | 图片、图表和图片 manifest | 已创建 |
| `../exp-data/tmp/` | 临时文件，不得作为正式证据入口 | 已创建 |

## 2. 结果包命名

正式结果包使用：

```text
exp-data/result/<run_id>/
```

推荐文件：

```text
manifest.json
summary.md
summary.json
readout.md
intermediate/      # 需要长期复核的中间数据
```

图片放入 `exp-data/img/<experiment_id>/<run_id>/`，并用 manifest 记录来源、生成方式和用途。

## 3. 追踪规则

1. `实验总纲.md` 记录实验 ID、状态、设计入口、结果包入口和审计入口。
2. `实验设计.md` 记录数据源、样本、步骤、产物和判定标准。
3. `实验执行日志.md` 记录 run ID、输入、命令摘要、输出路径、自检和偏离。
4. `实验审计报告.md` 记录设计审核、执行审核和复审结论。

## 4. 禁止事项

1. 不得把 `exp-data/tmp/` 当正式证据入口。
2. 不得把数据库密码、授权 token 或私有凭据写入结果包。
3. 不得只有窗口文字结论而没有结果包或明确的 `HELD` 记录。
4. 不得把大表、大日志或批量图片直接回显到 Codex 会话窗口。