用途:当电子表格文件是主要输入或输出时使用,例如打开、读取、编辑、修复或新建 .xlsx 文件,以及进行数据分析与财务模型构建。
主要能力:可用 pandas 读取与分析数据、批量导出;用 openpyxl 创建、编辑文件并处理公式与格式,包括字体、填充、对齐、列宽、多工作表操作。要求所有计算使用 Excel 公式而非 Python 硬编码结果,保证表格可随源数据重算。
必要用法:创建或修改含公式的文件后,必须用脚本重算并校验:python scripts/recalc.py <excel_file> [timeout_seconds],脚本依赖 LibreOffice,首次运行会自动配置,返回 JSON 报告错误类型与位置(如 #REF!、#DIV/0!、#VALUE!、#NAME?),报错后修复并再次重算。
输出与规范:使用一致的专业字体;公式零错误;更新模板时严格匹配原有格式,模板约定优先;财务模型采用行业颜色规范,如蓝色文本为硬编码输入、黑色为公式计算、绿色为同一工作簿内跨表链接、红色为外部链接、黄色背景为需关注的假设;数字格式涵盖年份文本、货币 $#,##0 并在表头标注单位、零显示为“-”、百分比 0.0%、倍数 0.0x、负数用括号;所有假设放在独立单元格并以引用方式使用;硬编码值需注明来源,格式为“Source: [系统/文档], [日期], [具体引用], [URL]”。
限制:仅依据资料未提供其他功能或收费信息;使用 data_only=True 读取后若保存会永久丢失公式;大型文件建议以只读或只写模式处理。