用途:当电子表格文件是主要输入或输出时使用,覆盖打开、读取、编辑、修复现有表格,以及创建和分析 .xlsx 文件。
主要能力:用 pandas 做数据分析、可视化与基础操作;用 openpyxl 处理公式与格式;创建新工作簿、编辑现有文件、保留公式与格式;通过 scripts/recalc.py 调用 LibreOffice 重算公式并扫描错误。
必要用法:数据分析用 pandas,公式与格式用 openpyxl;所有计算应写成 Excel 公式而非硬编码值,例如 =SUM(B2:B9)、=(C4-C2)/C2、=AVERAGE(D2:D19)。保存后如含公式必须重算:python scripts/recalc.py output.xlsx,脚本返回 JSON,status 为 errors_found 时按 error_summary 定位并修复 #REF!、#DIV/0!、#VALUE!、#NAME? 等错误。
输出规范:使用一致的专业字体;交付时公式错误为零;更新模板时严格匹配既有格式与约定,模板约定优先。财务模型另有颜色与数字格式约定,如蓝色为硬编码输入、黑色为公式、绿色为同工作簿跨表链接、红色为外部链接、黄色背景为关键假设;年份按文本、货币用 $#,##0 并在表头注明单位、零显示为“-”、百分比默认 0.0%、倍数用 0.0x、负数用括号。硬编码值需注明来源。
限制:openpyxl 保存的公式不会自动求值,必须用 recalc.py 重算;以 data_only=True 打开并保存会永久丢失公式;需注意 1-based 索引、跨表引用格式与除零等常见陷阱。其他细节暂未提供。