用途:当电子表格文件(.xlsx)是任务的主要输入或输出时使用,涵盖打开、读取、编辑、修复、创建和分析 Excel 文件,包括数据分析和财务模型。
主要能力:使用 pandas 进行数据分析、可视化和基础操作;使用 openpyxl 处理公式与格式;创建和编辑新老工作簿;通过 scripts/recalc.py 调用 LibreOffice 重算公式值并扫描单元格错误。输出要求包括:统一专业字体、零公式错误(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?),更新模板时必须严格沿袭既有格式与约定。财务模型颜色规范:蓝色为硬编码输入,黑色为公式与计算,绿色为同一工作簿内的跨表链接,红色为外部文件链接,黄色背景为需关注的假设。数字格式:年份按文本、货币用 $#,##0 并在表头注明单位、零值显示为“-”、百分比默认 0.0%、倍数用 0.0x、负数用括号。
使用方式:数据操作选用 pandas(如 pd.read_excel、df.to_excel),公式与格式选用 openpyxl(Workbook、load_workbook,单元格索引从 1 开始)。计算务必用 Excel 公式而非 Python 硬编码值;假设放在独立单元格并以引用方式使用。生成或修改含公式的文件后,必须运行 python scripts/recalc.py <excel_file> [timeout_seconds](示例:python scripts/recalc.py output.xlsx 30),该脚本首次运行自动配置 LibreOffice,返回含错误位置与数量的 JSON,若有错误需修复后重算。阅读计算值时可用 data_only=True,但注意以此方式保存会永久丢失公式。大文件可用 read_only=True 或 write_only=True,指定 dtype 或 usecols 优化读取。
适用场景:财务模型建模、批量数据处理与导出、模板更新、公式构建与错误排查、多工作表分析。
限制:公式重算依赖 LibreOffice;本资料未说明具体定价、平台范围或性能上限,暂未提供相关细节。