行程表 Excel 数据导入技能

功能概述

将会议/活动嘉宾行程 Excel 源表数据，按标准映射规则批量写入车辆预约业务模板（业务导入模版.xlsx）。

模板路径：C:\Users\Administrator\Desktop\业务导入模版.xlsx

核心脚本：scripts/import_itinerary.py

列映射参考：references/column_mapping.md

城市减时参考：references/city_time_rules.md

执行流程

第一步：探查源表结构

运行 scripts/explore_source.py 探查源表的 sheet 列表、每个 sheet 的行数、第一行和表头行（通常为 Row 1 或有明显标题的行）。找出包含行程数据的主 sheet。

隐藏 Sheet 跳过：ws.sheet_state != 'visible' 的 sheet 跳过，不处理。隐藏列、隐藏行照常读取。

⚠️ 不要自行添加用户未要求的过滤逻辑（如按医院名、航班状态过滤行）。

关键信息：

• 表头行（来程/回程字段在哪一行）
• 来程数据区域（行范围）
• 回程数据区域（行范围）
• 姓名、电话、航班号、出发地、到达地、时间等字段所在列
• 各字段所在列索引

第二步：确认城市减时规则

读取 references/city_time_rules.md。

如源表回程出发地涉及已知城市（上海/长沙/扬州泰州），直接使用已有规则。

如出现未记录城市，必须先暂停，向用户询问该城市的减时规则（机场/高铁站分别多少小时），获取答复后再继续。

第三步：提取行程数据

按 references/column_mapping.md 规则逐行提取来程和回程数据，应用过滤、本地场景处理、中转号码提取等逻辑。

具体处理逻辑参见下方 关键规则 章节。

第四步：写入模板并交付

以 scripts/import_itinerary.py 为基础，复制原始模板 → 按规则写入数据（从 Row 2 开始，来程在前，回程在后）→ 验证 Row 1 表头未变动 → 保存结果到桌面 → 通过 deliver_attachments + open_result_view 交付给用户。

关键规则（必须严格执行）

模板保护（铁律）

• 第 1 行表头绝对不动 — 不能删除、修改、覆盖任何表头单元格
• 隐藏行/列保持原样 — 不能取消隐藏，不能修改隐藏内容
• 数据仅从第 2 行开始写入
• G 列（用车类型*）默认填写"单程"
• 写入方式：复制模板 ZIP → 修改 sheet1.xml 数据行 → 保存为新文件

固定填充

源表"车型"列 & "酒店"列 提取（🆕 v1.1）

如果源表有"车型"列，直接按单元格内容导出：

• 小车 / 轿车 → B级轿车
• 商务 / 商务车 → 商务车

如果源表有"酒店"列，按同样方式提取到模板 I/J 列（每人可能不同，替代统一的酒店名称）。

> 优先级：源表"车型"列 > 同序号人数统计算法。

来程字段映射

🆕 源表"上车/下车地"列拆分规则（v1.3）

> ⚠️ 注意："上车/下车地"指的是乘客搭乘火车/飞机的上车点和下车点，不是用车的上车点。

当源表存在表头含"上车/下车地"或"上车/下车"字样的列时，该列格式为 上车地-下车地（如 宁波-上海南站）：

处理规则：

1. 先检查源表是否有此列（表头匹配"上车/下车地"或"上车/下车"）
2. 来程：按 - 拆分 → part[1]（下车地）→ I列；J列 → 用户提供的酒店名称
3. 回程：按 - 拆分 → I列 → 酒店名称；part[0]（上车地）→ J列
4. 如果该列值不含 -（如只有 虹桥高铁站）：
• 来程：整段作为 I列（下车地），J列 → 酒店名称
• 回程：I列 → 酒店名称，整段作为 J列（上车地）
5. ⚠️ 此规则优先于默认的字段映射

> v1.2（已废弃）：错误地把 - 前面→I、后面→J，不符合来程"从抵达站接人→送酒店"的业务逻辑。

> v1.3 修正（2026-05-27）：来程 I=下车地(抵达站)、J=酒店；回程 I=酒店、J=上车地(出发站)。

回程字段映射

> ⚠️ 如果源表没有对应表头关键字，模板对应列留空，不要乱填。

🆕 属地接送特殊处理（v3.9）

> ⚠️ 2026-05-28 新增：当源表有"属地城市""去程车接时间""去程（地点-地点）""返程车接时间""返程（地点-地点）"等列时，表示这是属地接送场景。

> 属地接送的特点是：用车从乘客家庭地址出发送站/接站，不是从酒店出发。每人地址不同，不能拼车。

