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