用途:当电子表格是主要输入或输出时使用,包括创建、读取、编辑、修复 .xlsx 文件,以及基于表格的数据分析与财务建模。
主要能力:用 pandas 读取(pd.read_excel)、分析(head/info/describe)与导出;用 openpyxl 创建和编辑工作簿,保留公式与格式;支持多工作表、行列增删、字体填充对齐与列宽设置;通过 scripts/recalc.py 调用 LibreOffice 重算公式并扫描全表错误。
关键规则:始终写 Excel 公式而非在 Python 中硬编码计算结果(如 =SUM(B2:B9)、=AVERAGE(D2:D19));假设值放入独立单元格并以引用参与公式。
输出规范:全表使用一致的专业字体;公式零错误(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?);更新模板时严格沿用原有格式与约定,模板约定优先于通用规范。财务模型颜色编码:蓝色为硬编码输入,黑色为公式,绿色为同工作簿跨表链接,红色为外部链接,黄色背景为关键假设。数字格式:年份用文本,货币用 $#,##0 并在表头注明单位,零值显示为“-”,百分比默认 0.0%,倍数为 0.0x,负数用括号。
用法:修改后执行 python scripts/recalc.py output.xlsx,脚本返回 JSON,若 status 为 errors_found 则按 error_summary 定位修复后重算。
限制:openpyxl 只保存公式字符串不计算值,需依赖 LibreOffice 重算;以 data_only=True 打开并保存会使公式永久变为数值。其他价格、平台等信息暂未提供。