本项目用于完成浙江工商大学 2026 年大学生数学建模竞赛 A 题。当前主线按赛题命名收敛为“短期冲击模型（0-60 天）”和“中长期油价调节模型（60-180 天）”，并生成最终论文 PDF/DOCX。根目录只保留入口文件、赛题原文、环境文件和目录导航；过程证据统一进入 output/、项目说明统一进入 docs/。
本文解释的问题是：霍尔木兹封锁造成巨大供应缺口时，为什么附件数据中的油价没有冲到线性需求反事实基准给出的 278-337 美元/桶，而是在 110-120 美元/桶附近形成平台。常弹性需求口径会给出更高的机械上界，因此只作为稳健性参照，不作为现实预测。
当前最终模型按赛题名称组织：
- 短期冲击模型（0-60 天）：RMSE 3.38 美元/桶，MAE 2.76 美元/桶，MAPE 2.76%；阶段 Ridge 增强路径 RMSE 3.18 美元/桶。
- 基准对比：优于朴素上一日基准和滚动 ARIMA 基准。
- 中长期油价调节模型（60-180 天）：接入 EIA/JODI/OPEC 官方外生约束和 OVX 市场隐含波动率后，中性情景第 180 天约 94.15 美元/桶，悲观情景第 180 天约 110.16 美元/桶。
- 蒙特卡洛：接入 2017-2025 历史波动校准、OPEC 全球供需基线和 OVX 风险约束后，第 180 天价格中位数约 96.69 美元/桶，外推期最高价突破 120 美元/桶的条件概率约 16.3%。
- 敏感性分析：已扩展为 16 个参数，新增长期机制透明层，覆盖制度风险占比、冲击不确定性占比、信心恢复底座、SPR 收缩起点和过剩供给回归强度。
- 统计审计：已加入 DM 检验、残差诊断和方向命中检验；R 版脚本补充 ADF、ARCH/GARCH 和 Newey-West 稳健校准回归。
- 计算机增强：已加入只使用滞后误差的在线残差校正层，作为机器学习/自适应过滤思想的轻量辅助，不替代机制主模型。
- 外部审计：EIA 官方周度数据、JODI 官方多国月度数据、OPEC 全球供需平衡表、GPR 滞后审计、2017-2026 历史窗口检验均已接入论文；EIA/JODI/OPEC 与 OVX 已进一步进入长期参数约束层。
- 市场风险：OVX 原油期权隐含波动率已接入中长期油价调节模型的风险权重和不确定性强度，冲突窗口均值处于同长度历史窗口约 97.3% 分位；期货期限结构和油轮保险费暂不强行数值化，需等待可复现的多到期合约或授权运输风险数据。
| 文件 | 说明 |
|---|---|
output/final/A题_霍尔木兹海峡封锁对国际原油价格影响_论文.pdf |
当前正式 PDF，已编译验证 |
output/final/A题_霍尔木兹海峡封锁对国际原油价格影响_论文.docx |
可编辑 Word 版本 |
paper/总论文.tex |
总论文 LaTeX 源码 |
docs/00_项目总览.md |
项目状态和关键结论入口 |
当前正式 PDF 为 56 页，已包含附录核心代码。附录代码采用 minted/Pygments 近 IDE 风格彩色高亮，PDF 是当前最稳定的正式排版版本；DOCX 主要用于队友批注和人工修改。
注意：最终只交付一份总论文。paper/短期冲击模型历史素材稿.tex 是历史素材稿，不是当前最终论文主线。
docs/ 只保留 7 个入口文件，当前阅读入口固定如下：
| 文件 | 用途 |
|---|---|
docs/00_项目总览.md |
项目是什么、做到哪一步、关键结论是什么 |
docs/01_建模方案.md |
模型链路、因素纳入、短期/长期关系 |
docs/02_工程复现.md |
环境、目录、运行命令 |
docs/03_交付物与数据索引.md |
关键 CSV、图、报告、论文位置 |
docs/04_决策与质疑防御.md |
建模决策和评委质疑防御 |
docs/05_历史决策与早期材料.md |
V1、旧状态、旧文档的单文件保留版 |
docs/06_模型质量提升与技术实现计划.md |
下一轮模型质量提升和技术实现路线 |
阶段运行报告统一保留在 output/reports/，它们是证据材料，不作为主阅读入口。
source scripts/project_env.sh
./scripts/build/build_final_paper.sh根目录的 scripts/build_final_paper.sh 是兼容转发入口。正式构建需要 xelatex -shell-escape 和 Pygments，以便渲染附录彩色代码块。
输出：
output/final/A题_霍尔木兹海峡封锁对国际原油价格影响_论文.pdfoutput/final/A题_霍尔木兹海峡封锁对国际原油价格影响_论文.docx
| 目录 | 作用 |
|---|---|
data/ |
原始附件、清洗数据、外部审计数据、参数来源 |
src/ |
数据清洗、建模、校准、分析、可视化代码 |
output/ |
模型结果、阶段报告、最终交付物 |
figures/ |
阶段图表和论文通用图 |
paper/ |
论文源码、参考文献和论文专用图 |
docs/ |
人读的项目关键信息 |
审计报告/ |
外部评审、Gemini/DeepSeek/Cursor 质疑和防御矩阵 |
dashboard/ |
可选 Streamlit 展示系统 |
sql/ |
PostgreSQL 草案，当前不是主线 |
根目录只保留最小入口和赛题原文 PDF；早期方案和旧文档内容已合并进 docs/05_历史决策与早期材料.md。
paper/总论文.tex是最终论文主控源文件，正文拆分在paper/sections/。output/final/只放最终 PDF/DOCX。output/reports/只放阶段报告和模型证据。docs/保持少量关键文档，不再扩散成报告仓库。.cache/、tmp/、output/build/、渲染检查图均为本机临时产物，不作为项目主线。