4.2 KiB
title, source_type, created, updated, type, status
| title | source_type | created | updated | type | status |
|---|---|---|---|---|---|
| 期货研究 Raw 资料目录 | 目录规范 | 2026-08-02 | 2026-08-02 | index | active |
期货研究 Raw 资料目录
本目录是期货研究的来源层，按研究用途和品种组织，不按公司名称组织。所有新增资料优先进入 raw/期货/，Wiki 页面只引用这里的内部文件。
目录结构
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
不要把新闻、交易观点和事实定义直接混写；不要为了填满页面而补写来源没有支持的数字。