edit | blame | history | raw

project B 实验设计

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

0. 当前设计总览

  • 当前最新设计：DESIGN-20260601-KLINE-VOLUME-PULLBACK-002，已完成
  • 当前可执行设计：无；当前 K 线实验设计已执行完成
  • 当前阻断设计：无
  • 当前下一步：如需正式业务实验，在本文件末尾追加新设计块

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

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

1. 固定设计口径

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

2. 实验设计追加区

2026-06-01 DESIGN-20260601-TIMESERIES-SMOKE-001：轻量时序图 smoke 实验环境闭环验证

  • 所属实验事项：EXP-20260601-TIMESERIES-SMOKE-001
  • 创建人员：Codex
  • 创建时间：2026-06-01 16:07:20
  • 当前状态：完成
  • 当前结论：设计已执行并通过审计。
  • 来源聊天记录：见 实验总纲.md 中对应实验块。

当前约定

  • 本轮要验证：project B 的实验环境是否能完整支撑一个轻量时序图实验。
  • 本轮不验证：真实业务数据、业务规则、预测能力。
  • 与来源聊天要求的一致性：用户要求创建实验体系并跑一个轻量实验；本设计直接覆盖这两个目标。
  • 前置依赖：../../common/exp-doc/实验环境创建指南.md

实验方法和样本

  • 核心假设：如果总纲、设计、执行日志、结果包、图片、manifest、审计报告和问题记录均能串起来，则实验环境可用。
  • 数据源：合成时序数据，由 ../exp-data/tmp/run_timeseries_smoke_experiment.py 生成。
  • 样本范围：1 个合成对象，20 个工作日。
  • 实验组：合成时序序列。
  • 对照组：不需要；本轮目标是环境闭环，不验证规则效果。
  • 边界样本：前 4 行移动均线为空。
  • 防偏差要求：本实验不形成业务结论；使用合成数据并在 summary/readout 中标明边界。
  • 是否需要防未来函数：不适用。
  • 判断理由：实验目标是验证环境闭环，不是预测、收益率或实时决策。

执行顺序

  1. STEP-001：创建实验环境；输入为实验环境创建指南；输出为 exp-doc / exp-data。
  2. STEP-002：运行轻量时序图 smoke；输入为 runner script；输出为 raw/result/img/summary/manifest。
  3. STEP-003：审计闭环；输入为总纲/设计/日志/结果包；输出为审计报告。

字段、指标和状态

名称 类型 定义 来源 计算/判定口径 输出位置 备注
row_count 指标 输入行数 raw csv 输入表行数 summary.json 期望 20
signal_count 指标 示例信号数量 result csv flag 求和 summary.json 只作 smoke 指标
ma5_breakout_flag 字段 示例信号 runner 结束值上穿 MA5 timeseries_signal_result.csv 非业务建议
chart 产物 SVG 图 runner 按 OHLC 绘制 exp-data/img 人读复核

输出产物

  • 结果包目录：../exp-data/result/RUN-20260601-TIMESERIES-SMOKE-001
  • 核心输出表：../exp-data/result/RUN-20260601-TIMESERIES-SMOKE-001/timeseries_signal_result.csv
  • 核心图表：../exp-data/img/EXP-20260601-TIMESERIES-SMOKE-001/RUN-20260601-TIMESERIES-SMOKE-001/OBJECT001_2026-05_timeseries_ma5_breakout.svg
  • summary/readout：summary.json；readout.md
  • manifest/输入快照：input_manifest.csv；output_manifest.csv
  • 执行日志：实验执行日志.md 中 RUN-20260601-TIMESERIES-SMOKE-001

判定标准

  • PASS：核心目录和项目级文档存在；结果包存在；核心表、图、summary、manifest 可读；审计报告记录通过。
  • FAIL：核心文档缺失、结果包缺关键产物、manifest 无法追踪产物、审计报告缺失。
  • HELD：项目路径或数据路径无法确认。
  • 降读规则：即使 PASS，也只能读成实验环境可用，不读成业务规则有效。
  • 停止或转向条件：如果要验证真实业务规则，必须新建正式实验并使用真实或授权数据。

风险和不做事项

  • 关键风险：合成数据不能支持业务结论。
  • 阻断项：无。
  • 可接受缺口：没有真实数据和对照组，因为不属于本轮目标。
  • 本轮不做：不使用真实数据，不做收益统计，不进入业务结论。

设计审核

  • 设计审核状态：通过
  • 审核人：Codex
  • 审核时间：2026-06-01 16:07:20
  • 审核结论：设计能回答本轮目标，可以执行。
  • 未通过问题：无。
  • 复审记录：无。

