# 案例执行日志

创建人员：management.admin  
文件职责：记录 `project-info` 项目案例分析执行过程、关键节点、数据和证据路径。  
管理规范/模板：../../common/ana-doc/案例执行日志模版.md；../../common/ana-doc/案例分析环境创建指南.md。  
引用文件：案例分析规范.md；案例总纲.md；案例分析设计.md；案例审计报告.md；案例存储体系.md。  
记录方式：append-only 执行日志；每次案例执行、重跑或修复追加记录。

## 1. 当前执行总览

| 日志 ID | 所属设计 | 案例范围 | 状态 | 结果包 | 审计 |
|---|---|---|---|---|---|
| `RUN-ANA-SMOKE-001` | `DESIGN-ANA-SMOKE-001` | 案例体系初始化 dry-run | 完成，待审核员复核 | 无真实结果包 | `AUDIT-ANA-SMOKE-001` |
| `RUN-ANA-REPORT-SYSTEM-20260625-001` | `DESIGN-ANA-REPORT-SYSTEM-20260625-001` | 研报体系接入 ana-doc | 已执行，待审核员复核 | 文档体系更新 | `AUDIT-ANA-REPORT-SYSTEM-20260625-001` |
| `RUN-ANA-ISSUE-BOUNDARY-20260625-001` | `DESIGN-ANA-REPORT-SYSTEM-20260625-001` | 案例问题记录边界规范维护 | 已完成，待审核员复核 | 规范和结果包口径更新 | 待复核 |
| `RUN-ANA-INDUSTRY-CONTAINER-20260625-001` | `DESIGN-ANA-REPORT-SYSTEM-20260625-001` | 行业容器结构调整 / 有色 raw 池迁移 | 已完成，待审核员复核 | 有色 pilot manifest 路径更新 | 待复核 |
| `RUN-ANA-SEMI-REGISTER-001` | `DESIGN-ANA-SEMI-CONTAINER-001` | 半导体父级登记、行业容器、方案和一期设计入口 | 已完成建档，待独立审核 | 无正式结果包 | 行业目录三项审核待执行 |

## 2. 执行记录模板

### <YYYY-MM-DD HH:mm:ss> <LOG-ID>：<执行标题>

所属案例事项：  
<ANA-ID>

关联设计：  
<DESIGN-ID>

执行人员：  
<执行人员>

执行目标：  
<本次执行要完成什么>

输入：  
<方法论文档、候选池、数据源、图片源、上游结果>

执行过程：

1. <关键步骤 1>
2. <关键步骤 2>

关键节点记录：

| 节点 | 说明 | 数据路径 | 图片路径 | 结论 |
|---|---|---|---|---|
| 候选来源 | <如何得到候选> | <path> | <path> | <结论> |
| 案例选择 | <为什么选这些案例> | <path> | <path> | <结论> |
| 关键判断 | <按什么规则判断> | <path> | <path> | <结论> |
| 结果复盘 | <最终结果> | <path> | <path> | <结论> |

逐案例证据链记录：

| 案例 ID | 候选来源 | 入选理由 | 背景证据 | 关键判断 / 操作 | 数据路径 | 图片路径 | 结果 | 是否符合设计 |
|---|---|---|---|---|---|---|---|---|
| <CASE-ID> | <候选池或上游来源> | <为什么选中> | <背景数据或背景图> | <按设计逐步记录关键判断或操作> | <path> | <path> | <结果> | 是 / 否；如否说明偏离 |

输出：  
<结果包、表、图片、readout、summary>

偏离设计：  
<如无写“无”；如有，说明原因和影响>

自检结果：  
<文件是否存在、行数是否合理、图片是否可读、关键证据是否齐全>

执行结果 / 结论回写：  
<本次执行最终结果；如影响案例总纲或设计，写明已回写位置或待回写原因>

当前状态：  
完成 / 部分完成 / 失败 / 暂缓

审计入口：  
<案例审计报告.md 中 AUDIT-ID>

## 2026-06-25 RUN-ANA-SMOKE-001

- run ID：RUN-ANA-SMOKE-001
- 所属案例：ANA-SMOKE-001
- 关联设计：DESIGN-ANA-SMOKE-001
- 执行人员：management.admin
- 执行类型：体系初始化 dry-run
- 当前状态：完成，待审核员复核

### 执行步骤

1. 读取 `../../common/ana-doc/案例分析环境创建指南.md`。
2. 参考 common 创建指南要求，按项目本地入口、账本和审计链路重建案例体系文档。
3. 重写 `ana-doc/` 本地入口文档，避免把 common 全文复制成项目文档。
4. 确认 `ana-data/cases/`、`ana-data/result/`、`ana-data/img/`、`ana-data/tmp/` 存在。
5. 记录初始化 dry-run 到 `案例总纲.md`、`案例分析设计.md`、`案例审计报告.md`。

### 产物

- `ana-doc/目录导读.md`
- `ana-doc/案例分析规范.md`
- `ana-doc/案例审核规范.md`
- `ana-doc/案例存储体系.md`
- `ana-doc/案例总纲.md`
- `ana-doc/案例分析设计.md`
- `ana-doc/案例执行日志.md`
- `ana-doc/案例审计报告.md`
- `ana-doc/案例问题记录.md`

### 结论边界

本 run 只证明体系文档链路已按指南补齐，不证明任何股市业务结论。

## 2026-06-25 RUN-ANA-REPORT-SYSTEM-20260625-001

