用途:创建、编辑和分析 .xlsx 文件,覆盖公式、格式、数据分析与可视化,适合财务模型与数据报表场景。
主要能力:用 pandas 读取与分析数据(pd.read_excel、df.head/info/describe、to_excel);用 openpyxl 创建或修改工作簿,设置字体、填充、对齐、列宽,插入/删除行列、新建工作表;支持多工作表遍历与跨表引用。
使用方式:数据分析与批量操作用 pandas,公式与格式用 openpyxl。关键要求是使用 Excel 公式而非 Python 硬编码结果,例如 sheet['B10'] = '=SUM(B2:B9)'、'=(C4-C2)/C2'、'=AVERAGE(D2:D19)',保证源数据变化后可重算。假设值(增长率、利润率、倍数等)须放在独立单元格并以引用方式使用,如 =B5*(1+$B$6)。
公式重算:openpyxl 保存的公式只是字符串,需运行 python recalc.py output.xlsx [timeout_seconds](示例 python recalc.py output.xlsx 30)。脚本首次运行自动配置 LibreOffice 宏,重算所有工作表公式并扫描 #REF!、#DIV/0!、#VALUE!、#N/A、#NAME? 等错误,返回含错误位置与数量的 JSON;若 status 为 errors_found,按 error_summary 修复后重算。
规范:所有 Excel 文件须零公式错误;更新模板时严格匹配既有格式与约定,模板约定优先。财务模型颜色约定:蓝色 RGB 0,0,255 为硬编码输入,黑色 0,0,0 为公式与计算,绿色 0,128,0 为同工作簿跨表链接,红色 255,0,0 为外部链接,黄色背景 255,255,0 为需关注的关键假设。数字格式:年份用文本,货币用 $#,##0 并在表头注明单位,零值显示为“-”,百分比默认 0.0%,估值倍数用 0.0x,负数用括号。硬编码需注明来源,格式为“Source: [系统/文档], [日期], [具体引用], [URL]”。
限制:需安装 LibreOffice 以重算公式;data_only=True 读取后若保存会永久丢失公式;大文件可用 read_only/write_only;公式需测试边界值与循环引用。其他平台与收费信息暂未提供。