自动报告生成器

要解决什么问题

业务侧常见场景是：表格已经落在 CSV 或 Excel 里，但要把「数字 + 图表 + 文字结论」整理成能发给管理层或客户的月报/周报，仍然要手工做透视、画图、写段落。这个技能把路径收成一条 CLI 流水线：读数 → 出图 → 让模型写分析叙述 → 拼成多工作表 Excel 报告。

技能如何工作

入口是 scripts/generator.py，通过 Skill 体系调用，主要参数包括：

• --file：数据文件路径
• --template：报告类型（monthly / financial / sales / comparison / custom 等）
• --ai-provider / --ai-model：对接 OpenAI 兼容 API（文档示例含 openai、deepseek）
• --tier 与 Token 前缀（REPORT-FREE 等）：与配额校验相关
• --output：输出路径

模块分工在 core/ 里比较清晰：parser.py 用 pandas 解析；charts.py 用 matplotlib / xlsxwriter 生成图表；ai_analyzer.py 负责 AI 分析；report_builder.py 组装多 sheet Excel；templates.py 管模板；quota.py 与 token_validator.py 管用量与密钥。另有 scripts/quick_report.sh 做快速生成。

按档位，免费档终身约 5 次、图表类型受限；更高档提高月度次数、图表种类，PRO 侧支持 PDF 导出，MAX 支持自定义模板与 API 访问（付费细节见 SKILL.md 中的 YK-Global 链接）。

适用边界与注意点

• 依赖外部 AI API Key 与网络；模型输出质量会直接影响叙述部分，需自行选型与复核结论。
• 配额与图表能力跟 --tier / Token 绑定，超出免费额度需按文档升级方案处理。
• 适合「结构化表格 + 固定报告模板」；高度定制的排版或复杂 ETL 仍要在数据准备阶段自行处理。