- run ID：RUN-ANA-REPORT-SYSTEM-20260625-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 关联设计：DESIGN-ANA-REPORT-SYSTEM-20260625-001
- 执行人员：Codex
- 执行类型：研报体系接入 ana-doc
- 当前状态：已执行，待审核员复核

### 执行步骤

1. 读取父级 `ana-doc/` 现有规范、审核规范、存储体系和目录导读。
2. 读取 mirror 本地研报体系建设方案和研报核心文档，确认“融入 ana，不替换 ana”的原则。
3. 创建 `ana-doc/研报体系/`。
4. 迁入 `研报解析架构.md` 和 `研报分析架构.md`，并在项目内版本中补充 `project-info` 接入口径。
5. 未创建独立 `ana-doc/研报体系/研报存储体系.md`；将研报存储规则写入父级 `案例存储体系.md`。
6. 重写父级 `案例分析规范.md`，补充研报体系接入流程、新行业创建流程、行业子规范优先级、记录落点和 darkline 外部信息规则。
7. 重写父级 `案例审核规范.md`，补充研报案例审核类型、高风险问题、证据抽查、阻断项和审计记录位置。
8. 重写父级 `案例存储体系.md`，补充研报类案例目录、manifest、状态、结构化数据底座、行业扩展表、暗线分账和追溯链路。
9. 重写父级 `目录导读.md`，登记研报体系方法母版、数据目录和行业案例入口。
10. 同步 `ana-doc/有色案例/` 下子规范、存储体系、分析设计和 `有色研报解析方案.md`，移除旧 mirror 临时路径和独立研报存储母版引用。
11. 创建 `ana-data/cases/有色案例/.gitkeep`，保留有色案例数据分组入口。

### 产物

- `ana-doc/研报体系/研报解析架构.md`
- `ana-doc/研报体系/研报分析架构.md`
- `ana-doc/目录导读.md`
- `ana-doc/案例分析规范.md`
- `ana-doc/案例审核规范.md`
- `ana-doc/案例存储体系.md`
- `ana-doc/有色案例/目录导读.md`
- `ana-doc/有色案例/案例分析规范.md`
- `ana-doc/有色案例/案例审核规范.md`
- `ana-doc/有色案例/案例存储体系.md`
- `ana-doc/有色案例/案例分析设计.md`
- `ana-doc/有色案例/有色研报解析方案.md`
- `ana-data/cases/有色案例/.gitkeep`

### 未执行事项

1. 未迁移历史有色研报资料。
2. 未执行 30 份 PDF 试运行。
3. 未生成行业投资结论。
4. 未修改 common 规范。

### 自检

1. `ana-doc/研报体系/` 下未创建独立 `研报存储体系.md`。
2. 旧 mirror 本地路径未作为正式执行入口保留在 `ana-doc`。
3. 通用存储体系未固化有色、矿区等行业专属表。
4. 有色案例子规范已声明继承父级同名文档和父级存储体系。

## 2026-06-25 RUN-ANA-ISSUE-BOUNDARY-20260625-001

- run ID：RUN-ANA-ISSUE-BOUNDARY-20260625-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 关联设计：DESIGN-ANA-REPORT-SYSTEM-20260625-001
- 执行人员：Codex
- 执行类型：案例问题记录边界规范维护
- 当前状态：已完成，待审核员复核

### 执行步骤

1. 复查 common 案例体系中 `案例问题记录模版.md`、`案例分析规范.md`、`案例分析环境创建指南.md`、`目录导读.md` 和 `案例总纲模版.md` 的问题记录口径。
2. 将“执行者自发现且能在本轮或本案例内处理的问题”明确排除在 `案例问题记录.md` 之外。
3. 同步更新 `project-info/ana-doc` 父级本地规范、审核规范、目录导读和案例问题记录。
4. 同步更新 `ana-doc/有色案例/` 的分析设计、审核规范、目录导读、执行日志、审计报告和案例问题记录。
5. 将 `ANA-YS-INDUSTRY-001` 中 PyMuPDF/fitz 缺失和旧铜铝目录无扩展名文件从有色案例问题记录迁回执行日志、验证报告和数据缺口表。

### 产物

- `../../common/ana-doc/案例问题记录模版.md`
- `../../common/ana-doc/案例分析规范.md`
- `../../common/ana-doc/案例分析环境创建指南.md`
- `../../common/ana-doc/目录导读.md`
- `../../common/ana-doc/案例总纲模版.md`
- `ana-doc/案例分析规范.md`
- `ana-doc/案例审核规范.md`
- `ana-doc/目录导读.md`
- `ana-doc/案例问题记录.md`
- `ana-doc/有色案例/案例分析设计.md`
- `ana-doc/有色案例/案例审核规范.md`
- `ana-doc/有色案例/目录导读.md`
- `ana-doc/有色案例/案例执行日志.md`
- `ana-doc/有色案例/案例审计报告.md`
- `ana-doc/有色案例/案例问题记录.md`
- `ana-data/cases/有色案例/ANA-YS-INDUSTRY-001/outputs/summary.md`
- `ana-data/cases/有色案例/ANA-YS-INDUSTRY-001/outputs/validation_report.md`

### 自检

1. 执行者自发现且可处理的问题，落点为执行日志、自检、验证报告、manifest、数据缺口表或结果包。
2. `案例问题记录.md` 只承接外部反馈、执行者无法自行闭环、需跨轮/跨角色跟踪的非审计问题，以及审计问题索引。
3. 有色案例问题记录当前无有效问题记录。

