用途:当电子表格文件是主要输入或输出时使用,例如打开、读取、编辑或修复现有 .xlsx 文件,以及创建新表格、做数据分析或构建财务模型。
主要能力:用 pandas 读取与分析数据(pd.read_excel、df.head、df.describe 等),用 openpyxl 创建和编辑文件、写入公式与格式(字体、填充、对齐、列宽),支持多工作表操作、插入行、删除列、新建工作表。要求始终使用 Excel 公式而非在 Python 中算好再硬编码,保证表格可随源数据重算。
使用方式:数据分析与批量操作选 pandas,公式与复杂格式选 openpyxl。创建或修改后若含公式,必须运行 python scripts/recalc.py output.xlsx [timeout_seconds] 重算,脚本依赖 LibreOffice,首次运行会自动配置,返回 JSON 报告错误位置与数量;若 status 为 errors_found,按 error_summary 修复后重算。
规范与限制:所有交付文件应使用一致的专业字体,公式错误须为零(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?)。更新模板时须完全匹配既有格式与约定,模板约定优先于通用指南。财务模型建议配色:蓝色为硬编码输入,黑色为公式,绿色为同工作簿跨表链接,红色为外部链接,黄色背景为关键假设。数字格式:年份用文本,货币用 $#,##0 并在表头注明单位,零显示为“-”,百分比默认 0.0%,倍数用 0.0x,负数用括号。假设应放在独立单元格并用引用。硬编码需注明来源。openpyxl 以 data_only=True 打开并保存会永久丢失公式;公式需用 recalc.py 求值。
适用场景:财务建模、数据清洗与分析、模板更新、批量表格生成。具体收费、平台与效果资料暂未提供。