执行结果回填

  • run_id：RUN-20260601-TIMESERIES-SMOKE-001
  • 结果包：../exp-data/result/RUN-20260601-TIMESERIES-SMOKE-001
  • 关键结果：raw 20 行；result 20 行；chart 1 张；manifest 已生成。
  • 当前读法：环境 smoke PASS。
  • 是否纳入实验总纲结论：是。

2026-06-01 DESIGN-20260601-KLINE-MA5-BREAKOUT-001：K 线 MA5 突破实验闭环验证

  • 所属实验事项：EXP-20260601-KLINE-MA5-BREAKOUT-001
  • 创建人员：Codex
  • 创建时间：2026-06-01 17:11:44
  • 当前状态：完成
  • 当前结论：设计已执行并通过审计。
  • 来源聊天记录：见 实验总纲.md 中对应实验块。

当前约定

  • 本轮要验证：project B 能否完整记录一个 K 线 MA5 突破类实验。
  • 本轮不验证：真实行情、真实交易规则、收益率、预测能力。
  • 与来源聊天要求的一致性：用户要求两个 K 线相关实验；本设计覆盖第一个实验。
  • 前置依赖：实验体系已创建；设计审核通过后执行。

实验方法和样本

  • 核心假设：如果 K 线实验的 raw/result/chart/summary/manifest/readout 能与总纲、设计、日志和审计串起来，则实验体系支持 K 线类实验闭环。
  • 数据源：合成 K 线数据，由 ../exp-data/tmp/run_kline_dual_experiments.py 生成。
  • 样本范围：1 个合成对象，25 个交易日。
  • 实验组：合成 K 线序列。
  • 对照组：不需要；本轮目标是环境和记录流程，不是规则效果。
  • 边界样本：MA5 不足 5 日时为空；上穿信号只在前一日未站上且当日站上时触发。
  • 防偏差要求：summary/readout 明确写入 synthetic_kline 和结论边界。
  • 是否需要防未来函数：不适用。
  • 判断理由：本轮实验目标是记录闭环，不是实时决策、收益或预测。

执行顺序

  1. STEP-001：生成合成 K 线 raw；输入为脚本内固定序列；输出为 synthetic_kline_input.csv。
  2. STEP-002：计算 MA5 上穿示例信号；输入为 raw；输出为 kline_ma5_breakout_result.csv。
  3. STEP-003：生成 SVG 图和 summary/readout/manifest；输入为 result；输出为结果包和图。
  4. STEP-004：写执行日志、执行审计和问题记录。

字段、指标和状态

名称 类型 定义 来源 计算/判定口径 输出位置 备注
row_count 指标 输入/结果行数 result csv 结果表行数 summary.json 期望 25
signal_count 指标 MA5 突破信号数 result csv signal_flag 求和 summary.json 只作 smoke 指标
signal_flag 字段 示例信号 runner close 上穿 MA5 kline_ma5_breakout_result.csv 非业务建议
chart 产物 K 线图 runner SVG 绘制 exp-data/img 人读复核

输出产物

  • 结果包目录：../exp-data/result/RUN-20260601-KLINE-MA5-BREAKOUT-001
  • 中间特征表：../exp-data/result/RUN-20260601-KLINE-MA5-BREAKOUT-001/intermediate/kline_feature_panel.csv
  • 核心输出表：../exp-data/result/RUN-20260601-KLINE-MA5-BREAKOUT-001/kline_ma5_breakout_result.csv
  • 核心图表：../exp-data/img/EXP-20260601-KLINE-MA5-BREAKOUT-001/RUN-20260601-KLINE-MA5-BREAKOUT-001/KOBJ001_ma5_breakout.svg
  • summary/readout：summary.json；readout.md
  • manifest/输入快照：input_manifest.csv；output_manifest.csv
  • 执行日志：实验执行日志.md 中 RUN-20260601-KLINE-MA5-BREAKOUT-001

判定标准

  • PASS：raw/result/chart/summary/readout/manifest 全部存在且可读；审计报告记录通过。
  • FAIL：缺核心产物、证据链断裂或 summary 状态失败。
  • HELD：路径或数据无法确认。
  • 降读规则：即使 PASS，也只读成实验体系闭环可用，不读成信号有效。
  • 停止或转向条件：如果要验证真实 K 线规则，必须新建正式业务实验。

设计审核

  • 设计审核状态：通过
  • 审核人：Codex
  • 审核时间：2026-06-01 17:11:44
  • 审核结论：设计能回答本轮目标，可以执行。
  • 未通过问题：无。
  • 复审记录：无。

执行结果回填

  • run_id：RUN-20260601-KLINE-MA5-BREAKOUT-001
  • 结果包：../exp-data/result/RUN-20260601-KLINE-MA5-BREAKOUT-001
  • 关键结果：raw 25 行；intermediate feature 25 行；result 25 行；chart 1 张；signal_count 1；manifest 已生成。
  • 当前读法：K 线 MA5 突破实验闭环 PASS。
  • 是否纳入实验总纲结论：是。