## 2026-06-25 RUN-ANA-INDUSTRY-CONTAINER-20260625-001

- run ID：RUN-ANA-INDUSTRY-CONTAINER-20260625-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 关联设计：DESIGN-ANA-REPORT-SYSTEM-20260625-001
- 执行人员：Codex
- 执行类型：行业容器结构调整 / 有色 raw 池迁移
- 当前状态：已完成，待审核员复核

### 执行步骤

1. 将行业目录规则从“行业目录自带案例总纲”调整为“父级 `案例总纲.md` 是唯一案例总账，行业目录只是容器”。
2. 更新父级 `案例分析规范.md`、`案例审核规范.md`、`案例存储体系.md` 和 `目录导读.md`。
3. 将 `ana-doc/有色案例/案例总纲.md` 中的 `ANA-YS-TEMPLATE-001` 和 `ANA-YS-INDUSTRY-001` 迁入父级 `案例总纲.md`。
4. 删除 `ana-doc/有色案例/案例总纲.md`。
5. 更新 `ana-doc/有色案例/` 下目录导读、分析规范、审核规范、存储体系、分析设计、执行日志、审计报告、问题记录和有色研报解析方案。
6. 将 `ANA-YS-INDUSTRY-001` 的 30 个 raw PDF 从 `ana-data/cases/有色案例/ANA-YS-INDUSTRY-001/raw/` 迁移到行业统一 raw 池 `ana-data/cases/有色案例/raw/`。
7. 更新 pilot 的 `artifact_manifest.csv`、`source_document.csv`、`migration_manifest.csv`、`conversion_status.csv`、`evidence_index.csv` 和校验清单，补充 `batch_id=BATCH-001`、`run_id=RUN-ANA-YS-INDUSTRY-001-BATCH-001` 并修正 raw 路径。

### 自检

1. 行业容器目录不再维护 `案例总纲.md`。
2. 父级 `案例总纲.md` 已承接有色模板初始化和 pilot 试运行两个案例事项。
3. 有色 raw 文件已统一在 `ana-data/cases/有色案例/raw/`。
4. 逐案例目录继续保留 converted、extracted、supplement、evidence、outputs、manifest 和 tmp。

## 2026-06-26 RUN-ANA-FLOW-SUPPLEMENT-CAP-20260626-001

- run ID：RUN-ANA-FLOW-SUPPLEMENT-CAP-20260626-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 执行人员：case_analysis.analyst
- 执行类型：案例分析流程规范维护
- 当前状态：已完成，待审核员复核

### 背景

有色行业研报分析进入多轮补证后，出现围绕 PDF 转换、网页归档、外部来源和公司官方源持续补证的流程拖延风险。用户要求调整 ana-doc 案例分析流程：补材料最多 3 次；若仍不足，应带缺口继续推进，而不是陷入无限补材料循环。

### 执行步骤

1. 在 `ana-doc/案例分析规范.md` 的主动补数据流程中新增“补资料轮次上限”：同一案例、同一类证据缺口或同一组相关缺口最多 3 轮补证。
2. 明确 3 轮仍不足时，剩余缺口必须写入缺口表、证据卡、result_index 或核心文档证据边界，并使用 `DATA_GAP_REVIEW`、`DATA_PARTIAL`、`HELD_BY_ENV`、`HELD_BY_ACCESS`、`HELD_BY_EVIDENCE_GAP` 或等价状态降级。
3. 明确第 4 轮及以后只在新资料、新权限、环境恢复、前三轮执行错误或核心文档完全不可读等例外情况下启动。
4. 在核心文档输出流程中新增补证上限后的输出口径：可以继续输出 `DRAFT_FOR_REVIEW`，但必须列明补证轮次、剩余缺口和降级状态。
5. 在 `ana-doc/案例审核规范.md` 中新增补证轮次上限审核口径，要求审核员检查缺口是否正确降级和可追溯，而不是无限要求继续补资料。
6. 在 `ana-doc/目录导读.md` 更新 `案例分析规范.md` 和 `案例审核规范.md` 的职责摘要。

### 修改文件

1. `ana-doc/案例分析规范.md`
2. `ana-doc/案例审核规范.md`
3. `ana-doc/目录导读.md`
4. `ana-doc/案例执行日志.md`

### 边界

1. 本次只修改项目本地 ana-doc 流程规则，不修改 common 规范。
2. 本次不把任何有色行业 DRAFT 产物升级为正式结论。
3. 对外正式结论、公司投资读法或交付仍需按输出审核或执行审核通过后进行。

## 2026-06-26 RUN-ANA-FLOW-SUPPLEMENT-CAP-GAP-LIST-20260626-001

- run ID：RUN-ANA-FLOW-SUPPLEMENT-CAP-GAP-LIST-20260626-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 执行人员：case_analysis.analyst
- 执行类型：案例分析流程规范维护 / 行业待补资料清单规则
- 当前状态：已完成，待审核员复核

### 背景

用户进一步明确：缺的材料补 3 次后，应记录到行业案例文件夹下的专门文档；后续人工或用户需要补数据时，再从该文档提取给出，主流程继续往前走，不能卡住。

### 执行步骤

