Documentation
README
Excel 工具
原则
- 输入表格只读，输出写入
PROJECT_ROOT。 - 普通结果汇总优先 CSV。
- 题目指定 XLSX、需保留公式、多工作表或模板结构时才使用 XLSX。
- 不覆盖题目原始附件和 Skill 文件。
读取与写入
import pandas as pd
# 第一行就是数据时必须显式使用 header=None。
data = pd.read_excel("data/input.xlsx", sheet_name=0, header=None)
assert len(data) == 7470, f"行数异常: {len(data)}"
result = pd.DataFrame({"方案": names, "目标值": values})
result.to_excel("results/结果.xlsx", index=False)
禁止依赖 pandas.read_excel() 默认的 header=0 猜测表头，否则第一行数据会被当成列名。未知表头结构或必须精确保留行时使用无隐式推断的读取工具：
from scripts.read_rows import read_excel_rows
rows = read_excel_rows(
"data/input.xlsx",
header=False,
expected_rows=7470,
)
assert rows[0][0] == 399.6747
读取后必须核对首行、末行、原始工作表有效行数和题目声明的记录数；行数不符时立即报错，不得静默继续建模。
This is the opening of the README. Read the full README on GitHub.