XLSX创建、编辑和分析
| 任务 | 方法 |
|---|---|
| 创建或编辑带公式/格式 | openpyxl — 参见下方的注意事项 |
| 批量数据导入/导出 | pandas（read_excel、to_excel） |
| 快速查看工作表 | markitdown file.xlsx — 每个工作表显示## SheetName；也读取.xlsm。不提供单元格坐标，因此不要基于它规划编辑 |
| 读取模型（公式和值） | 两次load_workbook遍历 — 参见注意事项 |
openpyxl、pandas和markitdown已预装 — 不要先运行uv pip install；直接编写脚本并导入。仅当导入失败（或markitdown命令缺失）时：运行uv pip install安装缺失的包。
以下脚本路径相对于此技能所在的目录。
每个输出文件的要求
- 专业字体（Arial、Times New Roman）通篇使用，除非用户另有说明。
- 零公式错误。 绝不要在
recalc.py报告errors_found时交付。如果你认为错误早于你的修改，请证明：以data_only=True加载原始文件并查看该单元格。你引入的错误看起来完全像你继承的错误。 - 使用公式，绝不使用硬编码结果。 编写
sheet['B10'] = '=SUM(B2:B9)'，而不是Python计算的总和。工作表必须在输入变化时重新计算。 - 严格遵循用户的规格说明。 确切的工作表名称、确切的列标题以及用户拼写出来的公式。一个计算出不同结果的重设计，无论多么优雅，都是失败的。
- 在读者能看到的位置记录每个假设和硬编码数字 — 单元格批注，或表格末尾的相邻单元格。若存在真实来源，请引用（
来源：公司10-K，2024财年，第45页，收入附注，[SEC EDGAR URL]）；当数字来自用户时，如实说明。 - 你为他人填写而创建的工作簿需要有一个简短的图例，指明哪些单元格需要编辑，并包含一行真实值的示例行以显示预期格式。切勿将这样的示例行添加到被要求编辑的文件中。
- 编辑现有文件：完全遵循其约定。 它们优先于此处的所有指南。首先找到其指定的输入单元格（通过不同的字体颜色、填充或底纹标记），仅在这些单元格中写入，并保持所有现有公式不变。
重新计算（只要文件包含公式，此项强制）
openpyxl将公式作为字符串写入，不包含缓存值。在重新计算之前，每个公式单元格对于任何读取缓存值的方式（pandas、load_workbook(data_only=True)以及大多数预览器）都返回None。
python scripts/recalc.py output.xlsx [timeout_seconds] # 默认30
LibreOffice计算每个公式，文件被原地重写，并返回JSON：status（success | errors_found）、total_formulas、total_errors，以及一个error_summary，按错误类型命名最多100个单元格（locations_truncated说明它省略了多少个 — 相信total_errors，而不是列表的长度）。修复它命名的内容并再次运行。包含error键而非status的JSON表示未进行任何重新计算，仅此情况会以非零退出 — errors_found以0退出，因此切勿将干净的退出视为干净的工作簿。
成功的重新计算证明你的公式可求值，而不是它们是正确的。 一个差一的区间或指向错误行的引用会生成一个干净、无错误的文件，但数字错误。在构建整个网格之前，先编写2-3个公式并检查它们是否返回了你期望的值。
链接到另一个文件的工作簿如果你使用openpyxl重新保存它然后重新计算，这些链接会丢失。这样的公式读取为='[1]Returns Analysis'!$B$2 — [1]是工作簿外部引用列表中的一个索引，指向磁盘上的一个单独文件，而不是工作表。该文件在此处通常不存在，因此单元格的缓存值是唯一持有其数据的东西。openpyxl在保存时剥离该值；然后LibreOffice必须真正解析该引用，失败，写入#NAME?，并删除所有链接。recalc.py拒绝在此状态下运行 — 在覆盖保存之前，将这些单元格的值复制到原始文件之外（--force覆盖并接受损失）。
选择能够通过验证的公式
LibreOffice实现的功能少于Excel，并且它无法求值的一个功能会变成字面量#NAME?，嵌入你交付的文件中。
- 优先使用Excel 2007时代的函数 —
SUMIFS、INDEX、MATCH、IFERROR、SUMPRODUCT— 这些不需要前缀。 - 六个2007年之后的函数可以工作，但仅当带有
_xlfn.前缀时，因为openpyxl将你的公式逐字写入XML，而Excel以前缀形式存储2007年之后的名称（其UI隐藏了该前缀）：_xlfn.TEXTJOIN、_xlfn.CONCAT、_xlfn.IFS、_xlfn.SWITCH、_xlfn.MAXIFS、_xlfn.MINIFS。裸写时，每个都会产生#NAME?。 - 绝不要使用
XLOOKUP、XMATCH、SORT、FILTER、UNIQUE或SEQUENCE。 运行时的LibreOffice无法在任何前缀下求值它们。更新的构建版本可以求值它们，但它们是溢出数组函数，而openpyxl写入的文件没有溢出元数据，因此只有范围的左上角单元格获得值 — 并且recalc.py在截断的结果上报告total_errors: 0。对于查找，请使用INDEX/MATCH；在写入单元格之前，在Python中对数据进行排序、过滤和去重。 - LibreOffice无法解析的公式会被以小写形式写回 — 这是
#NAME?旁边的快速线索。
openpyxl 注意事项
- 读取模型需要两次加载。
data_only=True返回缓存值（公式已消失）；默认加载返回公式字符串（无值）。一次遍历不能同时提供两者。 - 如果你保存，
data_only=True是破坏性的。 该工作簿不再有公式，因此保存会用一个字面量永久替换每个公式。 - 对一个openpyxl刚刚写入的文件使用
data_only=True会在任何地方返回None— 先运行recalc.py。（结果为空字符串""的公式也返回None。） - 合并单元格：仅写入左上角的锚点。 范围内的其他每个单元格都是
MergedCell，其.value是只读的。 - 除非你向
load_workbook传递keep_vba=True，否则.xlsm会丢失其宏。 - 包含空格的工作表名称在跨工作表引用中必须用引号括起来：
='Assumptions Inputs'!$B$5。未加引号时，它求值为#VALUE!。
财务模型
除非用户另有说明，或现有文件已经采用了不同做法。
颜色： 硬编码输入和场景杠杆使用蓝色文本（0,0,255）· 公式使用黑色 · 指向另一个工作表的链接使用绿色（0,128,0）· 指向另一个文件的链接使用红色（255,0,0）· 关键假设和用户应填写的单元格使用黄色填充（255,255,0）。
数字： 货币格式$#,##0，并在标题中注明单位（收入（$mm））· 零显示为-，包括在百分比中（$#,##0;($#,##0);-）· 负数用括号表示 · 百分比格式0.0%，存储为小数（0.15显示15.0%；存储15显示1500.0%）· 估值倍数格式0.0x · 年份作为文本（"2024"，绝不能是2,024）。
结构： 每个假设在其自己的标注单元格中，由使用它的公式引用（=B5*(1+$B$6)，绝不能=B5*1.05）· 公式在每个预测期间保持一致，因为行中间一个孤立的编辑单元格是最常见的无声错误 · 保护可能为零的分母。
依赖项
openpyxl、pandas、markitdown（pip，已预装 — 仅当导入失败或命令缺失时安装）· LibreOffice（soffice，已自动配置用于沙盒环境，通过scripts/office/soffice.py）
此技能由Anthropic创建和维护。此处仅修改了前置元数据，其余内容未经修改；许可条款见LICENSE.txt。