1. 在 `ana-doc/案例分析规范.md` 的补资料轮次上限中新增行业待补资料清单规则。
2. 明确 3 轮后仍缺的资料统一登记到 `ana-doc/<行业案例>/待补资料清单.md` 或等价行业级清单。
3. 明确写入清单后继续推进核心文档和下一阶段工作；后续用户或人工索取需要补的数据时，再从清单提取反馈。
4. 更新 `ana-doc/目录导读.md`，把 `待补资料清单.md` 纳入行业案例目录最低文件。
5. 更新 `ana-doc/有色案例/目录导读.md`，登记有色 `待补资料清单.md` 职责。
6. 新建 `ana-doc/有色案例/待补资料清单.md`，承接当前有色 PASS-018 后的 PDF 原页、市场来源、公司官方源、券商观点分账和公司证据卡字段化待补资料。

### 修改文件

1. `ana-doc/案例分析规范.md`
2. `ana-doc/目录导读.md`
3. `ana-doc/有色案例/目录导读.md`
4. `ana-doc/有色案例/待补资料清单.md`
5. `ana-doc/案例执行日志.md`

### 边界

1. 本次只补充流程规则和当前有色待补资料入口，不重启 PASS-017 或新增补证 PASS。
2. 有色核心文档仍保持 `DRAFT_FOR_REVIEW`，不升级正式行业结论、公司结论、指标或交易建议。
3. 若后续用户补充新资料，可按新资料或第 4 轮例外规则重新进入设计、执行和审核。

## 2026-06-26 08:32:00 RUN-ANA-FLOW-SUPPLEMENT-CAP-GAP-LIST-FIX-001

- run ID：RUN-ANA-FLOW-SUPPLEMENT-CAP-GAP-LIST-FIX-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 执行人员：case_analysis.analyst
- 执行类型：案例审核规范修复 / 行业待补资料清单审核闭环
- 当前状态：已完成，待审核员复核
- 关联审计：AUDIT-ANA-FLOW-SUPPLEMENT-CAP-GAP-LIST-20260626-001

### 背景

审核员对 `RUN-ANA-FLOW-SUPPLEMENT-CAP-GAP-LIST-20260626-001` 复审后指出：父级 `案例分析规范.md` 已补行业 `待补资料清单.md` 规则，但 `案例审核规范.md` 未同步写入审核硬口径，存在审核链路继续按旧规则要求第 4 轮、第 5 轮补证的风险。

### 修复动作

1. 更新 `ana-doc/案例审核规范.md` 的“补证轮次上限审核口径”。
2. 明确已达 3 轮的缺口，审核员必须优先核查行业 `待补资料清单.md` 或等价清单。
3. 明确清单已记录缺口组、已补轮次、影响范围、降级状态、后续所需资料、证据入口和更新时间，且核心文档或 result_index 能反查时，不得因清单未清空而要求同类第 4 轮补证。
4. 明确第 4 轮例外必须限于新资料、新权限、环境恢复、前三轮执行错误或核心文档完全不可读，并核查最小补证目标和设计/执行日志例外依据。
5. 更新输出审核条款，要求对已达 3 轮补证上限的缺口检查行业待补资料清单入口。

### 边界

1. 本次只修复审核规范闭环，不重启 PASS-017。
2. 不新增同类补证 PASS，不围绕有色旧缺口继续补材料。
3. 不把有色 DRAFT 输出升级为正式行业结论、公司结论、指标或交易建议。

## 2026-06-26 08:54:00 RUN-ANA-FLOW-CHINESE-OUTPUT-REQUIREMENT-001

- run ID：RUN-ANA-FLOW-CHINESE-OUTPUT-REQUIREMENT-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 执行人员：case_analysis.analyst
- 执行类型：案例分析流程规范维护 / 输出文档中文要求
- 当前状态：已完成，待审核员复核

### 背景

用户要求在 `ana-doc/案例分析规范.md` 中写清楚：输出的所有文档必须要求是中文；随后进一步明确文件名也必须用中文。该规则用于避免后续核心文档、用户可读稿、结果入口或交付草稿出现英文主体内容或英文主文件名。

### 执行步骤

1. 在 `ana-doc/案例分析规范.md` 的“核心文档输出流程”中新增输出语言要求。
2. 明确所有给用户、审核员或结果入口使用的人读文档正文必须使用中文表达。
3. 追加明确人读输出文件名也必须使用中文；新建或重命名人读输出文件时，优先使用中文文件名。
4. 明确英文只允许作为代码、字段名、文件路径、命令、指标缩写、证券代码、公司/机构英文名、原文短引或不可翻译术语保留。
5. 明确脚本、代码、数据库表、CSV 字段清单、manifest、schema、hash 清单、工具输出、第三方原始文件名、历史已引用路径和自动化兼容固定文件名可以保留英文，但人读索引或说明必须有中文标题和中文解释。
6. 明确原始资料为英文或中英混排时，输出文档仍必须给中文解释和中文结论边界。

### 修改文件

1. `ana-doc/案例分析规范.md`
2. `ana-doc/案例执行日志.md`

### 边界

1. 本次只修改项目本地 ana 流程规范，不修改 common 规范。
2. 本次不改写现有有色 DRAFT 研究内容，不升级正式结论。
3. 本次不批量重命名历史已引用文件，避免破坏 result_index、manifest 和审核证据链；后续新增人读输出文件按中文文件名执行，历史英文主文件名在下一轮输出整理中逐步提供中文文件名或中文索引别名。

## 2026-06-26 20:11:00 RUN-ANA-FLOW-CORE-DOC-STRUCTURE-ALIGN-001

- run ID：RUN-ANA-FLOW-CORE-DOC-STRUCTURE-ALIGN-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 执行人员：case_analysis.analyst
- 执行类型：研报分析架构维护 / 核心文档结构对齐
- 当前状态：已完成，待审核员复核

