BytePlan Excel 报告生成

解决的问题

财务或经营分析结果往往已在 byteplan-analysis 中完成，但交付时仍需要人工整理成 Excel：列名不一致、金额和占比精度不统一、每个维度挤在一张 Sheet 或额外写说明文字。byteplan-excel 将这类重复整理工作收敛为固定输出规范，只从工作目录读取已有分析数据，并生成可被下游系统直接读取的结构化表格。它的目标不是美化报告，而是让分析结果能以稳定列结构进入 Excel，供后续脚本、对账或归档读取。

工作方式

它不做二次分析，也不编造数据，核心步骤是：

• 读取数据：从 BytePlan 工作目录读取 byteplan-analysis 产出的分析结果。
• 转换格式：按分析维度拆分，如 TOP3贡献要素、费用类别贡献、资产类别贡献、分摊步骤贡献。
• 生成 Excel：使用 xlsx 创建工作簿，金额保留 2 位小数，占比保留 3 位小数，排名为整数。

每个维度一个独立 Sheet，输出为纯数据表，不包含标题、说明文字或装饰性内容。文件必须落在 BytePlan 工作目录下，例如某个 边际分析_... 目录中的 边际分析报告.xlsx。

适用边界

适合把已有分析结果转成标准 Excel 附件，或作为后续报表、对账、归档的前置步骤。不适合直接分析原始数据；如果没有 byteplan-analysis 的结果，应先完成分析。也适合对列名、精度和 Sheet 结构有明确要求的场景，不适合自由排版或复杂图表需求。