识别条件：

• 源表有"属地城市"列（非空=属地接送）
• 源表有"去程车接时间"和"返程车接时间"列
• 源表有"去程（地点-地点）"和"返程（地点-地点）"列

属地接送字段映射（覆盖默认映射）：

属地序号规则（与默认不同！）：

> ⚠️ 2026-05-28 教训（B7451023）：吴芳和刘瑭谐乐返程同G223、同时间19:02，但因目的地地址不同（梓园路86号 vs 金泽园），不能拼车同序号。属地接送的核心判断标准是地址是否相同，不是航班/时间是否相同。

> 🚨 2026-05-28 教训2（B7451023修正2）：返程I列错误填成了Z列"返程出发地"（会议城市站如"上海虹桥"）。属地返程的逻辑是：人到属地城市站 → 车在属地到达站接人 → 送回家。所以I列=AA列（返程到达地=属地到达站），不是Z列（返程出发地=会议城市出发站）。绝不能再搞反！

> 🚨 2026-05-28 教训3（C4531002/B7451023修正3）：H列"航班/车次"的"送"前缀规则：

> - 去程（送站）：从家送到机场/车站 → H列加"送"（如"送G226""送MU5336"）

> - 返程（接站）：从机场/车站接回家 → H列不加"送"（如"G223""MU5351"）

>

> 逻辑很简单：接站不需要"送"，只有送站才需要"送"。绝不能再给返程加"送"！

"去程（地点-地点）"列拆分规则：

• 格式：家庭地址-出发车站/机场（如 长沙市望城区黄金中路1号金泽园（西门）-长沙南高铁站）
• -前 → I列（出发地*，即家庭地址）
• -后 → 参考值（但J列用出发机场/火车站列的标准值）
• 无 - → 整段为家庭地址

属地接送过滤规则：

> ⚠️ 注意区分：返程车接时间=None（空，用默认值） vs "NA"（明确跳过）。

🆕 地点名称标准化规则（v3.1）

> ⚠️ 2026-05-27 新增：输出到模板 I 列（出发地）和 J 列（目的地）的地点名称必须统一格式。全国通用。

此标准化在字段映射和"上车/下车地"拆分之后执行，作为最终的 I/J 列输出清洗。无法匹配的保留源表原始内容。

第一步：从 H 列判断交通工具类型

> ⚠️ 判断顺序关键：必须先匹配火车（GDC/KTZ/纯数字），再用飞机正则。否则 [A-Z0-9]{2,3} 会把 D2828 的 "D2" 误判为航司代码。

> 中转/换乘场景：提取所有标准号码后按多数判断（如"MU5640转G2025"中飞机和火车各一，来程取最后一个(MU5640)→按飞机处理）。

第二步：根据交通工具类型标准化名称

✈️ 飞机 → 机场格式（去掉城市前缀）

全国所有机场映射见 references/location_names.md。通用提取规则：

1. 提取地名关键字（"机场"前或"T\d"前的地名部分）
2. 去掉城市前缀（上海、长沙、长春、北京等常见城市名）
3. 拼接：{地名}机场{Tn}（无航站楼省略 Tn）

🚄 高铁/动车（G/D/C）→ 站名格式

🚂 普通火车（K/T/Z/纯数字）→ 站名格式

❓ 无法判断 → 保留原文不动

机场 vs 高铁站 歧义处理

"虹桥"同时存在机场和高铁站 → 根据 H 列交通工具类型判断：

• H 列是飞机 → 输出 虹桥机场Tn
• H 列是高铁 → 输出 虹桥高铁站

> 代码实现见 references/location_names.md 中的 normalize_location_name() 函数模板。

数据行过滤规则

⚠️ 此过滤必须在 unmerge_sheet() 之后执行！ 详见"合并单元格处理"章节。

1. 空行程过滤：仅有姓名+电话但以下字段全部为空的行直接跳过，不导入：

• 航班号 / 车次号 / 车次
• 出发地 / 到达地
• 出发时间 / 到达时间

> ⚠️ v3.0 修正：航班/车次为"待定"但日期+出发地+时间均完整 → 不跳过，正常导入，H列填"待定"（回程不前缀"送"）。仅过滤"停运""取消""自驾""返程自理""自订"等明确不要的记录。

2. 🆕 "接机接站"是/否过滤（v3.4）：源表有"是否需接机"/"是否需送机"等列，含 是/否 值：

• 接机列=否 → 跳过该人的来程导入
• 送机列=否 → 跳过该人的回程导入

3. 回程"不用送"过滤：回程备注列命中任一关键词 → 跳过：