### 背景

用户要求参考 `D:\策略项目\s-system-doc\observer\mirror\有色行业报告` 中另一个研报分析输出目录。该目录里带日期、数字或批次编号的文档属于临时过程材料；不带数字的索引、总览、子行业、公司、数据表和暗线文档才是用户期望的核心文档结构。

### 执行步骤

1. 抽查 mirror 目录中的核心文档结构，确认用户期望的人读主结构为：行业报告索引、产业链总览、市场情况总览、子行业总览、子行业详细介绍、公司横向同步总表、单公司页、数据表、暗线、公开信息补充清单和待补资料清单。
2. 更新 `ana-doc/研报体系/研报分析架构.md`，明确带日期、批次号、run ID 或数字编号的读取报告只能作为过程文档，不能替代核心文档主入口。
3. 更新 `ana-doc/研报体系/研报解析架构.md`，把三类核心文档进一步落到稳定中文文件名和目录形态。
4. 更新 `ana-doc/有色案例/有色研报解析方案.md`，将有色案例输出结构对齐为 `有色行业报告索引.md`、`有色的产业链总览.md`、`有色的市场情况总览.md`、`子行业/`、`公司/`、`数据表/`、`暗线/` 等人读核心文档。

### 边界

1. 本轮是输出架构对齐，不重启 PASS-017，不新增同类补证 PASS。
2. 本轮不把有色 DRAFT 草稿升级为正式行业结论、正式公司结论、正式指标或交易建议。
3. 后续有色用户阅读主入口应按中文核心文档目录迁移；现有综合草稿只作为过渡稿和证据入口。

## 2026-06-26 20:18:00 RUN-ANA-FLOW-CORE-DOC-STRUCTURE-ALIGN-FIX-001

- run ID：RUN-ANA-FLOW-CORE-DOC-STRUCTURE-ALIGN-FIX-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 执行人员：case_analysis.analyst
- 执行类型：研报分析架构维护 / 核心文档结构复审修复
- 当前状态：已完成，待审核员复核
- 关联审计：AUDIT-ANA-FLOW-CORE-DOC-STRUCTURE-ALIGN-20260626-001
- 关联消息：msg_20260626201845828_e9635105

### 背景

审核员对 `RUN-ANA-FLOW-CORE-DOC-STRUCTURE-ALIGN-001` 返回“需补充”，指出两处口径冲突：`研报解析架构.md` 中仍有“现在能不能买”措辞；`有色研报解析方案.md` 中仍写“顶层只允许行业视图、市场视图、公司视图三类核心文档”。用户随后补充要求子行业层级还需要单独的市场视角文件 `子行业市场分析.md`。

### 修复动作

1. 更新 `ana-doc/研报体系/研报解析架构.md`，将“现在能不能买”改为“当前处于观察、等待、回避、补证还是不可判断状态，什么条件触发状态变化，什么情况需要降级”。
2. 更新 `ana-doc/研报体系/研报解析架构.md` 和 `ana-doc/研报体系/研报分析架构.md`，将 `子行业/<子行业>_市场分析.md` 纳入核心文档目录、阅读顺序和最低结构。
3. 更新 `ana-doc/有色案例/有色研报解析方案.md`，将“三类核心文档”表述修正为“三类视图是分析视角，稳定中文文件名和目录是承载形态”。
4. 更新 `ana-doc/有色案例/有色研报解析方案.md`，把 `子行业/<金属或板块>_市场分析.md` 纳入有色核心文档清单和验收要求。

### 边界

1. 本轮只修复文档口径和子行业市场分析文件结构，不补新资料。
2. 本轮不重启 PASS-017，不新增同类补证 PASS。
3. 本轮不把有色 DRAFT 草稿升级为正式行业结论、正式公司结论、正式指标或交易建议。

## 2026-06-26 20:48:00 RUN-ANA-FLOW-MASTER-PLAN-BOUNDARY-001

- run ID：RUN-ANA-FLOW-MASTER-PLAN-BOUNDARY-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 执行人员：case_analysis.analyst
- 执行类型：案例分析规范维护 / 研报母版和行业方案边界
- 当前状态：已完成，待审核员复核

### 背景

用户明确：`ana-doc/研报体系/研报解析架构.md` 是所有研报解析文档的母版和指导思想，以后不能作为具体行业输出结构、文件清单或执行细节的日常修改位置。具体行业怎么设计输出文档架构、准备怎么做、怎么实施，以行业本地方案文档为准；有色案例以 `ana-doc/有色案例/有色研报解析方案.md` 为准。

### 修改动作

1. 更新 `ana-doc/案例分析规范.md`，新增“母版和行业方案边界”规则。
2. 明确 `研报体系/研报解析架构.md` 是方法母版，行业输出结构、子行业拆分、公司范围、数据表、暗线入口和执行策略优先落到 `<行业>研报解析方案.md`。
3. 更新 `ana-doc/案例审核规范.md`，要求审核员发现行业输出结构不清时，优先要求修复行业方案和案例设计，不直接要求修改母版。
4. 更新 `ana-doc/目录导读.md`，说明方法母版不因单个行业的实施细节调整而修改。
5. 更新 `ana-doc/有色案例/有色研报解析方案.md`，明确有色具体实施以本方案和已审核设计为准。

### 边界

1. 本轮不修改 `ana-doc/研报体系/研报解析架构.md`。
2. 本轮不生成新的有色核心文档正文，不补新资料。
3. 本轮只建立后续规范边界；如确需修改母版，必须另起母版级维护事项，说明跨行业影响范围并提交复审。