2026-06-01 DESIGN-20260601-KLINE-VOLUME-PULLBACK-002：K 线缩量回踩实验闭环验证

  • 所属实验事项：EXP-20260601-KLINE-VOLUME-PULLBACK-002
  • 创建人员：Codex
  • 创建时间：2026-06-01 17:11:44
  • 当前状态：完成
  • 当前结论：设计已执行并通过审计。
  • 来源聊天记录：见 实验总纲.md 中对应实验块。

当前约定

  • 本轮要验证：project B 能否连续记录第二个 K 线实验，并保持证据链可追踪。
  • 本轮不验证：真实行情、真实交易规则、收益率、预测能力。
  • 与来源聊天要求的一致性：用户要求两个 K 线相关实验；本设计覆盖第二个实验。
  • 前置依赖：第一个 K 线实验已跑通；设计审核通过后执行。

实验方法和样本

  • 核心假设：如果第二个 K 线实验也能完整回写到同一套滚动账本，则实验体系能支撑连续实验记录。
  • 数据源：合成 K 线数据，由 ../exp-data/tmp/run_kline_dual_experiments.py 生成。
  • 样本范围：1 个合成对象，25 个交易日。
  • 实验组：合成 K 线序列。
  • 对照组：不需要；本轮目标是记录流程，不是规则效果。
  • 边界样本：MA10 不足 10 日时为空；缩量回踩信号只用于验证字段和图表链路。
  • 防偏差要求：summary/readout 明确写入 synthetic_kline 和结论边界。
  • 是否需要防未来函数：不适用。
  • 判断理由：本轮实验目标是记录闭环，不是实时决策、收益或预测。

执行顺序

  1. STEP-001：生成合成 K 线 raw；输入为脚本内固定序列；输出为 synthetic_kline_input.csv。
  2. STEP-002：计算缩量回踩 MA10 示例信号；输入为 raw；输出为 kline_volume_pullback_result.csv。
  3. STEP-003：生成 SVG 图和 summary/readout/manifest；输入为 result；输出为结果包和图。
  4. STEP-004：写执行日志、执行审计和问题记录。

字段、指标和状态

名称 类型 定义 来源 计算/判定口径 输出位置 备注
row_count 指标 输入/结果行数 result csv 结果表行数 summary.json 期望 25
signal_count 指标 缩量回踩信号数 result csv signal_flag 求和 summary.json 只作 smoke 指标
signal_flag 字段 示例信号 runner low 接近 MA10 且 volume 小于前一日 kline_volume_pullback_result.csv 非业务建议
chart 产物 K 线图 runner SVG 绘制 exp-data/img 人读复核

输出产物

  • 结果包目录：../exp-data/result/RUN-20260601-KLINE-VOLUME-PULLBACK-002
  • 中间特征表：../exp-data/result/RUN-20260601-KLINE-VOLUME-PULLBACK-002/intermediate/kline_feature_panel.csv
  • 核心输出表：../exp-data/result/RUN-20260601-KLINE-VOLUME-PULLBACK-002/kline_volume_pullback_result.csv
  • 核心图表：../exp-data/img/EXP-20260601-KLINE-VOLUME-PULLBACK-002/RUN-20260601-KLINE-VOLUME-PULLBACK-002/KOBJ002_volume_pullback.svg
  • summary/readout：summary.json；readout.md
  • manifest/输入快照：input_manifest.csv；output_manifest.csv
  • 执行日志：实验执行日志.md 中 RUN-20260601-KLINE-VOLUME-PULLBACK-002

判定标准

  • PASS：raw/result/chart/summary/readout/manifest 全部存在且可读；审计报告记录通过。
  • FAIL：缺核心产物、证据链断裂或 summary 状态失败。
  • HELD：路径或数据无法确认。
  • 降读规则：即使 PASS，也只读成实验体系闭环可用，不读成信号有效。
  • 停止或转向条件：如果要验证真实 K 线规则，必须新建正式业务实验。

设计审核

  • 设计审核状态：通过
  • 审核人：Codex
  • 审核时间：2026-06-01 17:11:44
  • 审核结论：设计能回答本轮目标，可以执行。
  • 未通过问题：无。
  • 复审记录：无。

执行结果回填

  • run_id：RUN-20260601-KLINE-VOLUME-PULLBACK-002
  • 结果包：../exp-data/result/RUN-20260601-KLINE-VOLUME-PULLBACK-002
  • 关键结果：raw 25 行；intermediate feature 25 行；result 25 行；chart 1 张；signal_count 6；manifest 已生成。
  • 当前读法：K 线缩量回踩实验闭环 PASS。
  • 是否纳入实验总纲结论：是。