• 关键词：不用送、NA、不需要、不需送、N/A、na、无需（不区分大小写）

4. 回程"取消/自驾/自理"过滤：回程航班号/备注列含以下内容 → 跳过：

• 自驾、返程自理、自订、取消

时间格式处理

支持多种时间格式（自动识别）：

⚠️ 时间解析顺序（2026-05-26 教训）：

去秒逻辑必须在合并格式拆分之后执行，否则会把合并格式中的冒号误判为秒分隔符：

❌ 错误：先 count(':')  → "13:26-15:36" 有2个冒号 → 截断 → "13:26-15" → 后段="15"
✅ 正确：先按 '-' 拆分  → 后段="15:36" → count(':')=1 → 不去秒

正确流程：

1. 先判断分隔符（- / ~）→ 取后段（来程）或前段（回程）
2. 再检查是否需要去秒（count(':') > 1 且不含分隔符）
3. 仅对类似 20:28:00 的单独时间值执行去秒

⚠️ HH.MM 与 Excel 序列值辨析（2026-05-27 长春站教训）：

Excel 中 13.25 可能被 openpyxl 读取为 float 13.25，与真正的 Excel 时间序列值（如 0.694444）难以区分。解析优先级：

✅ 正确：
1. datetime 对象 → strftime('%H:%M')
2. 匹配 ^\d{1,2}\.\d{2}$ → HH.MM 格式（如 13.25 → 13:25）
3. 纯小数 0<val<1 → Excel 时间序列值（如 0.694444 → 16:40）
4. 否则按字符串处理

❌ 错误：对所有 float 一律按 Excel 序列值处理 → 13.25 × 24 × 60 = 318:00

> 2026-05-27：长春表 13.25（D530到达时间）被误判为 Excel 序列值，得 318 小时。

中转/换乘航班号提取

正则提取所有标准格式号码（字母+数字，如 G2025、MU5640、9C8856）：

• 来程：取最后一个（终点站的航班/车次）
• 回程：取第一个（始发站的航班/车次）
• 数字开头的航司代码（如 9C8856）也要正确提取

合并单元格处理（v3.2 Union-Find）

⚠️ 执行顺序铁律：先 unmerge → 再判断过滤 → 再提取数据。绝不能先过滤再 unmerge。

当源表存在合并单元格时，必须先展开合并单元格再处理数据。

unmerge 函数模板：

def unmerge_sheet(ws):
    """将合并单元格值展开到所有覆盖行/列"""
    data = {}
    for row in range(1, ws.max_row + 1):
        for col in range(1, ws.max_column + 1):
            data[(row, col)] = ws.cell(row=row, column=col).value
    for mc in ws.merged_cells.ranges:
        val = ws.cell(row=mc.min_row, column=mc.min_col).value
        for r in range(mc.min_row, mc.max_row + 1):
            for c in range(mc.min_col, mc.max_col + 1):
                data[(r, c)] = val
    return data

🆕 Union-Find 合并组算法（v3.2 核心）：

> ⚠️ v3.2 修正（2026-05-27 Longchamp 教训）：v3.0 的"无合并组时用航班/车次作 key"是错误的！这会导致同航班但各自独立单元格的人也被统一序号。同序号的前提仅限真正共享了合并单元格的行。

规则：

1. 合并单元格中的人必须全部导入 — 即使某行只有姓名+电话，只要与有行程数据的行共享合并单元格（日期/航班/出发地/到达地/车型/酒店等列），就要导入
2. unmerge 后继承数据 — 合并单元格展开后，被合并的行自动继承首行的行程数据
3. Union-Find 构建合并组 — 同一合并区间内的行属于同一组；不同区间通过共享行自动连通 → 每个连通分量 = 一个合并组
4. 仅合并组同序号 — 同一合并组内所有人同序号（即使航班/车次不同）
5. 独立单元格 → 独立序号 — 即使内容相同（如都是"GL8"）、航班相同，只要单元格各自独立，就各自独立序号
6. "数据行过滤规则"必须在 unmerge 之后执行 — 仅过滤 unmerge 后仍然没有行程数据的行

序号分配：仅 merge_group_id 作 key，无合并组时每人独立序号。禁止用航班/车次作为序号 key。（v3.2 修正）

Union-Find 代码模板：