## 2026-06-26 23:12:00 RUN-ANA-FLOW-SOURCE-CHAT-LIGHTWEIGHT-001

- run ID：RUN-ANA-FLOW-SOURCE-CHAT-LIGHTWEIGHT-001
- 所属案例：ANA-REPORT-SYSTEM-20260625-001
- 执行人员：case_analysis.analyst
- 执行类型：案例分析规范维护 / 来源聊天记录轻量入口
- 当前状态：已完成，待审核员复核

### 背景

用户指出全局规范要求送审上下文必须包含原始聊天记录，而此前送审只提供了背景摘要和文件入口，没有稳定列出原始聊天记录入口。用户要求把防偏差规则写入 `ana-doc` 规范，但明确不希望层层加码。

### 修改动作

1. 更新 `ana-doc/案例分析规范.md`，新增“来源聊天记录轻量入口”。
2. 明确案例事项、行业方案重要变更、设计审核、执行审核、输出审核或复审送审时，必须提供来源聊天记录入口或等价来源入口。
3. 明确来源入口可以是 MB-X `message_id`、会话 marker、原始聊天导出文件路径、管理系统消息记录路径，或其他稳定可复核入口。
4. 明确送审正文只需列明来源入口、覆盖范围、用户原始要求摘要、本次变更和原始要求的对应关系，不要求全文粘贴长聊天。
5. 更新 `ana-doc/案例审核规范.md`，新增来源聊天记录审核口径。
6. 明确审核员只阻断来源缺失、不可打开、覆盖范围不清或目标与来源明显不一致的情况；错别字、格式、链接显示等小修不得因未新建完整聊天证据包而加码退回。

### 边界

1. 本轮只修改父级案例分析和审核规范，不修改有色输出方案，不生成新核心文档正文。
2. 本轮不要求补建所有历史送审的完整聊天证据包；后续送审按轻量入口规则执行。
3. 该规则用于防止送审上下文缺失，不用于制造额外层级、重复归档或繁重证据包。

## 2026-06-26 21:12:00 RUN-ANA-REVIEW-USER-SOURCE-GATE-001

- run ID：RUN-ANA-REVIEW-USER-SOURCE-GATE-001
- 执行人员：case_analysis.reviewer
- 执行类型：案例审核规范维护 / 用户原文入口审核闸门
- 当前状态：完成

### 背景

用户指出：全局/common 案例体系已要求来源聊天记录或上游依据可追踪，审核员也必须判断分析员工作是否符合用户聊天原文，而不能只依据分析员送审摘要。

### 修改动作

1. 更新 `ana-doc/案例审核规范.md` 的“审核前置核查要求”。
2. 明确送审事项引用“用户要求、用户反馈、用户确认、用户补充”等内容时，审核员必须核查用户原文入口：关键聊天原文、聊天记录路径、案例总纲来源位置或可追溯的 `message_id`。
3. 明确只有分析员转述而没有用户原文入口时，不得给出通过结论，应要求补充来源入口。
4. 明确该要求只补来源依据，不要求重跑分析、补资料或新增执行轮次。
5. 明确审核员必须核对送审变更、方案或输出是否符合用户原文意思，并区分用户明确要求、分析员推导和分析员自行新增方案。

### 边界

1. 本轮只补审核闸门，不增加新的分析产物、数据表或执行流程。
2. 本轮不要求重审历史记录；后续新送审和实质复审按该口径执行。
3. 本轮不补资料、不重启 PASS、不改变任何 DRAFT 产物状态。

## 2026-06-27 12:03:00 RUN-ANA-FLOW-READABLE-CONCLUSION-WRITING-001

- run ID：RUN-ANA-FLOW-READABLE-CONCLUSION-WRITING-001
- 执行人员：case_analysis.analyst
- 执行类型：案例分析规范维护 / 核心文档结论先行和逐步解释写法
- 当前状态：已完成，待审核员复核

### 背景

用户指出，核心文档中“资源端是当前第一主线”等表达仍然让人费解：结论不清楚，不知道是投资排序、跟踪重点还是数据完整性；解释时存在思维跳跃，应先给清晰结论，再用 1、2、3、4 的顺序说明前因后果、数据如何证明结论、结论对投资研究的含义。用户要求这类通用规则写入 ana-doc 规范，行业专属案例写入有色本地方案。

### 修改动作

1. 更新 `ana-doc/案例分析规范.md` 的 `5.6 核心文档输出流程`。
2. 新增通用规则：核心正文必须“结论先行、逐步解释”，每个重要章节先说明结论或观察状态，再按顺序解释前因后果，避免思维跳跃。
3. 新增通用规则：每个结论后的证据展开必须回答数据是什么、证明什么、为什么能证明、对行业/市场/产业链/公司研究有什么含义。
4. 更新 `ana-doc/有色案例/有色研报解析方案.md`，加入有色具体写法案例，说明“资源端第一主线”应写成“最优先跟踪的研究主线，不等于买入排序”。
5. 有色示例明确三条线索应分别说明价格库存、矿山产量权益、成本和项目达产如何支撑研究优先级。

### 边界

1. 本轮不修改 `ana-doc/研报体系/研报解析架构.md`。
2. 本轮不改核心正文、不补新资料、不重启 PASS-017、不新增同类旧缺口补证 PASS。
3. 本轮只沉淀写作规则和有色示例，不要求全部历史文档立即重写；后续核心文档返修按该规则分批执行。

