# 实验设计

创建人员：Codex  
文件职责：记录 project A 所有实验的设计、步骤、依赖、产物、判定标准、设计审核和执行结果回填。  
管理规范/模板：../../common/exp-doc/实验规范.md；本文件由 ../../common/exp-doc/实验设计模版.md 实例化。  
引用文件：实验总纲.md；实验执行日志.md；实验审计报告.md；实验存储体系.md。

## 0. 当前设计总览

- 当前最新设计：DESIGN-20260601-PROJA-VOLUME-SPIKE-002，完成。
- 当前可执行设计：DESIGN-20260601-PROJA-SIGNAL-CROSS-001；DESIGN-20260601-PROJA-VOLUME-SPIKE-002。
- 当前阻断设计：无。
- 当前下一步：对比 project B，检查模板和指南是否仍有漏项。

## 0A. 文档定位和证据索引职责

- 本文件是 project A 具体实验设计与证据索引主入口。
- 它负责回答：每个实验想解决什么问题、怎么验证、当前状态是什么、关键证据和结果包在哪里。
- 实验总纲回答“为什么做和最后怎么读”；实验设计回答“具体怎么做、证据在哪里、结果包是什么”。
- 后续新增实验、修订实验边界、回填执行结果，都应追加到本文件末尾，不得覆盖历史设计。

## 1. 固定设计口径

- 维护方式：append-only；新设计、新修订、新执行回填追加到文件末尾，最新内容在最后。
- 旧设计处理：不得删除；若失效，追加“失效/降读/被替代”说明。
- 设计与计划合并：本文件同时记录“要怎么验证”和“按什么步骤执行”。
- 设计审核要求：设计审核通过后才能执行；未通过则追加修订块，不覆盖旧设计。
- 路径规则：项目内文件默认使用相对路径。

## 2. 实验设计追加区

## 2026-06-01 DESIGN-20260601-PROJA-SIGNAL-CROSS-001：轻量阈值穿越实验

- 所属实验事项：EXP-20260601-PROJA-SIGNAL-CROSS-001。
- 创建人员：Codex。
- 创建时间：2026-06-01 18:00:00。
- 当前状态：完成。
- 当前结论：设计和执行均通过。
- 来源聊天记录：见 `实验总纲.md` 中 EXP-20260601-PROJA-SIGNAL-CROSS-001。

### 当前约定

- 本轮要验证：project A 能否按 common 指南完成一个轻量实验闭环。
- 本轮不验证：真实业务规则有效性。
- 与来源聊天要求的一致性：用户要求按指南创建体系并跑实验；本设计只做环境和证据链 smoke。
- 前置依赖：实验环境目录、实验存储体系、审计规范。

### 实验方法和样本

- 核心假设：如果 raw、intermediate、result、summary、manifest、image、audit 都能互相追踪，则实验体系基础可用。
- 数据源：runner 生成合成时序数据。
- 样本范围：OBJECT001，8 行。
- 实验组：value 高于前 3 日均值 8% 的事件。
- 对照组：本轮为环境 smoke，不需要正式对照组。
- 边界样本：前 3 行均值窗口不足。
- 防偏差要求：本轮不做业务结论；未来函数检查不适用。
- 是否需要防未来函数：否。
- 判断理由：目标是环境闭环，不是实时决策或收益实验。

### 执行顺序

1. STEP-001：生成 raw input；输出 raw CSV。
2. STEP-002：计算 trailing_ma3 和 signal_flag；输出 intermediate feature panel。
3. STEP-003：筛选 signal rows；输出 result CSV。
4. STEP-004：生成 SVG 图、summary、readout、manifest。
5. STEP-005：执行自检和审计。

### 字段、指标和状态

| 名称 | 类型 | 定义 | 来源 | 计算/判定口径 | 输出位置 | 备注 |
|---|---|---|---|---|---|---|
| signal_flag | 字段 | 是否触发阈值穿越 | feature step | value > trailing_ma3 * 1.08 | feature_panel.csv | 前序窗口不足为 0 |
| signal_count | 指标 | 命中数量 | result step | result row count | summary.json | 目标是大于等于 1 |

### 输出产物

- 结果包目录：../exp-data/result/RUN-20260601-PROJA-SIGNAL-CROSS-001。
- 核心输出表：signal_cross_result.csv。
- 核心图表：../exp-data/img/EXP-20260601-PROJA-SIGNAL-CROSS-001/RUN-20260601-PROJA-SIGNAL-CROSS-001/OBJECT001_signal_cross.svg。
- summary/readout：summary.json；readout.md。
- manifest/输入快照：output_manifest.csv；input_manifest.csv。
- 执行日志：`实验执行日志.md` 中 RUN-20260601-PROJA-SIGNAL-CROSS-001。

### 判定标准

- PASS：结果包存在；raw/intermediate/result/summary/manifest/image 均可读；signal_count >= 1；审计通过。
- FAIL：关键产物缺失、manifest 不可读、执行与设计不一致。
- HELD：缺少执行日志或审计证据。
- 降读规则：任何业务读法均降读为“不适用”。
- 停止或转向条件：证据链无法追踪则停止修复。

### 风险和不做事项

