用途:当电子表格文件是主要输入或输出时使用,包括打开、读取、编辑、修复或新建 .xlsx 文件,以及数据分析与财务建模。
主要能力:用 pandas 读取与分析数据(可读取全部工作表、查看列信息与统计);用 openpyxl 创建或编辑工作簿,设置字体、填充、对齐、列宽,插入删除行列,处理多工作表;用 scripts/recalc.py 调用 LibreOffice 重算公式并扫描 #REF!、#DIV/0!、#VALUE!、#NAME? 等错误,返回含错误位置与数量的 JSON。
必要用法:所有计算应写成 Excel 公式而非 Python 硬编码值,例如 sheet['B10'] = '=SUM(B2:B9)';假设值放在独立单元格并用引用,如 =B5*(1+$B$6)。使用公式后必须重算:python scripts/recalc.py output.xlsx [timeout_seconds]。若返回 errors_found,按 error_summary 定位修复后重算。读取已计算值可用 load_workbook(..., data_only=True),但保存会永久丢失公式。
规范:交付文件使用一致的专业字体;财务模型按行业惯例配色(蓝色为硬编码输入、黑色为公式、绿色为同工作簿跨表链接、红色为外部链接、黄色背景为关键假设);年份按文本、货币用 $#,##0 并在表头注明单位、零显示为“-”、百分比默认 0.0%、倍数用 0.0x、负数用括号;硬编码值需注明来源。更新模板时须完全匹配既有格式与约定,模板约定优先于上述规范。
适用场景:数据分析、报表生成、财务模型搭建与维护、模板更新。
限制:公式重算依赖 LibreOffice;openpyxl 写入的公式不会自动求值;data_only=True 保存会丢失公式;其余平台与收费信息暂未提供。