### 复审回执

2026-06-27 12:24 审核员返回 `AUDIT-ANA-FLOW-READABLE-CONCLUSION-WRITING-20260627-001`，结论为通过。允许“核心文档结论先行、逐步解释、含义落地”写作规则作为后续 `project-info` ana 核心文档返修和审核口径使用。通过范围仅覆盖规范和方案示例，不代表既有核心正文已自动修复。

## 2026-06-27 12:31:00 RUN-ANA-FLOW-CORE-PRINCIPLE-CHECK-001

- run ID：RUN-ANA-FLOW-CORE-PRINCIPLE-CHECK-001
- 执行人员：case_analysis.analyst
- 执行类型：案例分析规范维护 / 核心理念逐篇复查流程
- 当前状态：已完成，待审核员复核

### 背景

用户建议在核心文档写作流程中增加复查流程：拿每一个输出文本对照 `研报解析架构.md`，尤其是其中“核心理念”章节，检查是否真正符合普通用户能看懂、结论有数据和案例、前因后果讲清楚、市场数据有解释等要求；不符合就改。

### 修改动作

1. 更新 `ana-doc/案例分析规范.md` 的 `5.6 核心文档输出流程`。
2. 新增通用规则：核心文档写完或每轮实质返修后，必须逐篇对照 `研报体系/研报解析架构.md` 的“核心理念”做复查。
3. 明确复查至少检查六点：普通人能否看懂、关键结论和流程是否展开、是否有数据和案例、前因后果是否清楚、多因素是否横向对比、市场/行业关键数据是否既有数据也有解释。
4. 明确复查不要求新增复杂产物；不符合的段落在本轮直接修改或标记为降级/待补。
5. 更新 `ana-doc/有色案例/有色研报解析方案.md`，把该复查流程落为有色核心文档逐篇复查口径。

### 边界

1. 本轮不修改 `ana-doc/研报体系/研报解析架构.md`。
2. 本轮不直接重写核心正文，不补新资料，不重启 PASS-017，不新增同类旧缺口补证 PASS。
3. 本轮只补写作复查流程；后续正文返修按小范围批次执行。

### 复审回执

2026-06-27 12:30 审核员返回 `AUDIT-ANA-FLOW-CORE-PRINCIPLE-CHECK-20260627-001`，结论为通过。允许“核心文档逐篇对照 `研报解析架构.md` 核心理念复查流程”作为后续 `project-info` ana 核心文档返修和审核口径使用。通过范围仅覆盖流程规则，不代表既有核心正文已完成复查和返修。

## 2026-07-03 00:00:00 RUN-ANA-ROBOT-INDUSTRY-REGISTER-001

- run ID：RUN-ANA-ROBOT-INDUSTRY-REGISTER-001
- 所属案例：ANA-ROBOT-INDUSTRY-001
- 执行人员：case_analysis.analyst
- 执行类型：父级案例登记 / 行业容器接入准备
- 当前状态：已完成，待审核员复核

### 来源入口

- 来源：当前对话中，人类要求“现在我想把机器人纳入到研报体系中去，应该去完善哪些文档？”、“把这些事情先规划成 TODO 吧”、“输出成 TODO 文件中”、“先去做第一个 TODO 吧”。
- 覆盖范围：机器人行业父级案例登记、父级目录入口补充、是否修改 `研报体系导读.md` 的判断。
- 本次变更和原始要求的对应关系：本轮只执行 TODO 中的“P0：父级体系登记”，不创建机器人行业容器，不改写机器人研究正文。

### 背景

人类已在机器人行业研究中形成较多产业链、市场、公司、软件模型和本体厂阵营相关文档，希望将机器人行业纳入 `project-info/ana-doc` 研报体系，后续按父级总纲、行业容器、行业方案、执行日志、审计和问题记录闭环推进。

### 修改动作

1. 更新 `ana-doc/案例总纲.md`，新增 `ANA-ROBOT-INDUSTRY-001` 当前案例总览行。
2. 更新 `ana-doc/案例总纲.md`，新增“案例事项：ANA-ROBOT-INDUSTRY-001”，登记背景、目标、边界、案例范围、待补设计入口、待补审计入口和结果包入口。
3. 更新 `ana-doc/目录导读.md`，在“行业 / 研究案例目录”中新增 `机器人案例/` 行业容器入口，状态标记为待创建。
4. 更新 `ana-doc/目录导读.md`，在“当前案例入口”中新增 `ANA-ROBOT-INDUSTRY-001`。
5. 判断 `ana-doc/研报体系导读.md` 本轮暂不修改：机器人是新增行业案例和行业容器事项，不改变跨行业研报体系导读的角色阅读顺序、母版边界和通用流程。

### 边界

1. 本轮不创建 `ana-doc/机器人案例/` 目录和行业容器文档。
2. 本轮不修改 `ana-doc/研报体系/研报解析架构.md`、`ana-doc/研报体系/研报分析架构.md` 或 `ana-doc/研报体系导读.md`。
3. 本轮不迁移、不归档、不改写既有机器人研究正文。
4. 本轮不执行新的研报解析、公开资料补充或市场反向补漏。
5. 后续应先完成机器人行业容器和 `机器人研报解析方案.md`，再进行现有研究结果映射和核心文档质量复核。

## 2026-07-03 00:00:00 RUN-ANA-ROBOT-CONTAINER-001

