用途:创建、编辑和分析 .xlsx 文件。数据读取、分析与可视化用 pandas;公式、格式与 Excel 特性用 openpyxl;公式值重算依赖 LibreOffice 与 recalc.py 脚本。
主要能力:支持新建工作簿、加载并修改已有文件、多工作表操作、插入/删除行列、添加公式与样式、调整列宽等。核心约束是始终使用 Excel 公式而非 Python 计算后硬编码,确保表格在源数据变化后可重算,适用于总计、百分比、比率和差异等所有计算。
使用方式:常用流程为选择工具(数据用 pandas,公式与格式用 openpyxl)、创建或加载、修改、保存;若含公式则必须重算:python recalc.py output.xlsx。脚本返回含错误位置与数量的 JSON,若状态为 errors_found,按 error_summary 修复 #REF!、#DIV/0!、#VALUE!、#NAME? 等错误后再次重算。示例命令:python recalc.py <excel_file> [timeout_seconds]。
规范:所有 Excel 文件必须零公式错误。更新模板时须完全匹配既有格式、样式与约定,模板约定始终优先。财务模型还有颜色编码约定与数字格式规则(年份按文本、货币 $#,##0、零值显示为短横、百分比默认 0.0%、倍数 0.0x、负数用括号),假设值应放在独立单元格并用引用。硬编码值需注释来源。
限制:openpyxl 保存的公式仅为字符串、不计算结果,必须用 recalc.py 更新;以 data_only=True 打开并保存会永久丢失公式。大文件建议只读或只写模式。具体收费、价格和平台支持等信息暂未提供。