SuperAPI AI 工具集

xlsx

办公与效率

查看项目

更新于 10-15 21:39

技能介绍

用途:当用户要求创建、编辑或分析 .xlsx 文件,且工作簿文件本身是主要交付物时使用,覆盖公式、格式、财务模型等场景。

主要能力:用 pandas 做数据分析、可视化与基础操作;用 openpyxl 处理公式、格式与 Excel 专有功能;用 scripts/recalc.py 借助 LibreOffice 重算公式并扫描错误。

安装:uv pip install openpyxl pandas;可选 uv pip install python-calamine(pandas 2.2+ 更快读取);处理不可信文件可 uv pip install defusedxml。公式重算需系统安装 LibreOffice(soffice --version 验证),Unix socket 受限时需 gcc,macOS 可选 gtimeout。

用法要点:所有计算应写成 Excel 公式而非 Python 硬编码值,如 =SUM(B2:B9)、=(C4-C2)/C2;创建或修改后必须重算:python skills/xlsx/scripts/recalc.py output.xlsx [timeout_seconds],脚本返回 JSON,含 status、total_errors、total_formulas 及 error_summary 中的错误类型与位置,需修复 #REF!、#DIV/0!、#VALUE!、#NAME? 等错误后再次重算。

格式规范:交付文件使用一致的专业字体;财务模型按行业惯例配色(蓝色为硬编码输入、黑色为公式、绿色为同工作簿跨表链接、红色为外部链接、黄色背景为关键假设);数字格式如货币 $#,##0、百分比 0.0%、倍数 0.0x、负数用括号、零显示为“-”;年份按文本字符串处理;假设集中放在独立单元格并用引用;硬编码值需注明来源。更新模板时须严格匹配既有格式与约定,模板约定优先。

限制:openpyxl 写入的公式为字符串、不含计算值,必须重算;以 data_only=True 打开并保存会永久丢失公式;大文件可用 read_only/write_only。资料未提供收费、价格与平台信息。