用途:创建、编辑和分析 .xlsx 文件,覆盖公式、格式、数据分析与可视化。
主要能力:用 pandas 读取与分析数据(可读取全部工作表、查看统计信息),用 openpyxl 创建或修改工作簿、写入公式与格式、增删行列与工作表。要求所有计算使用 Excel 公式而非硬编码值,保证表格可随源数据重算。
规范要求:所有 Excel 文件必须零公式错误(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?)。更新模板时须完全匹配既有格式与约定,模板约定优先于通用指南。财务模型配色:蓝色为硬编码输入,黑色为公式,绿色为同工作簿跨表链接,红色为外部链接,黄色背景为关键假设。数字格式:年份用文本,货币用 $#,##0 并在表头注明单位,零值显示为“-”,百分比默认 0.0%,倍数用 0.0x,负数用括号。假设须放在独立单元格并以引用方式使用。硬编码值需注明来源。
使用方式:输出文件写入 outputs/<document-name>/ 目录。常用流程为选择工具(数据用 pandas,公式与格式用 openpyxl)、创建或加载、修改、保存,然后用 python recalc.py output.xlsx 重算公式并检查错误,最后转 PDF 再转图像做视觉校验:soffice --headless --convert-to pdf --outdir outputs/<document-name>/ outputs/<document-name>/workbook.xlsx,pdftoppm -jpeg -r 150 outputs/<document-name>/workbook.pdf outputs/<document-name>/page。
限制:openpyxl 写入的公式不计算结果,必须用 recalc.py 重算;以 data_only=True 打开并保存会永久丢失公式;需安装 LibreOffice。视觉校验为强制步骤,不可仅做公式校验。