用途:创建、编辑、分析和可视化电子表格,支持 .xlsx、.xlsm、.csv 等格式。适用于构建带公式、格式和结构化布局的新工作簿;读取或分析表格数据(筛选、聚合、透视、计算指标);在不破坏公式和引用的前提下修改现有工作簿;用图表和表格可视化数据。系统与用户指令始终优先。
主要能力:使用 openpyxl 创建/编辑 .xlsx 并保留格式,使用 pandas 做分析与 CSV/TSV 处理,图表优先用 openpyxl.chart 生成原生 Excel 图表。公式要求:派生值用公式而非硬编码,保持公式简洁,避免 INDIRECT、OFFSET 等易变函数,优先单元格引用而非魔法数字,并防范 #REF!、#DIV/0! 等错误。注意 openpyxl 不计算公式,公式保留原样,结果在 Excel/Sheets 中计算。
使用方式:先确认文件类型与目标;中间文件放 tmp/spreadsheets/,完成后删除;最终产物写入 output/spreadsheet/。依赖安装优先用 uv:uv pip install openpyxl pandas;无 uv 时用 python3 -m pip install openpyxl pandas;可选 uv pip install matplotlib。渲染检查需 LibreOffice 与 Poppler:soffice --headless --convert-to pdf --outdir $OUTDIR $INPUT_XLSX 与 pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME;macOS 用 brew install libreoffice poppler,Ubuntu/Debian 用 sudo apt-get install -y libreoffice poppler-utils。无渲染工具时请用户本地检查版式。无需环境变量。
格式与引用:修改已有表格前尽量先渲染检查,保留原有格式;新表格使用合适的数字/日期格式、清晰布局、选择性边框。引用来源用纯文本 URL,财务模型输入来源写在单元格批注中,网络表格数据加 Source 列。财务要求:零显示为“-”,负数红色加括号,表头注明单位。投行模型布局:合计直接对上方区域求和,隐藏网格线,节标题用深色填充白字合并单元格等。
限制:openpyxl 不计算公式;渲染依赖 LibreOffice 与 Poppler,缺失时无法自动视觉检查;资料未提供具体收费、平台支持范围与效果数据。