| | |
|---|
| | | # 实验执行日志模版 |
|---|
| | | # 实验执行日志 |
|---|
| | | |
|---|
| | | 创建人员：<填写创建人员或 AI> |
|---|
| | | 文件职责：记录项目内所有实验实际执行过程、关键输入输出、异常、重跑和下一步动作。 |
|---|
| | | 管理规范/模板：common/exp-doc/实验规范.md；本文件由 common/exp-doc/实验执行日志模版.md 实例化。 |
|---|
| | | 引用文件：<填写实验总纲、实验设计、实验审计报告、执行脚本或数据路径> |
|---|
| | | 创建人员：management.admin |
|---|
| | | 文件职责：记录 `project-info` 项目实验 run、输入、关键过程、输出、异常、自检和重跑。 |
|---|
| | | 管理规范/模板：../../common/exp-doc/实验执行日志模版.md；../../common/exp-doc/实验环境创建指南.md。 |
|---|
| | | 引用文件：实验规范.md；实验总纲.md；实验设计.md；实验审计报告.md；实验存储体系.md。 |
|---|
| | | 记录方式：append-only 执行日志；每次实验执行、重跑或修复追加记录。 |
|---|
| | | |
|---|
| | | ## 0. 当前执行总览 |
|---|
| | | ## 2026-06-25 RUN-EXP-SMOKE-001 |
|---|
| | | |
|---|
| | | - 当前最新 run：<run_id / 状态> |
|---|
| | | - 当前可用结果包：<run_id / 路径> |
|---|
| | | - 当前失败或暂停 run：<run_id / 原因> |
|---|
| | | - 当前下一步：<重跑/复审/回写/暂停> |
|---|
| | | - run ID：RUN-EXP-SMOKE-001 |
|---|
| | | - 所属实验：EXP-SMOKE-001 |
|---|
| | | - 执行人员：management.admin |
|---|
| | | - 执行类型：体系初始化 dry-run |
|---|
| | | - 当前状态：完成，待审核员复核 |
|---|
| | | |
|---|
| | | ## 1. 固定执行口径 |
|---|
| | | ### 执行步骤 |
|---|
| | | |
|---|
| | | - 维护方式：append-only；每次执行、重跑、人工操作、异常处理都追加到文件末尾，最新内容在最后。 |
|---|
| | | - 历史 run 处理：不得删除；失败 run 标记失败/降读/暂停，并保留结果包或失败证据入口。 |
|---|
| | | - 执行前置：对应实验设计必须已通过设计审核，除非明确是探索性预跑或环境 smoke。 |
|---|
| | | - 路径规则：项目内文件默认使用相对路径。 |
|---|
| | | 1. 读取 `../../common/exp-doc/实验环境创建指南.md`。 |
|---|
| | | 2. 参考 common 创建指南要求，按项目本地入口、账本和审计链路重建实验体系文档。 |
|---|
| | | 3. 重写 `exp-doc/` 本地入口文档，避免把 common 全文复制成项目文档。 |
|---|
| | | 4. 确认 `exp-data/raw/`、`exp-data/result/`、`exp-data/img/`、`exp-data/tmp/` 存在。 |
|---|
| | | 5. 记录初始化 dry-run 到 `实验总纲.md`、`实验设计.md`、`实验审计报告.md`。 |
|---|
| | | |
|---|
| | | ## 2. 执行日志追加区 |
|---|
| | | ### 产物 |
|---|
| | | |
|---|
| | | > 从这里开始按时间顺序追加。执行日志可以简洁，但必须写清输入、关键中间过程、中间数据位置、输出、关键计数、异常和下一步。 |
|---|
| | | - `exp-doc/目录导读.md` |
|---|
| | | - `exp-doc/实验规范.md` |
|---|
| | | - `exp-doc/实验审计规范.md` |
|---|
| | | - `exp-doc/实验审核规范.md` |
|---|
| | | - `exp-doc/实验存储体系.md` |
|---|
| | | - `exp-doc/实验总纲.md` |
|---|
| | | - `exp-doc/实验设计.md` |
|---|
| | | - `exp-doc/实验执行日志.md` |
|---|
| | | - `exp-doc/实验审计报告.md` |
|---|
| | | - `exp-doc/实验问题记录.md` |
|---|
| | | |
|---|
| | | ## <YYYY-MM-DD HH:mm:ss> <run_id>：<实验名称> |
|---|
| | | ### 结论边界 |
|---|
| | | |
|---|
| | | - 实验事项 ID：<填写> |
|---|
| | | - 实验设计 ID：<填写> |
|---|
| | | - 执行人：<填写> |
|---|
| | | - 执行类型：<正式执行/重跑/抽样/smoke/人工操作/复验> |
|---|
| | | - 当前状态：<运行中/成功/失败/中断/暂停/降读> |
|---|
| | | - 结果包目录：<路径> |
|---|
| | | 本 run 只证明体系文档链路已按指南补齐，不证明任何股市业务结论。 |
|---|
| | | |
|---|
| | | ### 执行动作 |
|---|
| | | |
|---|
| | | - 执行入口：<脚本路径、命令、人工流程或工具名> |
|---|
| | | - 工作目录：<路径/不适用> |
|---|
| | | - 关键参数：<填写> |
|---|
| | | - 配置版本：<配置路径、hash 或摘要；如不适用说明> |
|---|
| | | |
|---|
| | | ### 输入 |
|---|
| | | |
|---|
| | | - 输入快照/数据版本：<路径、hash、日期或版本；如不适用说明> |
|---|
| | | - 上游依赖：<设计 ID、前序 run、外部文件、人工回执> |
|---|
| | | |
|---|
| | | ### 执行过程流水 |
|---|
| | | |
|---|
| | | > 必填。不要只写“已跑完”。每个能影响结论的关键节点都要有记录；如果节点产生中间数据，必须写路径。中间数据若后续审计需要复核，应保存到 `exp-data/result/<run_id>/intermediate/` 或等价正式结果包目录，不要只留在临时目录。 |
|---|
| | | |
|---|
| | | | step_id | 时间 | 动作 | 输入/依赖 | 中间数据或输出 | 关键计数/校验 | 状态 | 备注 | |
|---|
| | | |---|---|---|---|---|---|---|---| |
|---|
| | | | STEP-001 | <时间> | <读取/冻结输入> | <路径> | <路径> | <row_count/hash> | <PASS/FAIL/HELD> | <说明> | |
|---|
| | | | STEP-002 | <时间> | <清洗/特征/聚合/筛选/人工标注等关键处理> | <路径> | <路径> | <row_count/hash> | <PASS/FAIL/HELD> | <说明> | |
|---|
| | | | STEP-003 | <时间> | <生成结果/图片/报告> | <路径> | <路径> | <row_count/count/hash> | <PASS/FAIL/HELD> | <说明> | |
|---|
| | | |
|---|
| | | ### 输出 |
|---|
| | | |
|---|
| | | - summary/readout：<路径> |
|---|
| | | - 核心输出表：<路径> |
|---|
| | | - 中间表/中间结果：<路径；如无，说明为什么不需要> |
|---|
| | | - 核心图表或可视化：<路径> |
|---|
| | | - manifest/hash：<路径> |
|---|
| | | - 其他产物：<路径> |
|---|
| | | |
|---|
| | | ### 关键计数和自检 |
|---|
| | | |
|---|
| | | | 检查项 | 目标 | 实际结果 | 状态 | 证据路径 | |
|---|
| | | |---|---|---|---|---| |
|---|
| | | | <字段存在/行数合理/样本覆盖/图路径存在/无未来函数等按目标需要的检查> | <填写> | <填写> | <PASS/FAIL/HELD/不适用> | <路径> | |
|---|
| | | |
|---|
| | | ### 偏离、异常和处理 |
|---|
| | | |
|---|
| | | - 是否偏离设计：<否/是；说明> |
|---|
| | | - 异常：<无/说明> |
|---|
| | | - 影响范围：<无/步骤/结果包/结论> |
|---|
| | | - 处理动作：<无/补跑/重跑/降读/暂停> |
|---|
| | | - 是否需要复审：<是/否> |
|---|
| | | |
|---|
| | | ### 当前读法和下一步 |
|---|
| | | |
|---|
| | | - 当前读法：<PASS/FAIL/HELD/降读/失效> |
|---|
| | | - 不能读成：<防止过读> |
|---|
| | | - 下一步：<提交执行审核/补数据/重跑/回写总纲/暂停> |
|---|
