name: xlsx description: 全面的电子表格创建、编辑和分析，支持公式、格式化、数据分析和可视化。当处理电子表格文件（.xlsx, .xlsm, .csv, .tsv）时使用，用于创建带有公式和格式的新电子表格、读取或分析数据、修改现有电子表格同时保留公式、数据分析和可视化，或重新计算公式。

输出要求

所有Excel文件

零公式错误

每个Excel模型必须交付时零公式错误（#REF!, #DIV/0!, #VALUE!, #N/A, #NAME?）

保留现有模板（当更新模板时）

在修改文件时，研究和完全匹配现有格式、样式和约定
永远不要对具有已建立模式的文件施加标准化格式化
现有模板约定始终覆盖这些指南

财务模型

对于财务模型、DCF和估值 - 阅读references/financial-model-standards.md以获取颜色编码、数字格式化、公式构建规则和文档要求。

XLSX创建、编辑和分析

概述

用户可能要求您创建、编辑或分析.xlsx文件的内容。您有不同的工具和工作流程可用于不同的任务。

重要要求

LibreOffice需要用于公式重新计算：您可以假设安装了LibreOffice，用于使用recalc.py脚本重新计算公式值。脚本在首次运行时自动配置LibreOffice。

读取和分析数据

使用pandas进行数据分析

对于数据分析、可视化和基本操作，使用pandas，它提供强大的数据操作能力：

import pandas as pd

# 读取Excel
df = pd.read_excel('file.xlsx')  # 默认：第一个工作表
all_sheets = pd.read_excel('file.xlsx', sheet_name=None)  # 所有工作表作为字典

# 分析
df.head()      # 预览数据
df.info()      # 列信息
df.describe()  # 统计信息

# 写入Excel
df.to_excel('output.xlsx', index=False)

关键：使用公式，而非硬编码值

始终使用Excel公式，而不是在Python中计算值并硬编码它们。 这确保电子表格保持动态和可更新。

错误 - 硬编码计算值

# 错误：在Python中计算并硬编码结果
total = df['Sales'].sum()
sheet['B10'] = total  # 硬编码5000

# 错误：在Python中计算增长率
growth = (df.iloc[-1]['Revenue'] - df.iloc[0]['Revenue']) / df.iloc[0]['Revenue']
sheet['C5'] = growth  # 硬编码0.15

# 错误：Python计算平均值
avg = sum(values) / len(values)
sheet['D20'] = avg  # 硬编码42.5

正确 - 使用Excel公式

# 正确：让Excel计算总和
sheet['B10'] = '=SUM(B2:B9)'

# 正确：增长率作为Excel公式
sheet['C5'] = '=(C4-C2)/C2'

# 正确：使用Excel函数计算平均值
sheet['D20'] = '=AVERAGE(D2:D19)'

这适用于所有计算 - 总计、百分比、比率、差异等。电子表格应在源数据更改时能够重新计算。

常见工作流程

选择工具：pandas用于数据，openpyxl用于公式/格式化
创建/加载：创建新工作簿或加载现有文件
修改：添加/编辑数据、公式和格式化
保存：写入文件
重新计算公式（如果使用公式，必须执行）：使用recalc.py脚本
```
python recalc.py output.xlsx
```
验证并修复任何错误：
- 脚本返回JSON，包含错误详情
- 如果status是errors_found，检查error_summary获取特定错误类型和位置
- 修复识别出的错误并再次重新计算
- 常见错误修复：
  - #REF!：无效单元格引用
  - #DIV/0!：除以零
  - #VALUE!：公式中错误的数据类型
  - #NAME?：未识别的公式名称

有关详细代码示例（创建/编辑文件），阅读references/openpyxl-patterns.md。

重新计算公式

由openpyxl创建或修改的Excel文件包含公式作为字符串，但不包含计算值。使用提供的recalc.py脚本重新计算：

python recalc.py <excel_file> [timeout_seconds]

示例：

python recalc.py output.xlsx 30

脚本：

首次运行时自动设置LibreOffice宏
重新计算所有工作表中的所有公式
扫描所有单元格以查找Excel错误（#REF!, #DIV/0!等）
返回JSON，包含详细错误位置和计数
在Linux和macOS上工作

有关公式验证清单和recalc.py输出解释，阅读references/formula-verification.md。

代码风格指南

重要：当为Excel操作生成Python代码时：

编写最小、简洁的Python代码，无需不必要的注释
避免冗长的变量名和冗余操作
避免不必要的打印语句

对于Excel文件本身：

为复杂公式或重要假设的单元格添加注释
记录硬编码值的数据源
包括关键计算和模型部分的备注

参考

references/financial-model-standards.md - 财务模型的颜色编码、数字格式化、公式构建规则、文档要求
references/openpyxl-patterns.md - 创建/编辑文件的代码示例、库选择指南、openpyxl和pandas技巧
references/formula-verification.md - 验证清单、常见陷阱、recalc.py输出解释