用途:面向 .xlsx 文件的创建、编辑与内容分析,可处理公式、格式化、数据分析与可视化。适用于财务模型等对格式与公式正确性要求较高的表格任务。
主要能力:用 pandas 读取与分析数据(pd.read_excel、df.head、df.describe 等)并导出(df.to_excel);用 openpyxl 创建与编辑工作簿、写入公式与样式、调整列宽、插入行/删除列、多工作表操作;通过 recalc.py 借 LibreOffice 重算公式并扫描错误。
使用方式:选择工具,数据分析用 pandas,公式与格式用 openpyxl;创建或载入文件后修改并保存;若含公式必须重算:python recalc.py output.xlsx,也可指定超时如 python recalc.py output.xlsx 30。脚本首次运行自动配置 LibreOffice,返回 JSON,含 status、total_errors、total_formulas 及 error_summary(错误类型、数量与位置)。发现 errors_found 时按位置修复后重算。
关键要求:所有 Excel 文件须零公式错误(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?)。更新模板时须完全匹配现有格式与约定,模板约定优先于通用规范。公式不得硬编码计算值,应引用单元格,例如用 =B5*(1+$B$6) 而非 =B5*1.05。假设值集中放在独立单元格。
财务模型规范:颜色编码为蓝色硬编码输入、黑色公式与计算、绿色同工作簿跨表链接、红色外部文件链接、黄色背景标注关键假设;数字格式包括年份用文本、货币 $#,##0 且表头标注单位、零显示为短横、百分比默认 0.0%、倍数 0.0x、负数用括号;硬编码值需注释来源,格式为 Source: 系统/文档、日期、具体引用、可选 URL。
限制:openpyxl 保存的是公式字符串而非计算值,须用 recalc.py 重算;以 data_only=True 打开并保存会永久丢失公式;大数据文件应使用 read_only 或 write_only。其余收费、平台与效果信息暂未提供。