# ============================================================================
# report-generator skill — 依赖与环境契约 (RG-002)
# Skill 版本: v2.1.0   最后核对: 2026-10-09
# ============================================================================
#
# 运行环境要求:
#   - Python >= 3.10（脚本使用 pathlib / f-string / 类型注解等 3.10+ 语法）
#   - 纯标准库脚本（零 pip 依赖，可直接运行）:
#         scripts/validate_report.py      scripts/make_selfcontained.py
#         scripts/gen_qc_report.py        scripts/learn_analyze.py
#         scripts/report-diff.py
#
# ── 依赖分级 ──────────────────────────────────────────────────────────────
# [必需] 一键交付流水线中 PDF / DOCX 产出环节:
#     reportlab>=4.0      # scripts/make_pdf.py   —— 打印级 PDF 直出（纯 Python，含内置 CID 中文字体）
#     python-docx>=1.1    # scripts/make_docx.py  —— 可编辑 Word 直出
#
# [可选] 增强数据核验（scripts/validate_report.py Gate22 外部数据源反查）:
#     openpyxl>=3.1       # 读取用户上传 .xlsx 外部数据源做数字反查
#                         # CSV 由标准库 csv 支持，无需安装；缺 openpyxl 时
#                         # 仅禁用 .xlsx 反查，其余 Gate 不受影响（降级而非崩溃）
#
# ── 降级行为（缺失时的确定性处理，RG-002）──────────────────────────────────
#   - 缺 reportlab    → make_pdf.py 默认明确报错并退出码 3，不联网；用户显式
#                       --bootstrap 才按 requirements.lock.txt + SHA-256 安装。
#   - 缺 python-docx  → make_docx.py 同上。
#   - 缺 openpyxl     → validate_report.py 的 -d 仅接受 .csv；传入 .xlsx 时 WARN 并跳过该源。
#   - 离线 / 无外网   → 不影响：图表库已内联于 vendor/，PDF 中文字体内置，全流程零外链。
#                       （自助安装仅在用户显式要求 PDF/DOCX 产出时触发，且失败不静默。）
#
# 安装（仅当需要 PDF/DOCX 产出或 .xlsx 反查时）:
#     pip install -r requirements.txt          # 常规：精确版本，可复现
#     pip install --require-hashes -r requirements.lock.txt   # 审计：锁定 + SHA-256 校验
# ============================================================================

# 必需（精确版本锁定，可复现安装；哈希见 requirements.lock.txt）
reportlab==5.0.1
python-docx==1.2.0

# 可选（Gate22 增强：.xlsx 外部数据源反查）
openpyxl==3.1.5
