raw/期货/
├─ 00-整体相关/                 # 跨品种共用的市场、制度、宏观和交易框架
├─ 01-基本分析逻辑/             # 供需、库存、成本、利润、基差、曲线和研究方法
├─ 10-品种相关/                 # 品种长期知识，按品种继续分目录
│  ├─ 玻璃/
│  └─ 纯碱/
├─ 20-品种新闻/                 # 新闻、公告、政策和事件，一事一文
│  ├─ 通用/
│  ├─ 玻璃/
│  └─ 纯碱/
├─ 90-待核验/                   # 来源不完整、格式混乱或只适合作为线索的材料
└─ _meta/                       # 文件清单、迁移记录、数据字典和维护元数据

归档规则

整体相关

适合放跨品种复用的交易制度、宏观变量、资金面、期限结构、套期保值、风险管理和市场数据说明。只对某一个品种成立的内容不要放这里。

基本分析逻辑

适合放可长期复用的分析方法：供需平衡表、成本曲线、库存周期、利润传导、基差、月差、仓单、季节性、产业链和情景分析。方法页应区分“定义/公式”“经验规律”“研究假设”。

品种相关

每个品种目录保存相对稳定的知识：产业链、生产工艺、合约交割、供需结构、数据字典、成本模型和历史机制。文件名使用：

品种-主题.md

例如：玻璃-期货合约与交割.md、纯碱-生产工艺与供需.md。

品种新闻

新闻不直接覆盖品种知识页。每条新闻单独保存，文件名建议：

YYYY-MM-DD-品种-事件简述.md

新闻 frontmatter 至少包含：published、source、source_type、evidence_level、topics 和 status。新闻只记录事件、原文事实、影响路径和待验证事项，不直接写成行情结论。

待核验

以下内容进入 90-待核验/：来源缺失、网页剪藏格式严重破坏、图片或扫描件无法核验、研报预测、个人判断、AI 生成数字、重复材料和需要官方规则复核的旧合约参数。待核验文件可以被引用为线索，但不能作为高置信事实来源。

Raw 文件规范

每个长期 raw 文件应有 YAML frontmatter：

---
title: "品种：主题"
source_type: "原始资料 | 摘编 | 数据字典 | 新闻 | 待核验"
created: YYYY-MM-DD
updated: YYYY-MM-DD
status: "active | review | superseded"
evidence_level: "A1 | A2 | B1 | B2 | C1 | C2 | D"
source_files:
  - name: "原始文件名或来源标题"
    sha256: "64位哈希"
---

raw/ 文件原则上不覆盖。新版本使用新文件或在 frontmatter 中记录 supersedes；若内容发生变化，更新 compile-results.tsv 中的哈希和状态。原始来源不再可获得时，保留已有摘编，并把 status 改为 review，不要伪造新来源。

证据等级

A1：现行交易所规则、国家标准、政府部门文件。
A2：上市公司正式公告、年报、中报和审计财报。
B1：数据供应商原始数据及指标方法论。
B2：券商/期货公司研报、行业白皮书和历史复盘。
C1：预测、策略、目标价和情景假设。
C2：个人草稿、网页剪藏、AI 生成稿和未核验转载。
D：无来源图片、截图、扫描件或 OCR 质量不足的材料。

增量工作流

接收资料
  -> 判断整体/方法/品种/新闻/待核验
  -> 保存到对应 raw 子目录
  -> 添加 frontmatter 和来源哈希
  -> 搜索 Wiki 是否已有同主题页面
  -> 更新或新建 Wiki 页面
  -> 更新 INDEX、sources、compile-results
  -> 检查链接、哈希、孤岛和 diff

不要把新闻、交易观点和事实定义直接混写；不要为了填满页面而补写来源没有支持的数字。

README.md Unescape Escape

期货研究 Raw 资料目录

目录结构