xlsx

用途：当电子表格文件是主要输入或输出时使用，涵盖打开、读取、编辑、修复、创建与分析 .xlsx 文件的任务。工具分工：数据分析、批量操作和简单导出用 pandas；复杂格式化、公式和 Excel 特有功能用 openpyxl。核心原则：始终使用 Excel 公式而非 Python 硬编码计算结果（如用 =SUM(B2:B9) 而非写入总和），以保持工作簿动态可更新。创建或修改后需重算公式：openpyxl 只存公式字符串不存计算值，运行 python scripts/recalc.py <excel_file> [timeout_seconds]（示例 python scripts/recalc.py output.xlsx 30），脚本依赖 LibreOffice，首次运行自动配置，返回 JSON 含错误位置与数量，若 status 为 errors_found 需按 error_summary 修复后重算，常见错误包括 #REF!、#DIV/0!、#VALUE!、#NAME?。输出要求：所有 Excel 文件用一致的专业字体，公式零错误；更新模板时严格匹配原有格式与约定，模板约定优先。财务模型约定：蓝字 RGB 0,0,255 为硬编码输入，黑字 RGB 0,0,0 为公式计算，绿字 RGB 0,128,0 为同工作簿跨表链接，红字 RGB 255,0,0 为外部链接，黄底 RGB 255,255,0 为需注意的关键假设；年份按文本格式，货币用 $#,##0 并在表头标注单位，零值显示为“-”，百分比默认 0.0%，倍数用 0.0x，负数用括号。公式构造：所有假设置于独立单元格并以引用代替硬编码值（如 =B5*(1+$B$6)），硬编码值需注释来源。使用 openpyxl 时索引从 1 开始，data_only=True 读取计算值但保存会永久丢失公式，大文件可用 read_only/write_only。pandas 可指定 dtype、usecols、parse_dates。限制：公式必须重算验证；模板原有约定覆盖通用规范；资料未提供其他收费、平台或效果信息。