用途:创建、编辑和分析 .xlsx 文件,覆盖公式、格式、数据分析与可视化。
主要能力:用 pandas 读取与分析数据(pd.read_excel、df.head/info/describe、to_excel);用 openpyxl 创建或修改工作簿、单元格、公式、字体、填充、对齐与列宽;支持多工作表操作与行列增删。
必要用法:所有计算必须写成 Excel 公式而非 Python 硬编码值,例如 sheet['B10'] = '=SUM(B2:B9)'。使用公式后必须重算:python recalc.py output.xlsx,脚本返回 JSON,若 status 为 errors_found 则按 error_summary 定位并修复 #REF!、#DIV/0!、#VALUE!、#NAME? 等错误。重算依赖 LibreOffice,脚本首次运行会自动配置。
规范要求:交付文件须零公式错误;更新模板时须完全匹配既有格式与约定,模板约定优先。财务模型配色:蓝色 RGB 0,0,255 为硬编码输入,黑色 0,0,0 为公式,绿色 0,128,0 为同工作簿跨表链接,红色 255,0,0 为外部链接,黄色背景 255,255,0 为关键假设。数字格式:年份按文本,货币用 $#,##0 并在表头注明单位,零值显示为“-”,百分比默认 0.0%,倍数用 0.0x,负数用括号。假设须放在独立单元格并以引用代替硬编码,硬编码需注明来源。
限制:openpyxl 保存的公式不计算结果,须用 recalc.py;以 data_only=True 打开并保存会永久丢失公式;大文件建议 read_only/write_only。其他平台与收费信息暂未提供。