def build_merge_groups(ws, sheet_name):
    parent = {}
    def find(x):
        if x not in parent: parent[x] = x
        if parent[x] != x: parent[x] = find(parent[x])
        return parent[x]
    def union(a, b):
        ra, rb = find(a), find(b)
        if ra != rb: parent[ra] = rb

    for mc in ws.merged_cells.ranges:
        rows_in = list(range(mc.min_row, mc.max_row + 1))
        if len(rows_in) > 1:
            for i in range(1, len(rows_in)):
                union(rows_in[0], rows_in[i])

    group_map = {}; gid = 0
    for row in range(1, ws.max_row + 1):
        root = find(row)
        if root not in group_map:
            gid += 1; group_map[root] = f"{sheet_name}_G{gid}"
    return {(sheet_name.strip(), row): group_map[find(row)] for row in range(1, ws.max_row + 1)}

典型场景：

> 另见 references/merge_cell_handling.md

本地行程特殊处理

当航班号字段含"本地"或"市内"字眼时：

来程本地：

回程本地：

> 本地行中出发地/时间/到达地任意一个有内容时，其余空字段统一输出"请留意检查"

数据顺序

• 来程所有行在前，回程所有行在后
• 排序：先按日期（D列），再按序号（A列） — v3.4 修正：不再保持源表原始顺序

🆕 多日期单元格处理（v3.4 新增）

源表日期列可能包含多行日期（如 05月28日\n05月29日），按方向取不同行：

> 多行中转换照此规则：来程取最后一行日期+最后一站的下车地；回程取第一行日期+第一站的出发地。

🆕 "接机接站"是/否过滤（v3.4 新增）

源表中常有"是否需接机"/"是否需送机"列，取值"是"/"否"：

> ⚠️ 此过滤在数据提取阶段执行，不同于回程备注/航班号关键词过滤。两者都要检查。

🆕 序号分配规则（v3.3 重大修正）

> ⚠️ v3.3（2026-05-27）：取消 v3.2 的"无合并组→每人独立序号"。改为看"车型"列。

拆分/均分逻辑（同航班 >4人时，v3.8）：

• 每车最多4人，均分到 ceil(n/4) 个序号，每个序号2-4人
• 拆分后子组独立判断车辆级别：≤2人=B级轿车，3-4人=商务车
• 4人→不拆(商务), 5人→3(商务)+2(B级), 6人→3+3(全商务), 7人→4+3(全商务), 8人→4+4(全商务), 9人→3+3+3(全商务)

> ⚠️ v3.8（2026-05-28）：4人不拆→1台商务；7人拆4+3→2台商务。阈值从>3改为>4，每车容量从3改为4。

>

> ⚠️ v3.7：拆分后每个子组按自身人数独立判断车辆级别。2人用B级轿车，不用商务车。

>

> ⚠️ v3.6（2026-05-28）：取消旧的"6人一车"规则，改为每车≤3人，>3人全部均分。6人也拆成2台车（3+3），避免拥挤。

>

> ⚠️ v3.5（2026-05-28）：航班号比较必须大小写不敏感（如 TV9832 = tv9832）。H 列保留原始大小写，分组时统一转大写。序号在所有数据提取后统一处理。

🆕 回程时间减时确认规则（v3.3 新增）

每次处理回程时间时，必须先向用户确认减时规则，再执行计算。

即使城市已有历史规则记录，也要向用户确认"本次使用 [城市] [机场Xh/高铁站Xh] 的减时规则，是否正确？"得到确认后再继续。

> ⚠️ 之前多次因未确认减时规则导致返工。此后每次导入都必须确认。

文件交付（必须执行）

每次处理完毕，必须同时：

1. 将结果文件保存到 C:\Users\Administrator\Desktop\{会议名}-业务导入.xlsx
2. 调用 deliver_attachments 弹窗推送文件
3. 调用 open_result_view 打开结果面板

禁止仅存入中间目录而不交付。

交付前必检清单 ⚠️

每次保存结果文件前，必须逐列验证以下 6 列全部非空：

> ⚠️ 2026-05-26 教训：大肠癌国际论坛导入时 Col18/19/27/28 全部漏填，导致返工。此后每次导入必须逐列检查，发现空值立即补填再交付。

>

> ⚠️ 2026-05-28 教训：研究者会导入 D 列用了 YYYYMMDD 格式（如 20250711），应为 YYYY/MM/DD。优先 YYYY/MM/DD，YYYY-MM-DD 也可接受。

本次使用的默认值说明

每次处理完成后，在回复中主动说明本次使用的：

• 城市及减时规则（如"虹桥-2h、浦东-2.5h"）
• 来程/回程记录条数
• 如有本地行程，说明条数和处理方式

示例场景

• "把这个嘉宾联系表导入模板"
• "@xxx行程表.xlsx 查一下，导入到模板"
• "处理这个用车表，放入业务导入模版"
• "把名单收集表的数据整理进模板表格"