excel-insert

This skill follows [[excel-safe-workflow]] four-step method. Must complete Requirement Parsing→Scout→Plan before execution, and Verify after. 本技能遵循 [[excel-safe-workflow]] 四步法。执行前必须完成 需求解析→勘察→规划，执行后必须验证。

Excel Safe Insert (Row & Column) / Excel 安全插入（行列通用）

第零步：需求解析

自动识别插入类型 / Auto-detect Insert Type

从用户原话中判断要插入列还是行：

用户说	判定
"插入列""加一列""新增列""左边""右边""E列后面"	→ 列模式
"插入行""加一行""新增行""上面""下面""第5行后面"	→ 行模式

列模式解析

要素	常见表述	默认值
目标位置	"第5列左边""E列右侧""申请日后面"	必须明确
插入方向	"左边""左侧""前面" → left；"右边""右侧""后面" → right	left
表头命名	"叫xxx" → 指定	"新列" 或留空
填充内容	"填xxx" → 值/公式	空

行模式解析

要素	常见表述	默认值
目标位置	"第5行上面""第3行下面"	必须明确
插入方向	"上面""上方""前面" → above；"下面""下方""后面" → below	above
填充内容	"填xxx" → 值/公式	空（留白行）

解析示例

用户说	提取
"在E列左边插入一列，叫'格式化日期'"	列模式, E列, left, 表头='格式化日期'
"第5行下面加三行空行"	行模式, 第5行, below, 3行, 空
"申请日后面加一列"	列模式, 申请日(勘察定位), right

第一步：勘察

import os, sys
sys.stdout.reconfigure(encoding='utf-8')
from openpyxl import load_workbook

FILE = '目标文件.xlsx'
size_mb = os.path.getsize(FILE) / 1024 / 1024
print(f'文件大小: {size_mb:.1f} MB')

wb = load_workbook(FILE)
ws = wb.active
print(f'工作表: {ws.title}, 行: {ws.max_row}, 列: {ws.max_column}')

# 展示表头（列模式需要）
print('\n=== 表头 ===')
for col_idx in range(1, ws.max_column + 1):
    h = ws.cell(row=1, column=col_idx).value
    if h:
        col_letter = chr(64 + col_idx) if col_idx <= 26 else f'col{col_idx}'
        print(f'  列{col_idx} [{col_letter}]: {h}')

# 如果用户用名称定位 → 匹配列号或行号
target_idx = None  # 最终的列号或行号

# 列模式：定位列号
if MODE == 'column':
    if isinstance(target_spec, str):  # 用户说的是列名
        for col_idx in range(1, ws.max_column + 1):
            if ws.cell(row=1, column=col_idx).value == target_spec:
                target_idx = col_idx
                print(f'\n定位: "{target_spec}" → 列{target_idx}')
                break
    else:
        target_idx = int(target_spec)  # 用户直接给列号

# 行模式：定位行号
elif MODE == 'row':
    target_idx = int(target_spec) if isinstance(target_spec, int) else int(target_spec)

# 双重扫描（检查附近是否有公式）
print('\n=== 公式检查 ===')
wb2 = load_workbook(FILE, data_only=True)
ws2 = wb2.active
if MODE == 'column':
    check_range = range(max(1, target_idx - 2), min(ws.max_column + 1, target_idx + 3))
else:
    check_range = range(1, ws.max_column + 1)  # 行模式检查整行

for col_idx in check_range:
    for row_idx in range(max(1, target_idx - 2), min(ws.max_row + 1, target_idx + 3)) if MODE == 'row' else range(2, min(6, ws.max_row + 1)):
        v_raw = ws.cell(row=row_idx, column=col_idx).value
        if v_raw and isinstance(v_raw, str) and v_raw.startswith('='):
            print(f'  ⚠️ 列{col_idx}行{row_idx}: 公式 = {v_raw[:50]}')
wb2.close()

print(f'\n准备执行: {MODE}模式, 位置={target_idx}, 方向={DIRECTION}')