技能介绍

你在什么场景下需要它

团队提上来的需求往往是两类：一类是中国式复杂报表——分组、交叉、主子表、斜线表头、填报录入，最终要一份能打印、能导出 Excel 的文件；另一类是自助式 BI 分析——拖拽探索、维度切换、仪表板联动钻取、指标预警，最终要一个浏览器里能交互的页面。传统路径得采购并部署帆软 FineReport / FineBI，再由熟悉产品的同事配置模板，排期和成本都不低。

这个技能解决的问题是：在完全没有帆软环境的机器上，产出结构等价的成果物。交付物不是截图，而是可独立打开的 HTML+ECharts 页面和可二次编辑的 .xlsx 文件。

它如何工作

核心是先分流、再构建：

产品线识别：命中「分组/交叉/主子/聚合/填报/导出」这类关键词走 FineReport 路线；命中「自助分析/探索/仪表板/同比环比/钻取/预警」走 FineBI 路线。两者也可混合——页面展示加 Excel 下载。
需求澄清前置：产品线、报表类型、数据来源、维度指标口径、交互需求、输出形态这 6 项缺一不可，缺失时会主动追问，不替用户做假设。
结构化数据准备：数据整理成 JS 数组或 Python dict。合计、占比、同比环比、累计、排名一律由代码计算，不靠估算。
模板化构建产物：Web 形态基于 report-dashboard-template.html（FineReport）或 bi-dashboard-template.html（FineBI）改造；Excel 形态以 scripts/generate_excel_report.py 为起点，用 openpyxl 生成。
交付前质量检查：核对报表类型是否匹配、数值是否经代码核验、控件过滤与联动是否有死链、HTML 单文件能否独立打开。

覆盖的能力面包括：FineReport 侧的分组/交叉/主子/聚合报表、决策大屏、参数查询与填报校验；FineBI 侧的数据加工（filter/groupBy/pivot）、快速计算、联动钻取、智能图表推荐、阈值预警与行列权限模拟。

适用边界与注意点

它是等价实现，不是帆软产品本身。不提供报表平台的服务端能力，如集中部署、权限体系对接、定时任务调度的真实执行——脚本可以被配置为定时任务，但调度器需要你自己提供。
数据仍需你提供。支持 CSV/Excel/JSON，没有真实数据时会用内置示例数据并明确标注可替换。
FineBI 侧的权限是模拟（按角色过滤行、按字段控制列可见性），不能对接真实 BI 平台的权限系统。
金融指标遵循中国惯例：红涨绿跌、¥ 前缀、大金额用「万/亿」。若你服务的是欧美市场，需要自己调整配色与符号。
Excel 生成依赖 openpyxl，须装在受管 venv 中，避免污染全局环境。
示例数据只用于结构演示，不构成任何业务结论。

适合的场景：快速出一版报表/看板原型、为汇报临时生成可交付文件、在没有 BI 授权的环境里复现既有报表结构。不适合的场景：需要长期维护、多人协作、接入企业主数据平台的正式报表体系。