技能介绍

解决 Excel 自动化中的文件损坏与公式硬编码问题

在处理 Excel 自动化任务时，开发者常面临两个核心痛点：一是使用常规库（如 openpyxl）直接读写现有文件会导致 VBA 宏、数据透视表和迷你图等高级特性丢失或损坏；二是生成的表格常将计算结果硬编码为静态数值，丧失了 Excel 原生的公式联动能力。此外，复杂的格式化要求和跨表引用追踪也使得脚本开发变得繁琐。

核心能力与关键工作流

该技能通过底层 XML 直编与严谨的脚本路由机制，提供了一套可靠的 Excel 处理流水线。

任务路由与读写：根据请求类型（读取、新建、编辑、修复、校验）自动分发。读取时结合 xlsx_reader.py 与 pandas 进行结构探索与数据分析，严格保证源文件不被修改。
XML 级编辑与新建：新建文件基于最小化 XML 模板，而编辑现有文件则通过“解包（unpack）→ 编辑 → 重新打包（pack）”的流程。这彻底规避了 openpyxl 带来的数据破坏风险。
公式优先（Formula-First）：所有派生数据均强制使用 Excel 原生公式（如 SUM）而非硬编码数字。内置财务级颜色标准，自动区分硬编码输入（蓝色）、公式结果（黑色）与跨表引用（绿色）。
行级操作与验证：支持安全地插入行、添加列并自动继承相邻列的样式或更新汇总公式。修改后必须通过 xlsx_reader.py 或 pandas 验证 sheet 完整性与数据一致性。

适用边界与注意事项

安全与权限：技能遵循严格的安全边界，默认不执行系统级修改或依赖安装。涉及发送、发布、删除等外部写入操作前，必须向用户明确确认目标与影响。
动态校验依赖：静态公式检查通过 formula_check.py 完成，但复杂的动态重算（如涉及循环引用或跨表依赖）依赖于环境中的 libreoffice_recalc.py，需确保运行环境已配置相应组件。