edit | blame | history | raw

ana-doc 目录导读

创建人员：management.admin
文件职责：说明 project-info 项目案例分析体系文档入口、研报体系方法母版、行业案例目录和相邻数据目录用途。
管理规范/模板：../项目规范.md；../../common/ana-doc/案例分析环境创建指南.md；../../common/ana-doc/案例分析规范.md。
引用文件：研报体系导读.md；案例分析规范.md；案例审核规范.md；案例存储体系.md；行业与产业链研究模板.md；产业链地图通用模板与研究方法.md；数据抓取脚本说明.md；案例总纲.md；案例分析设计.md；案例执行日志.md；案例审计报告.md；案例问题记录.md；研报体系/研报解析架构.md；研报体系/研报分析架构.md；股票估值/目录导读.md；../项目配置清单.md。
记录方式：目录入口文档；本目录正式文件新增、删除、改名或职责变化时同步更新。

1. 本体系定位

project-info 的案例分析体系用于承接研报研究、行业资料分析、外部信息补充、市场显影检查、暗线分流、证据归档、核心文档输出和审核闭环。

案例体系只记录可复核的案例链路，不替代实验体系的可执行验证，也不直接给出交易指令。研报体系进入本项目后，作为 ana-doc 案例体系的一部分运行：案例生命周期、设计审核、执行日志、审计闭环以 ana 体系为主；研报解析和研报分析方法作为专业步骤嵌入。

2. 父级文档入口

文件	作用
`研报体系导读.md`	研报体系工作入口，说明案例分析员、审核员和体系维护者如何读取核心文档、执行案例、提交审核和归档产物
`案例分析规范.md`	本项目案例分析本地规范入口，融合研报解析架构和研报分析架构流程，含研报体系接入流程、资料归档、主动补数据、补证轮次上限、市场反向补漏、核心文档输出、行业子规范优先级和 darkline 使用规则
`案例审核规范.md`	本项目案例审核本地规范入口，融合研报解析架构和研报分析架构的审核要求，含研报案例设计审核、执行审核、存储审核、输出审核、补证轮次上限、结论边界审核和复审清单
`案例存储体系.md`	案例数据、研报资料、证据、结果包、manifest、MySQL 追溯和临时文件存储口径
`行业与产业链研究模板.md`	跨行业长期研究公共母版；定义行业、终端场景、主/子产业链、内部环节、公司、证据、稳定目录和最终地图的完整研究骨架
`产业链地图通用模板与研究方法.md`	完整行业研究的最终可视化子模板；定义十四个地图信息层、价值量与盈利双轴、企业横评、催化验证和静态全展开
`数据抓取脚本说明.md`	`ana-data/tools/` 数据抓取、外部来源归档、本地 MySQL 只读导出和市场反向补漏脚本使用说明
`案例总纲.md`	父级案例事项背景、目标、边界、状态和结论账本
`案例分析设计.md`	父级案例选择口径、执行步骤、证据要求和验收方式
`案例执行日志.md`	父级案例执行过程、关键节点、数据和证据路径
`案例审计报告.md`	初始化审计、设计审核、执行审核、复审和审计问题主记录
`案例问题记录.md`	外部反馈、执行者无法自行闭环或需跨轮/跨角色跟踪的非审计问题，或审计问题跨轮索引

父级 ana-doc/ 只记录体系级规则、跨行业规则、目录入口和跨行业问题；单个行业研报案例的过程明细写入对应行业案例目录。

3. 研报体系方法母版

文件	作用
`研报体系/研报解析架构.md`	行业研报解析方法母版；定义行业方案继承机制、行业/市场/公司三类视图和解析输出底线
`研报体系/研报分析架构.md`	行业研报分析方法母版；定义资料归档、转换、证据抽取、指标标准化、主动补数据、市场反向补漏、暗线分流和人读文档闭环

说明：

研报解析架构.md 和 研报分析架构.md 是方法母版，保留在 ana-doc/研报体系/。
研报存储规则已经融入 案例存储体系.md，不在 ana-doc/研报体系/ 下另建正式 研报存储体系.md。
方法母版中出现的有色、铜、矿区等内容是示例，不是跨行业通用表或通用对象要求。
具体行业需要哪些对象、字段、表和输出文档，由该行业自己的 <行业>研报解析方案.md 定义。
研报解析架构.md 是指导思想和方法母版，原则上不因单个行业的输出结构、文件清单、子行业拆分、公司范围或执行细节调整而修改；这类变更应写入对应行业本地方案和案例设计。

4. 数据目录

目录	作用
`../ana-data/cases/`	逐行业统一 raw 池、行业级通用研报产物，以及逐案例正式输出、引用清单和证据映射
`../ana-data/result/`	父体系结果入口、对外交付包、跨案例汇总结果包、审计辅助输出、父级汇总表
`../ana-data/img/`	图片、图册、研报截图、OCR 图片、标注图和图片 manifest
`../ana-data/tmp/`	临时数据和中间产物，按行业、case、run 分组，不得作为正式证据入口
`../ana-data/tools/`	数据抓取、MySQL 只读导出和市场反向补漏脚本；脚本产物不得留在此目录

