Minimax Xlsx

核心用法

minimax-xlsx 是一套企业级电子表格生产系统，专为需要高可靠性Excel交付物的定量分析任务设计。其核心工作流采用五阶段严格协议：理解任务→设计工作簿→构建与审计→认证文件→交付检查。系统通过Python 3（openpyxl+pandas）完成数据清洗、公式编写与样式渲染，再通过LibreOffice无头模式重算公式，最后用C# CLI工具进行结构验证、引用检查和图表审计。

显著优点

零错误交付保障：内置三重校验机制——recalc.py检测公式错误（#VALUE!/#REF!等）、MiniMaxXlsx recalc识别隐性数组公式兼容性问题、refcheck捕捉引用偏差。任何非零错误计数均阻断交付。

动态计算优先原则：强制要求所有可推导值必须通过公式表达，禁止硬编码计算结果，确保全程可追溯与可审计。

跨平台兼容性设计：主动规避Excel 365+独占函数（XLOOKUP/LET/LAMBDA等），提供完整的向下兼容替代方案，确保文件在Excel 2016/2019环境中正常打开。

专业视觉规范：预置四套主题（financial/verdant/dusk/grayscale），强制封面页结构，统一蓝/黑双色编码区分输入项与公式，消除网格线提升可读性。

潜在局限

学习曲线陡峭：五阶段协议与数十条硬约束（如禁止pandas merge替代VLOOKUP）对新手分析师形成较高认知负担，误操作易导致验证失败。

外部数据依赖管理：强制要求为所有抓取数据添加来源追溯列（Provider/Reference Link），在快速原型阶段可能拖慢迭代速度。

PivotTable终局限制：透视表必须通过CLI工具一次性生成，生成后禁止再编辑，对需要频繁调整布局的探索性分析不够灵活。

二进制CLI信任问题：核心验证工具MiniMaxXlsx为C#编译产物，无法像Python源码一样完全审计，企业安全团队可能需要额外审查。

适合人群

• 财务分析师、投资研究员：需要提交可审计、零错误的财务模型与估值表格
• 数据合规专员：处理需完整数据来源追溯的监管报送材料
• 咨询顾问：向客户交付专业格式、跨版本兼容的定量分析报告

常规风险

• 未阅读./pivot.md或./charts.md即创建复杂对象，导致文件损坏
• 忽略recalc报错强行交付，用户打开后出现#REF!等错误令牌
• 未配置LibreOffice宏即首次运行recalc.py，导致公式重算失败
• 在pivot生成后继续使用openpyxl修改文件，破坏XML引用使Excel无法打开

核心功能

minimax-xlsx 是一套面向专业场景的电子表格生产工具链，核心定位是将原始数据转化为可直接交付的 Excel 工作簿。系统整合了三大技术层：

构建层：Python 3 生态（openpyxl + pandas）负责工作簿创建、样式应用、公式植入与数据处理。openpyxl 处理 Excel 的 OpenXML 底层结构，pandas 承担数据清洗与转换。

验证层：recalc.py 脚本调用 LibreOffice 无头模式对所有公式进行实际计算，生成错误报告（JSON 格式），填补 openpyxl"写入公式但不计算结果"的能力缺口。配套的 MiniMaxXlsx CLI（C#/.NET）提供多维度审计：公式错误检测（#VALUE!/#REF! 等）、引用异常检查（范围溢出、首行误包）、图表有效性验证、OpenXML 标准合规性检验。

高级功能：原生 OpenXML 级别的数据透视表合成（非 openpyxl 模拟）、图表自动布局与重叠检测。

显著优点

1. 零容错交付标准：强制五阶段工作流（理解→设计→构建→验证→交付），每阶段设置硬性 gate，公式错误零容忍
2. 兼容性保障：显式阻断 Excel 365+ 专属函数（XLOOKUP/LET/FILTER 等），强制使用 INDEX/MATCH、SUMIF/COUNTIF 等跨版本通用方案
3. 可审计性：外部数据强制附加溯源列（Provider + Reference Link），公式链要求动态计算而非硬编码快照
4. 专业输出规范：内置四色主题系统、货币格式强制、合并单元格使用边界、网格线关闭等专业排版规则
5. 工具链闭环：从数据输入到最终 check 命令的结构验证，形成完整质量保证链条

潜在局限

• 技术栈依赖：需要本地 LibreOffice 安装用于公式重算，环境配置存在门槛
• 学习曲线：严格的协议约束（如"禁止 pandas merge 替代 VLOOKUP"）对熟练用户形成额外规制
• 透视表限制：必须通过 CLI 工具生成，生成后文件不可再用 openpyxl 修改（会破坏 XML 引用）
• 网络隔离：设计为离线工具，实时数据 API 集成需外部处理后再接入

适用人群

• 财务分析师、数据顾问、管理咨询顾问等需要交付高置信度 Excel 文件的专业人士
• 审计、合规场景下对公式可追溯性、数据血缘有硬性要求的团队
• 需要将 Python 数据处理能力与 Excel 交付物无缝衔接的技术用户

常规风险

• 路径处理风险：recalc.py 接收用户传入文件路径直接传递给 subprocess，虽扫描未发现目录遍历漏洞，但建议增加扩展名白名单验证
• LibreOffice 宏自动配置：首次运行会写入宏配置，多用户环境需注意权限
• 公式注入边界：虽阻断危险函数，但复杂 INDIRECT/ADDRESS 嵌套仍可能产生意外引用，需配合 refcheck 审计

安全评级说明

CLS-Certify 扫描显示该 Skill 无任何威胁模式：零外部网络通信、零敏感数据收集、零权限升级诱导。subprocess 调用仅限于声明功能内的 LibreOffice 重算，代码行为与文档描述完全一致。供应链攻击面极小（无第三方依赖声明文件）。