落地空运单聊询价字段与线路选择。

必填核对后再建单；多条线路走 H5 点选；费用只展示该线路 TMS 回包，不套用整单空运费。

Co-authored-by: Cursor <cursoragent@cursor.com>

inquiry-agent/agent/policy/inquiry_copy.py

@@ -15,6 +15,7 @@ from typing import Any, Iterable
 
 from agent.schema.field_validate import (
     AIR_COLLAB_FIELDS,
+    AIR_OPTIONAL_FIELDS,
     AIR_REQUIRED_FIELDS,
     LAND_DISPLAY,
     SEA_COLLAB_FIELDS,
@@ -27,7 +28,7 @@ from agent.schema.land_options import option_prompt as _land_option_prompt
 from agent.schema.quote_adjust import total_price_label
 from agent.schema.sea_options import sea_class_prompt
 
-# 空运补问：与合同 8 项一致。报价日期默认当天，不进待补充。
+# 空运补问：必填 7 项 + 非必填。报价日期默认当天，不进待补充。
 _AIR_EXAMPLES = {
     "起运港": "南京",
     "目的港": "吉隆坡",
@@ -37,10 +38,20 @@ _AIR_EXAMPLES = {
     "体积": "2CBM",
     "包装方式": "托盘",
     "报价日期": "2026-09-15",
+    "货源地": "东莞",
+    "货好时间": "随时可提",
+    "提货地址": "东莞仓库",
+    "收货地址": "马尼拉",
+    "贸易条款": "FOB",
 }
 _AIR_CLARIFY = tuple(
     (key, label, _AIR_EXAMPLES[key]) for key, label in AIR_REQUIRED_FIELDS
 )
+_AIR_OPTIONAL_CLARIFY = tuple(
+    (key, label, _AIR_EXAMPLES.get(key, "")) for key, label in AIR_OPTIONAL_FIELDS
+)
+AIR_CONFIRM_TAIL = "请回复“确定”进行TMS查价，内容有误时，请重新发内容。"
+AIR_CONFIRM_EXPIRED = "刚才的空运核对已过期，请把空运需求再发一次，出核对卡后再回复确定。"
 
 # 海运补问：与合同 10 项一致。报价日期默认当天，不进待补充。
 _SEA_EXAMPLES = {
@@ -373,6 +384,46 @@ def _sea_known_value(facts: dict[str, str], key: str) -> str:
     return (src.get(key) or "").strip()
 
 
+def _air_field_line(key: str, value: str, *, required: bool, example: str = "") -> str:
+    """空运销售侧一行：名称（必填/非必填）：值或示例。"""
+    label = AIR_DISPLAY_LABEL(key)
+    mark = "必填" if required else "非必填"
+    text = (value or "").strip()
+    if text:
+        return f"{label}（{mark}）：{text}"
+    if example:
+        return f"{label}（{mark}）：(如：{example}）"
+    return f"{label}（{mark}）："
+
+
+def AIR_DISPLAY_LABEL(key: str) -> str:
+    """核对/补问对外名。起运港按产品口径写起运港。"""
+    if key == "起运港":
+        return "起运港"
+    return display_name(key, "AIR")
+
+
+def air_confirm_card(facts: dict[str, str] | None) -> str:
+    """
+    确定查价前的核对卡。没有工单号。
+
+    必填 7 项 + 6 个非必填都列出；空着的非必填留空行。
+    """
+    src = dict(facts or {})
+    lines = ["运输方式（必填）：空运"]
+    for key, _label in AIR_REQUIRED_FIELDS:
+        if key == "报价日期":
+            val = _air_known_value(src, key) or (src.get("报价日期") or "").strip()
+            lines.append(_air_field_line(key, val, required=True))
+            continue
+        lines.append(_air_field_line(key, _air_known_value(src, key), required=True))
+    for key, _label in AIR_OPTIONAL_FIELDS:
+        lines.append(_air_field_line(key, _air_known_value(src, key), required=False))
+    lines.append("")
+    lines.append(AIR_CONFIRM_TAIL)
+    return "\n".join(lines)
+
+
 def ask_clarify(
     *,
     facts: dict[str, str] | None = None,
@@ -383,6 +434,7 @@ def ask_clarify(
     缺项补问：先回显已识别，再列待补充并给示例。
 
     报价日期写进已识别（销售说了用原话，没说用当天），不出现在待补充。
+    空运非必填一并列出，没填进待补充，不挡查价。
     """
     src = dict(facts or {})
     skip = {"报价日期"}
@@ -398,6 +450,16 @@ def ask_clarify(
         val = known(src, key)
         if val:
             lines.append(f"{label}：{val}")
+    if not sea:
+        origin = known(src, "起运港")
+        if origin:
+            lines.append(f"起运地：{origin}")
+        for key, label, _example in _AIR_OPTIONAL_CLARIFY:
+            if key == "起运港":
+                continue
+            val = known(src, key)
+            if val:
+                lines.append(f"{label}：{val}")
     lines.append("")
     lines.append("待补充：")
     any_missing = False
@@ -411,6 +473,16 @@ def ask_clarify(
                 lines.append(sea_class_prompt())
             else:
                 lines.append(f"{label}：(如：{example}）")
+    if not sea:
+        optional_pending = [
+            (key, label, example)
+            for key, label, example in _AIR_OPTIONAL_CLARIFY
+            if not known(src, key)
+        ]
+        for key, label, example in optional_pending:
+            any_missing = True
+            shown = "起运港" if key == "起运港" else label
+            lines.append(f"{shown}（非必填）：(如：{example}）")
     if not any_missing:
         return ""
     return "\n".join(lines)
@@ -861,18 +933,24 @@ def quote_area_safe_text(
     transport_mode: str = "",
 ) -> str:
     """
-    卡片引用条：短报价原样；超长只留总价名称，避免半截费用名。
+    卡片引用条：空运有费用行就只留总价，禁止再塞费用。
 
-    完整明细由 sea_quote_detail_text 另发一条文本。空运卡仍用 quote_area_fee_text。
+    三项短费用也会被企微裁成「人工费：CNY 123...」。完整明细走文本。
+    海运/陆运仍按字数：短的原样，超长同样只留总价。
     """
-    full = quote_area_fee_text(quote, business_line=business_line, transport_mode=transport_mode)
-    if len(full) <= _QUOTE_AREA_SAFE_CHARS:
-        return full
     src = dict(quote or {})
     header_ccy = str(src.get("currency") or src.get("currencyCode") or "").strip()
     total = money_text(str(src.get("total") or "-").strip() or "-", header_ccy)
     n = len(quote_fee_lines(src))
     label = _total_label(src, business_line, transport_mode)
+    line = (business_line or "").upper()
+    mode = (transport_mode or "").strip()
+    is_air = line == "AIR" or mode == "空运"
+    if is_air and n:
+        return f"{label}：{total}\n共{n}项费用，详见上一条明细"
+    full = quote_area_fee_text(quote, business_line=business_line, transport_mode=transport_mode)
+    if len(full) <= _QUOTE_AREA_SAFE_CHARS:
+        return full
     if n:
         return f"{label}：{total}\n共{n}项费用，详见上一条明细"
     return f"{label}：{total}"
@@ -888,7 +966,7 @@ def sea_quote_detail_text(
     business_line: str = "SEA",
 ) -> str:
     """
-    海运/陆运完整价格明细文本：来源、工单号、费用行、总销售价。
+    完整价格明细文本：来源、工单号、费用行、总价。海运/陆运/空运共用。
 
     时效、报价有效期只在卡片上出现，这里不写，避免和卡重复。
     不受卡片引用条字数限制。first_or_same 只兼容调用方。
@@ -896,13 +974,15 @@ def sea_quote_detail_text(
     _ = first_or_same, history_work_order_no, status
     src = dict(quote or {})
     source = str(src.get("source_label") or "TMS标准报价").replace(" ", "")
-    return "\n".join(
-        [
-            source,
-            f"{work_order_no}价格明细",
-            quote_area_fee_text(src, business_line=business_line or "SEA"),
-        ]
-    )
+    lines = [source, f"{work_order_no}价格明细"]
+    if (business_line or "").upper() == "AIR":
+        from agent.schema.air_route_options import route_codes
+
+        route = route_codes(None, {}, src)
+        if route:
+            lines.append(route)
+    lines.append(quote_area_fee_text(src, business_line=business_line or "SEA"))
+    return "\n".join(lines)
 
 
 def collab_hint(work_order_no: str) -> str:
@@ -1007,6 +1087,11 @@ def tms_hit_card(
     src = dict(quote or {})
     source = str(src.get("source_label") or "TMS标准报价").replace(" ", "")
     lines = [source, f"{work_order_no}价格明细"]
+    from agent.schema.air_route_options import route_codes
+
+    route = route_codes(None, {}, src) or str(src.get("route_line") or "").strip()
+    if route:
+        lines.append(route)
     lines.extend(
         quote_detail_lines(
             src,
@@ -1022,6 +1107,32 @@ def tms_hit_card(
     return "\n".join(lines)
 
 
+def air_route_entry_card(*, work_order_no: str, count: int, url: str) -> dict[str, Any]:
+    """
+    多条线路入口卡：短文案跳转 H5，避免企微截断。
+    """
+    n = max(int(count or 0), 2)
+    fallback = "https://ai.ytd-scm.com/inquiry-form"
+    action_url = (url or "").strip() or fallback
+    return {
+        "msgtype": "template_card",
+        "template_card": {
+            "card_type": "text_notice",
+            "source": {"desc": "TMS线路报价", "desc_color": 0},
+            "main_title": {"title": f"{work_order_no}已查到{n}条线路"},
+            "sub_title_text": "点击查看并选择一条线路，选定后回企微看价格明细。",
+            "card_action": {"type": 1, "url": action_url},
+            "jump_list": [{"type": 1, "title": "查看并选择线路", "url": action_url}],
+        },
+    }
+
+
+def air_route_entry_text(*, work_order_no: str, count: int) -> str:
+    """入口卡失败时的文字兜底。"""
+    n = max(int(count or 0), 2)
+    return f"{work_order_no}已查到{n}条线路，请点击卡片查看并选择。"
+
+
 def tms_hit_wecom_payload(
     *,
     work_order_no: str,
@@ -1062,7 +1173,7 @@ def tms_hit_wecom_payload(
             "main_title": {"title": f"{work_order_no}价格明细"},
             "quote_area": {
                 "type": 0,
-                "quote_text": quote_area_fee_text(src, business_line="AIR"),
+                "quote_text": quote_area_safe_text(src, business_line="AIR"),
             },
             "sub_title_text": meta,
             "task_id": card_task_id("quote", work_order_no),
@@ -1675,6 +1786,13 @@ def _clip(raw: str, limit: int) -> str:
     return text if len(text) <= limit else text[: limit - 1] + "…"
 
 
+def _air_scheme_route(quote: dict[str, Any], facts: dict[str, str]) -> str:
+    """方案卡航线：空运ZUH→中转→CRK。没有三字码才退回地名。"""
+    from agent.schema.air_route_options import scheme_route_codes
+
+    return scheme_route_codes(quote, facts)
+
+
 def scheme_transport_mode(business_line: str = "", fallback: str = "空运") -> str:
     """会话业务线 → 方案卡运输方式。海运不得再写成空运。"""
     raw = (business_line or "").strip()
@@ -1736,7 +1854,7 @@ def scheme_horizontal_rows(
     pack = (src.get("包装方式") or src.get("包装类型") or "-").strip() or "-"
     return [
         {"keyname": "工单号", "value": _clip(work_order_no, 26)},
-        {"keyname": "航线", "value": _clip(f"空运 {origin}→{dest}", 26)},
+        {"keyname": "航线", "value": _clip(_air_scheme_route(q, src), 26)},
         {"keyname": "货物", "value": _clip(f"{cargo}；{pieces}；{weight}；{volume}", 26)},
         {"keyname": "包装", "value": _clip(pack, 26)},
         {"keyname": "时效", "value": _clip(tms_eta_display(q), 26)},
@@ -1798,11 +1916,8 @@ def scheme_wecom_payload(
             "main_title": {"title": f"{work_order_no}报价方案"},
             "quote_area": {
                 "type": 0,
-                "quote_text": (
-                    quote_area_safe_text(src, transport_mode=transport_mode)
-                    if (transport_mode or "").strip() in {"海运", "陆运"}
-                    else quote_area_fee_text(src, transport_mode=transport_mode)
-                ),
+                # 空运/海运/陆运引用条一律只留总价，费用在上一条明细。
+                "quote_text": quote_area_safe_text(src, transport_mode=transport_mode),
             },
             "horizontal_content_list": scheme_horizontal_rows(
                 work_order_no=work_order_no,