研报类行业级通用资料库默认使用：

ana-data/cases/<行业案例>/
  raw/
  converted/
  extracted/
  supplement/
  evidence/
  manifest/

研报类逐案例自定义结果目录默认使用：

ana-data/cases/<行业案例>/<case_id>/
  outputs/
  manifest/
  evidence/

研报类父体系兼容目录默认使用：

ana-data/tmp/<行业案例>/<case_id>/<run_id>/
ana-data/result/<行业案例>/<case_id>/
ana-data/img/<行业案例>/<case_id>/

研报类行业统一 raw 池默认使用：

ana-data/cases/<行业案例>/raw/

所有原始研报、公告、网页快照和外部资料原件必须先进入行业统一 raw/。转换、抽取、补充、通用证据事实和行业级 manifest 进入行业级目录；逐案例目录只保存输出、案例引用清单和案例结论证据映射。临时文件进入 ana-data/tmp/<行业案例>/<case_id>/<run_id>/，结果入口或交付包索引进入 ana-data/result/<行业案例>/<case_id>/，图片进入 ana-data/img/<行业案例>/<case_id>/。raw 与具体案例、批次、执行轮次的关系由 manifest 中的 case_id、batch_id、run_id 绑定。不得创建 ana-data/cases/<行业案例>/<case_id>/raw/，也不得按 batch 或 run 拆 raw 原始资料目录。

5. 行业 / 研究案例目录

正式行业研报研究应按行业容器文件夹管理。每个新的行业方向必须在 ana-doc/ 下创建自己的行业容器文件夹；行业容器不是一个案例，不创建自己的 案例总纲.md。

目录	作用	状态
`有色案例/`	有色行业研报容器和后续有色研报研究入口	已创建
`机器人案例/`	机器人行业研报容器和后续机器人研报研究入口，覆盖硬件、软件模型、整机厂阵营、供应链暗线和公司视图	已创建
`半导体案例/`	半导体行业研报容器，覆盖 EDA/IP、设备、材料、设计、制造、封测、产品类别和公司视图	已创建；一期容器、方案和设计审核均通过；正式执行 `HELD`
`军工案例/`	军工行业案例容器，按用户任务承接合法公开来源下的产业链、公司、技术产品、客户采购、产能交付、财务、估值接口、竞争、催化风险和证据缺口研究	V1 方法、模板、存储和协作入口已建，待军工审核员独立审核；研究内容为 0
`新能源案例/`	新能源行业案例容器；具体赛道、公司池和交付形态由后续用户任务轻量冻结，不在初始化阶段预先写死	体系、独立调研/审核角色和数据根已创建；研究内容为 0

5.1 专题能力目录

目录	作用	状态
`股票估值/`	跨行业股票价格合理性评估方法、角色入口和正式操作手册；历史公司评估结果进入 `../ana-data/result/股票估值/`	已纳管并可用

目录导读.md
案例分析规范.md
案例审核规范.md
案例存储体系.md
案例分析设计.md
案例执行日志.md
案例审计报告.md
案例问题记录.md
待补资料清单.md
<行业>研报解析方案.md

行业案例目录中的规范类和存储类文档以本层 ana-doc/ 的同名文档为母版；行业 案例分析规范.md 和 案例审核规范.md 默认只作为轻量继承入口和行业补充，不复制父级主流程、阶段门、审核类型和阻断条件。分析设计、执行日志、审计报告和问题记录作为该行业容器自己的事项、执行、审核和问题账本独立维护。真实案例统一登记在父级 案例总纲.md，行业目录不得创建平行的 案例总纲.md。

待补资料清单.md 用于承接同一案例、同一类证据缺口或同一组相关缺口补资料 3 轮后仍未补齐的资料需求。写入该清单后，分析员继续推进 DRAFT 核心文档和下一阶段工作；后续用户或人工同事索取需要补充的数据时，再从该清单提取反馈。

6. 当前案例入口

案例 ID	名称	状态	入口
`ANA-SMOKE-001`	案例体系初始化 dry-run	初始化审核通过	`案例总纲.md`、`案例分析设计.md`、`案例执行日志.md`、`案例审计报告.md`
`ANA-YS-TEMPLATE-001`	有色行业研报容器初始化	已迁入父级总纲，待审核员复核	`案例总纲.md`、`有色案例/案例分析设计.md`、`有色案例/案例执行日志.md`、`有色案例/案例审计报告.md`
`ANA-YS-INDUSTRY-001`	有色行业整体研报分析	进行中；`BATCH-001` 30 PDF 存储与转换试运行已完成，待正式审核员复核	`案例总纲.md`、`有色案例/案例分析设计.md`、`有色案例/案例执行日志.md`、`有色案例/案例审计报告.md`
`ANA-ROBOT-INDUSTRY-001`	机器人行业整体研报分析	正式设计已冻结；三件套已冻结；首批 P0 细分环节和公司页已迁入，待执行审核	`案例总纲.md`、`机器人案例/机器人研报解析方案.md`、`机器人案例/案例分析设计.md`、`机器人案例/案例执行日志.md`、`机器人案例/案例审计报告.md`、`../ana-data/result/机器人案例/ANA-ROBOT-INDUSTRY-001/result_index.md`
`ANA-SEMI-20260722-001`	半导体行业整体研报分析	一期容器、行业方案和 `BATCH-001` 设计审核均通过；仅放行能力门与执行前冻结，未执行资料分析	`案例总纲.md`、`半导体案例/半导体研报解析方案.md`、`半导体案例/案例分析设计.md`、`半导体案例/案例执行日志.md`、`半导体案例/案例审计报告.md`