- run ID：RUN-ANA-ROBOT-CONTAINER-001
- 所属案例：ANA-ROBOT-INDUSTRY-001
- 执行人员：case_analysis.analyst
- 执行类型：行业容器创建 / 本地规范入口落地
- 当前状态：已完成，待审核员复核

### 来源入口

- 来源：当前对话中，人类在完成父级登记后要求“下一步 去做吧”。
- 覆盖范围：创建 `ana-doc/机器人案例/` 行业容器、落地基础文档、更新父级目录和案例总纲状态。
- 本次变更和原始要求的对应关系：本轮只执行 TODO 中的“P0：创建机器人行业案例容器”，不迁移既有机器人研究文档，不输出正式机器人行业结论。

### 背景

父级 `案例总纲.md` 已登记 `ANA-ROBOT-INDUSTRY-001`。根据父级 `目录导读.md`，新的行业方向需要创建行业容器文件夹，并至少包含目录导读、分析规范、审核规范、存储体系、案例分析设计、执行日志、审计报告、问题记录、待补资料清单和行业研报解析方案。

### 修改动作

1. 创建 `ana-doc/机器人案例/` 行业容器。
2. 新建 `目录导读.md`、`案例分析规范.md`、`案例审核规范.md`、`案例存储体系.md`、`案例分析设计.md`、`案例执行日志.md`、`案例审计报告.md`、`案例问题记录.md`、`待补资料清单.md`。
3. 新建 `机器人研报解析方案.md` 作为方案入口；正式方案内容留待下一 TODO 完善。
4. 更新父级 `ana-doc/目录导读.md`，将 `机器人案例/` 状态更新为已创建。
5. 更新父级 `ana-doc/案例总纲.md` 中 `ANA-ROBOT-INDUSTRY-001` 当前状态。
6. 更新 `E:/industry/doc/task/202607/0703-机器人纳入研报体系/分析员TODO.md` 中容器创建任务状态。

### 边界

1. 本轮不迁移 `E:/industry/doc/research` 下既有机器人研究文件。
2. 本轮不读取新研报、不执行公开资料补充、不做市场反向补漏。
3. 本轮不把既有机器人研究结果升级为正式体系结论。
4. `机器人研报解析方案.md` 当前只是方案入口，尚不是正式可执行方案。
5. 下一步应完善 `机器人研报解析方案.md`，再冻结正式案例设计。

## 2026-07-22 11:54:37 RUN-ANA-SEMI-REGISTER-001：半导体一期父级登记与行业入口

- 日志 ID：`RUN-ANA-SEMI-REGISTER-001`
- 所属案例：`ANA-SEMI-20260722-001`
- 关联设计：`ana-doc/半导体案例/案例分析设计.md` / `DESIGN-ANA-SEMI-CONTAINER-001`、`DESIGN-ANA-SEMI-SCHEME-V001`、`DESIGN-ANA-SEMI-20260722-001-BATCH-001`
- 执行人员 / 唯一激活角色：`case_analysis.analyst.cai`
- 当前状态：父级登记和入口已完成，待独立审核

### 来源入口

Codex thread `019f8057-49c9-7410-8772-76429bed4909`；用户要求新增半导体行业调研，并明确启动“半导体一期建档与设计”。

### 修改动作

1. 在父级 `案例总纲.md` 登记 `ANA-SEMI-20260722-001` 长期案例。
2. 在父级 `目录导读.md` 登记 `半导体案例/` 和当前案例入口。
3. 创建 `ana-doc/半导体案例/` 及目录导读、分析规范、审核规范、存储体系、设计、日志、审计、问题、待补资料和行业方案 10 个文件。
4. 创建规范的行业级、案例级和父体系数据目录，不写入正式资料或分析产物。
5. 在行业目录冻结容器设计、方案设计和 `BATCH-001` 正式执行设计，建立独立审核入口。

### 边界

1. 本轮没有采集、归档、转换、抽取或分析正式半导体资料。
2. 本轮没有生成 source/manifest/evidence、核心文档草稿、行业结论或公司结论。
3. 本轮没有执行外部信息补充、市场反向补漏或暗线分析；`darkline` 能力缺失已作为正式执行门记录。
4. 本轮没有进行开发；既有 ana dev 目标目录 blocker 未被修改或关闭。
5. 当前执行 AI 没有 reviewer 角色，不能批准自己的容器、方案或设计。
6. 本非绑定 Codex 入口未使用旧 MB-X session、route、inbox、Remote TUI 或 session 操作。

## 2026-07-22 15:15:10 RUN-ANA-SEMI-REVIEW-STATUS-SYNC-001：半导体一期审核状态镜像

- 所属案例：`ANA-SEMI-20260722-001`
- 来源日志：`ana-doc/半导体案例/案例执行日志.md` / `RUN-ANA-SEMI-REVIEW-RECEIPT-001`
- 唯一激活角色：`case_analysis.analyst.cai`
- handoff：`HANDOFF-ANA-SEMI-PHASE1-REVIEW-20260722-001`
- 审核角色：`case_analysis.reviewer.cai`
- 审核结果：容器、行业方案 v0.1 和 `BATCH-001` 设计三项审核均通过。
- 状态边界：只放行能力门处理、输入与参数冻结、执行前自检和状态回写；正式资料执行继续 `HELD`。
- 审计入口：`ana-doc/半导体案例/案例审计报告.md` / 第 87—190 行三项审核记录。
- blocker：`darkline` 当前不可用；`PRJ-ISSUE-PROJECT-INFO-DEV-TARGET-DIR-DRIFT-20260720-001` 仍 `OPEN`。