用途:创建、编辑和分析 .xlsx 文件,覆盖公式、格式、数据分析和可视化。要求所有交付的 Excel 文件零公式错误(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?)。更新模板时须严格匹配原有格式与风格,模板既有约定优先于通用规范。
主要能力与规范:金融模型采用行业颜色约定——蓝色(0,0,255)硬编码输入、黑色(0,0,0)公式、绿色(0,128,0)同工作簿引用、红色(255,0,0)外部链接、黄色背景(255,255,0)关键假设。数字格式:年份用文本、货币用 $#,##0 且表头注明单位、零值显示为“-”、百分比默认 0.0%、估值倍数用 0.0x、负数用括号。公式中所有假设(增长率、利润率、倍数等)须放在独立单元格并引用,禁止硬编码数值;硬编码须注明来源。
使用方式:数据分析用 pandas,公式与格式用 openpyxl。创建示例:from openpyxl import Workbook;修改用 load_workbook。公式重算必须运行 python recalc.py <excel_file> [timeout_seconds],如 python recalc.py output.xlsx 30;脚本自动配置 LibreOffice,返回 JSON 报告错误位置与数量。若状态为 errors_found,按 error_summary 修复后重算。
适用场景:财务模型、数据分析、批量导出、模板更新。
限制:openpyxl 写入的公式不计算结果,须配合 recalc.py;data_only=True 读取并保存会永久丢失公式;大文件用 read_only/write_only;注意 1 基索引、空值处理、跨表引用格式 Sheet1!A1 及循环引用。