新增正式案例时，应先在父级 案例总纲.md 登记，再在对应行业目录 案例分析设计.md 补事项拆解、批次设计和执行方案；设计审核通过后才能执行。

7. 执行入口选择

AI 接到研报或行业资料分析任务时，先判断任务落点：

跨行业通用规则、父级规范、研报方法母版维护：落父级 ana-doc/。
单个行业研报分析、资料读取、输出文档、证据链、执行日志、审计问题：案例登记落父级总纲，事项拆解和过程明细落对应行业案例目录；执行者自发现且可处理的问题写入执行日志、自检或验证报告，不写入问题记录。
行业原始资料和通用研报产物：落 ana-data/cases/<行业案例>/raw|converted|extracted|supplement|evidence|manifest/；逐案例输出、引用清单和案例证据映射：落 ana-data/cases/<行业案例>/<case_id>/。
临时文件：落 ana-data/tmp/<行业案例>/<case_id>/<run_id>/，不得作为正式证据入口。
结果入口、对外交付包、跨案例汇总：落 ana-data/result/<行业案例>/<case_id>/；图片、截图、OCR 图片、图册和标注图：落 ana-data/img/<行业案例>/<case_id>/。
数据抓取和只读导出脚本：从 ana-data/tools/ 执行，使用说明看 数据抓取脚本说明.md；输出仍按行业和案例进入 supplement/evidence/manifest/tmp/result/img。

8. 行业整体成果稳定入口

父级 L2 设计 DESIGN-CASE-INDUSTRY-CANONICAL-RESULT-MIGRATION-L2-20260807-001 已通过一次同链聚焦复审。行业整体长期成果的默认入口现统一为：

ana-data/cases/<行业>案例/当前成果索引.md
ana-data/cases/<行业>案例/核心文档/
ana-data/cases/<行业>案例/审计包/<case_id>/<batch_id>/<run_id>/
ana-data/cases/<行业>案例/manifest/current_output_manifest.csv
ana-data/cases/<行业>案例/manifest/promotion_ledger.csv
ana-data/cases/<行业>案例/manifest/legacy_case_path_map.csv
ana-data/result/<行业>案例/当前成果索引.md

cases 当前索引是唯一可变的正式阅读入口，result 当前索引只作固定跳转；长期 case_id 保留为元数据和审计血缘，不再增加 <stable_case_id>/outputs/ 作为第二套行业整体入口。普通专题案例仍按第 4、7 节使用 <case_id>/outputs|manifest|evidence 和 result/<case_id>/；二者不能互相冒充。

行业根文件不得因母规范同步直接创建。每个行业必须先在既有设计链冻结 accepted candidate、active exclusion、release exact-set、审计包和 rollback，再经既有行业 reviewer 通过；正式发布还必须满足行业执行/输出审核与 案例存储体系.md 第 13 节的原子 promotion 合同。

当前只开放新能源 BATCH-001 稳定入口迁移的行业级设计门；新能源 BATCH-002 与军工 BATCH-034 继续冻结、不得发布或移动。军工还须完成既有 §91 原链聚焦设计门。父级 PASS 本身不授权创建行业根、迁移或删除旧包。

8.1 单一稳定正文后继口径（2026-08-08）

TASK-DEFENSE-SINGLE-CORE-DOCUMENT-REMEDIATION-20260808-001 对本节作 append-only 后继纠错：行业整体成果只允许一个 cases 当前索引和一套稳定 核心文档/ 正文树。核心文档/ 下不得再创建 .releases/<hash>/、日期/批次/版本后缀或第二套完整正文；新批次持续更新相同路径、相同文件，batch/run/revision/release 只在 manifest、ledger 和审计中留痕。

候选只在 ana-data/tmp 构建；上一状态、历史 release、差异和回滚材料只进入 审计包。既有历史 release 不删除，迁移时按 bytes/SHA-256 和原接受审计可恢复归档并更新 legacy_case_path_map.csv。ana-data/result/<行业>案例/当前成果索引.md 始终只是指向 cases 当前索引的固定轻量跳转。

一个 CONTENT_SPRINT 只走一次合并设计确认和一次合并执行/输出确认，不按文件、公司或字段增设审核。本条只纠正父级规范，不授权任何行业迁移、发布或状态变更；冲突处以 案例分析规范.md §12.5 和 案例存储体系.md §13.6 为准。