用途:创建、编辑和分析 .xlsx 电子表格,覆盖公式、格式、数据分析与可视化。
主要能力:用 pandas 读取与分析数据(pd.read_excel、sheet_name=None 读取全部工作表、head/info/describe);用 openpyxl 处理公式与格式;用 recalc.py 借助 LibreOffice 重算公式并扫描错误。
关键要求:所有 Excel 文件必须零公式错误(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?);更新模板时须严格匹配既有格式、样式与约定,既有模板约定优先于通用规范;始终使用 Excel 公式而非在 Python 中计算后硬编码,如 =SUM(B2:B9)、=(C4-C2)/C2、=AVERAGE(D2:D19),以保证表格可随源数据重算。
使用方式:选择工具(数据用 pandas,公式/格式用 openpyxl);创建或加载工作簿;修改数据、公式与格式;保存;若使用公式则必须重算:python recalc.py output.xlsx(可加超时秒数,如 python recalc.py output.xlsx 30)。脚本首次运行自动配置 LibreOffice 宏,重算所有工作表公式,扫描全部单元格错误,返回含错误位置与数量的 JSON;若状态为 errors_found,查看 error_summary 定位并修复后重算。支持 Linux 与 macOS。
适用场景:数据分析、财务模型、DCF 与估值等。财务模型需参考 references/financial-model-standards.md 的颜色编码、数字格式、公式构建规则与文档要求;代码示例见 references/openpyxl-patterns.md;校验清单与脚本输出解读见 references/formula-verification.md。
限制:需假定已安装 LibreOffice 以重算公式;openpyxl 生成的文件仅含公式字符串而无计算值,必须经 recalc.py 重算;具体安装步骤与更多平台支持暂未提供。