edit | blame | history | raw

实验设计

创建人员：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。
  • 是否纳入实验总纲结论：是，仅作为实验环境闭环证据。