Excel 安全插入

解决的具体问题

在 Excel 中手动插入行或列时，常遇到三类问题：一是需求表述模糊，“左边”“后面”等描述易导致插入方向错误；二是复杂公式引用（如 INDIRECT、OFFSET）在插入后无法自动更新，打乱原有计算逻辑；三是合并单元格区域与插入位置相交时，手动调整易破坏格式或丢失数据，且误操作后缺乏即时恢复手段。

核心能力与工作流程

本技能基于 excel-safe-workflow 四步法，将非结构化的用户需求转化为可执行的插入操作：

• 需求解析：自动识别插入类型（行/列），提取目标位置（如“E列右侧”“第5行下面”）、方向（left/right/above/below）、表头（列模式可指定，默认“新列”或留空）及填充内容（值/公式，默认空）。
• 勘察与规划：定位插入点，列插入时 DIRECTION == 'left' 对应 insert_cols(target_col)，'right' 对应 insert_cols(target_col + 1)，多列从右到左处理；行插入时 DIRECTION == 'above' 对应 insert_rows(target_row)，'below' 对应 insert_rows(target_row + 1)，多行从下到上排序后插入。
• 执行与验证：严格按规划步骤操作，完成后校验插入位置、表头及填充内容是否符合预期，确保结果与需求一致。
• 安全备份：操作前自动备份（时间戳命名），成功后保留最新3份；若失误导致文件损坏，立即删除并从备份恢复，避免数据丢失。

适用边界与注意点

• 公式引用：仅 openpyxl 支持的直接引用会自动更新，INDIRECT、OFFSET 等间接引用需手动核对。
• 合并单元格：插入位置与合并区域相交时，合并范围会自动扩展，需确认是否符合预期。
• 需求明确性：目标位置必须明确（如“第5列左边”需勘察定位），模糊描述（如“随便加一列”）可能导致操作偏差。