用途:创建、编辑和分析 .xlsx 文件,适合数据整理、财务建模与表格自动化。要求所有交付文件零公式错误(如 #REF!、#DIV/0!、#VALUE!、#N/A、#NAME?)。修改已有模板时须先研究并严格匹配其格式、样式与约定,模板约定优先于本规范。
主要能力:用 pandas 做数据分析、统计与可视化,用 openpyxl 处理公式与格式化。关键原则是使用 Excel 公式而非 Python 计算后硬编码值,保证表格可随源数据重算。
规范:财务模型中,蓝色文字(RGB 0,0,255)表示硬编码输入,黑色(0,0,0)表示公式与计算,绿色(0,128,0)表示工作簿内跨表链接,红色(255,0,0)表示外部文件链接,黄色背景(255,255,0)表示需注意的关键假设。数字格式:年份存为文本(如 "2024"),货币用 $#,##0 并在表头标明单位,零值显示为 "-",百分比默认 0.0%,估值倍数用 0.0x,负数用括号。所有假设(增长率、利润率、倍数等)放在独立单元格,公式中用单元格引用而非硬编码;硬编码需注明来源,格式为 "Source: [系统/文档], [日期], [具体引用], [URL]"。
使用方式:数据分析用 pandas;公式与格式化用 openpyxl。openpyxl 单元格索引从 1 开始。创建或修改后必须重算:python recalc.py output.xlsx [timeout_seconds],如 python recalc.py output.xlsx 30。脚本首次运行自动配置 LibreOffice,重算全部工作表并扫描错误,返回含错误类型与位置的 JSON;若 status 为 errors_found,按 error_summary 修复后重算。
限制:openpyxl 写入的公式仅为字符串、无计算值,需 recalc.py 重算;用 data_only=True 打开并保存会永久丢失公式;需假定已安装 LibreOffice。资料未提供具体收费、价格或平台信息。