用途:创建、编辑和分析 .xlsx 文件,覆盖公式、格式、数据分析与可视化。
主要能力:用 pandas 读取与分析数据(pd.read_excel、sheet_name=None 读取全部工作表、head/info/describe);用 openpyxl 创建或修改工作簿,设置字体、填充、对齐、列宽,插入/删除行列、新建工作表;用 recalc.py 重算公式并扫描错误。
必要用法:所有计算必须写成 Excel 公式而非 Python 硬编码值,例如 =SUM(B2:B9)、=(C4-C2)/C2、=AVERAGE(D2:D19),保证源数据变化后可重算。使用公式后必须运行 skills/xlsx/recalc.py output.xlsx [timeout_seconds] 重算,脚本首次运行自动配置 LibreOffice,返回 JSON,含 status、total_errors、total_formulas 及 error_summary(错误类型与位置)。若 status 为 errors_found,按位置修复后重算。
规范:所有 Excel 文件须零公式错误(#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?)。更新模板时须完全匹配既有格式与约定,模板约定优先于本指南。财务模型配色:蓝色 RGB 0,0,255 为硬编码输入,黑色 0,0,0 为公式,绿色 0,128,0 为同工作簿跨表链接,红色 255,0,0 为外部链接,黄色背景 255,255,0 为关键假设。数字格式:年份用文本,货币用 $#,##0 并在表头注明单位,零显示为“-”,百分比默认 0.0%,倍数用 0.0x,负数用括号。假设须放在独立单元格并以引用代替硬编码,硬编码需注明来源。
限制:openpyxl 保存的公式不计算结果,须用 recalc.py;以 data_only=True 打开并保存会永久丢失公式;大文件用 read_only/write_only。资料未提供安装方式、收费与平台支持等细节。