From e87cfdcb76a359d217130b33ffb4ed917b64d230 Mon Sep 17 00:00:00 2001 From: 1 <wentingyear@gmail.com> Date: Thu, 25 Jun 2026 20:56:54 +0800 Subject: [PATCH] fix: rebuild project-info system documents --- exp-doc/实验执行日志.md | 105 +++++++++++++++------------------------------------- 1 files changed, 31 insertions(+), 74 deletions(-) diff --git "a/exp-doc/\345\256\236\351\252\214\346\211\247\350\241\214\346\227\245\345\277\227.md" "b/exp-doc/\345\256\236\351\252\214\346\211\247\350\241\214\346\227\245\345\277\227.md" index be86605..4e4709e 100644 --- "a/exp-doc/\345\256\236\351\252\214\346\211\247\350\241\214\346\227\245\345\277\227.md" +++ "b/exp-doc/\345\256\236\351\252\214\346\211\247\350\241\214\346\227\245\345\277\227.md" @@ -1,84 +1,41 @@ -# 实验执行日志模版 +# 实验执行日志 -创建人员：<填写创建人员或 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/降读/失效> -- 不能读成：<防止过读> -- 下一步：<提交执行审核/补数据/重跑/回写总纲/暂停> -- Gitblit v1.9.3