用途：当电子表格文件是主要输入或输出时使用，例如打开、读取、编辑或修复现有 .xlsx，创建新表格，或对其内容做数据分析。
主要能力：用 pandas 读取和统计（pd.read_excel、sheet_name=None 读取全部工作表、head/info/describe、to_excel）；用 openpyxl 创建、加载和修改工作簿，设置字体、填充、对齐、列宽，插入行、删除列、新建工作表，并保留原文件的公式与格式。
用法要点：必须使用 Excel 公式而非在 Python 中算好再写死的数值，如 =SUM(B2:B9)、=(C4-C2)/C2、=AVERAGE(D2:D19)；修改后运行 python scripts/recalc.py <excel_file> [timeout_seconds]，该脚本借助 LibreOffice 重算公式并扫描所有单元格的 #REF!、#DIV/0!、#VALUE!、#NAME? 错误，返回含错误位置与数量的 JSON，出现 errors_found 时按 error_summary 修复后重算。加载时可用 data_only=True 读取计算值，但保存会丢失公式。
输出要求：使用统一专业字体；公式错误必须为零；更新模板时严格匹配原有格式与惯例，模板约定优先于本规范。财务模型保持行业颜色约定：蓝色（RGB 0,0,255）为硬编码输入，黑色（RGB 0,0,0）为公式与计算，绿色（RGB 0,128,0）为同一工作簿内跨表引用，红色（RGB 255,0,0）为外部文件链接，黄色背景（RGB 255,255,0）为关键假设或需更新单元格。数字格式：年份按文本、货币用 $#,##0 且表头注明单位、零显示为短横线、百分比默认 0.0%、估值倍数用 0.0x、负数用括号。
限制与注意事项：所有假设放在独立单元格并以单元格引用代替写死值；硬编码需附来源注释；脚本依赖 LibreOffice，首次运行会自动配置，支持 Linux 与 macOS；openpyxl 单元格索引从 1 开始。其他平台支持、收费或性能数据暂未提供。