用途:创建、编辑和分析 Excel 电子表格,支持 .xlsx、.xlsm、.csv、.tsv 格式。核心要求是所有交付文件不得存在公式错误(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?)。更新已有模板时必须完全匹配原有格式、样式与约定,模板约定优先于通用规范。
主要能力:用 pandas 做数据分析、可视化与基础操作,用 openpyxl 处理公式、格式化及 Excel 专属功能;可创建新工作簿、加载修改现有文件、增删行列与工作表。计算一律使用 Excel 公式而非在 Python 中算好硬编码,例如用 =SUM(B2:B9)、=(C4-C2)/C2、=AVERAGE(D2:D19),保证表格可随源数据重算。假设值(增长率、利润率、倍数等)须放在独立单元格并用引用,如 =B5*(1+$B$6)。
财务模型规范:行业标准颜色约定为蓝色(0,0,255)硬编码输入与可调情景数、黑色(0,0,0)全部公式计算、绿色(0,128,0)同工作簿跨表链接、红色(255,0,0)外部文件链接、黄色背景(255,255,0)关键假设或待更新单元格。数字格式:年份按文本("2024")、货币用 $#,##0 并在表头标注单位、零值显示为 "-"、百分比默认 0.0%、估值倍数用 0.0x、负数用括号。硬编码须注明来源,格式为 "Source: [系统/文档], [日期], [具体引用], [URL]"。
使用方式:依赖 LibreOffice,用命令 python recalc.py <excel_file> [timeout_seconds] 重算公式并扫描错误,脚本自动配置宏,返回含错误位置与数量的 JSON;首次运行会自动完成配置,支持 Linux 与 macOS。
限制:openpyxl 写入的公式仅以字符串保存,不含计算值,必须用 recalc.py 重算;若以 data_only=True 打开并保存,公式会被值替换并永久丢失。大文件建议 read_only=True 或 write_only=True。需注意行列索引差异(openpyxl 从 1 开始)、跨表引用格式、除零与引用错误、范围偏移等问题。其他细节暂未提供。