- 关键风险：脚本生成路径或 manifest 写法与存储体系不一致。
- 阻断项：结果包缺 summary、manifest、核心表、图。
- 可接受缺口：合成数据没有业务意义。
- 本轮不做：真实数据接入、收益率、预测、业务规则验证。

### 设计审核

- 设计审核状态：通过。
- 审核人：Codex。
- 审核时间：2026-06-01 18:01:00。
- 审核结论：目标清楚，设计能回答环境闭环目标，允许执行。
- 未通过问题：无。
- 复审记录：无。

### 执行结果回填

- run_id：RUN-20260601-PROJA-SIGNAL-CROSS-001。
- 结果包：../exp-data/result/RUN-20260601-PROJA-SIGNAL-CROSS-001。
- 关键结果：raw 8 行，feature 8 行，signal 5 行。
- 当前读法：PASS。
- 是否纳入实验总纲结论：是，仅作为实验环境闭环证据。

## 2026-06-01 DESIGN-20260601-PROJA-VOLUME-SPIKE-002：轻量放量异动实验

- 所属实验事项：EXP-20260601-PROJA-VOLUME-SPIKE-002。
- 创建人员：Codex。
- 创建时间：2026-06-01 18:05:00。
- 当前状态：完成。
- 当前结论：设计和执行均通过；首次执行问题已关闭。
- 来源聊天记录：见 `实验总纲.md` 中 EXP-20260601-PROJA-VOLUME-SPIKE-002。

### 当前约定

- 本轮要验证：第二个实验是否也能按同一体系闭环，且执行问题能被记录。
- 本轮不验证：真实放量异动有效性。
- 与来源聊天要求的一致性：承接用户要求“跑两次实验”。
- 前置依赖：第一个实验已证明基础目录和文档可用。

### 实验方法和样本

- 核心假设：第二个实验若也能形成完整结果包和审计记录，说明体系不是单实验偶然可用。
- 数据源：runner 生成合成 value + volume 数据。
- 样本范围：OBJECT002，8 行。
- 实验组：volume 高于前 3 日均量 80% 且 value 上行的事件。
- 对照组：本轮为环境 smoke，不需要正式对照组。
- 边界样本：前 3 行均量窗口不足。
- 防偏差要求：本轮不做业务结论；未来函数检查不适用。
- 是否需要防未来函数：否。
- 判断理由：目标是环境闭环，不是实时决策或收益实验。

### 执行顺序

1. STEP-001：生成 raw input；输出 raw CSV。
2. STEP-002：计算 volume_ma3、value_up_flag、signal_flag；输出 intermediate feature panel。
3. STEP-003：筛选 signal rows；输出 result CSV。
4. STEP-004：生成 SVG 图、summary、readout、manifest。
5. STEP-005：执行自检和审计。

### 字段、指标和状态

| 名称 | 类型 | 定义 | 来源 | 计算/判定口径 | 输出位置 | 备注 |
|---|---|---|---|---|---|---|
| signal_flag | 字段 | 是否触发放量异动 | feature step | volume > volume_ma3 * 1.8 且 value_up | feature_panel.csv | 前序窗口不足为 0 |
| signal_count | 指标 | 命中数量 | result step | result row count | summary.json | 目标是大于等于 1 |

### 输出产物

- 结果包目录：../exp-data/result/RUN-20260601-PROJA-VOLUME-SPIKE-002。
- 核心输出表：volume_spike_result.csv。
- 核心图表：../exp-data/img/EXP-20260601-PROJA-VOLUME-SPIKE-002/RUN-20260601-PROJA-VOLUME-SPIKE-002/OBJECT002_volume_spike.svg。
- summary/readout：summary.json；readout.md。
- manifest/输入快照：output_manifest.csv；input_manifest.csv。
- 执行日志：`实验执行日志.md` 中 RUN-20260601-PROJA-VOLUME-SPIKE-002。

### 判定标准

- PASS：结果包存在；raw/intermediate/result/summary/manifest/image 均可读；signal_count >= 1；审计通过。
- FAIL：关键产物缺失、manifest 不可读、执行与设计不一致。
- HELD：缺少执行日志或审计证据。
- 降读规则：任何业务读法均降读为“不适用”。
- 停止或转向条件：证据链无法追踪则停止修复。

### 风险和不做事项

- 关键风险：脚本复用时参数错误导致部分 run 中断。
- 阻断项：结果包缺 summary、manifest、核心表、图。
- 可接受缺口：合成数据没有业务意义。
- 本轮不做：真实数据接入、收益率、预测、业务规则验证。

### 设计审核

- 设计审核状态：通过。
- 审核人：Codex。
- 审核时间：2026-06-01 18:06:00。
- 审核结论：目标清楚，设计能回答第二次闭环验证目标，允许执行。
- 未通过问题：无。
- 复审记录：无。

### 执行结果回填

- run_id：RUN-20260601-PROJA-VOLUME-SPIKE-002。
- 结果包：../exp-data/result/RUN-20260601-PROJA-VOLUME-SPIKE-002。
- 关键结果：raw 8 行，feature 8 行，signal 1 行。
- 当前读法：PASS。
- 是否纳入实验总纲结论：是，仅作为实验环境闭环证据。