外贸·询盘智能报价
根据客户询盘自动计算 FOB/CFR/CIF/EXW 报价，强制联网获取汇率等实时数据，输出含计算透明卡和免责声明的专业报价单。
工作流程
收到询盘后，严格按以下步骤执行，不可跳过任何步骤：
步骤1：解析询盘
从客户消息中提取以下字段。至少获取产品名称、数量、目的国/港口、贸易术语这4项才可继续，否则生成3-5个结构化澄清问题用客户语言回复。
| 字段 | 必填 | 示例 |
|---|---|---|
| 产品名称 | ✅ | "plastic storage boxes" |
| 规格参数 | ✅ | "40×30×20cm, PP material" |
| 数量 | ✅ | "5000 pcs" |
| 目的港/国家 | ✅ | "Hamburg, Germany" |
| 贸易术语 | 推荐 | "FOB/CIF（未指定默认FOB）" |
| 包装方式 | 推荐 | "单个OPP袋+出口纸箱" |
| 认证要求 | 推荐 | "CE, RoHS" |
| 交期 | 可选 | "30 days" |
| 付款方式 | 可选 | "T/T 30% deposit（默认T/T）" |
信息不完整时绝不报价，只输出澄清问题。
步骤1.5：收集成本数据（鲁棒解析）
用户提供成本数据有两种方式，按优先级处理：
方式一：上传产品清单文件（推荐）
用户上传 CSV/Excel 时，调用 scripts/product_parser.py 解析：
1. parse_file(file_path) 解析文件 → 智能列名匹配 + 数值清洗
2. pre_check(products) 预检识别结果 → 展示给用户确认
3. 有缺失字段 → format_missing_prompt() 精确追问只缺的字段
4. 解析完全失败 → 降级为方式二的多轮对话
方式二：多轮对话收集（兜底）
用户没上传文件时，逐项收集成本数据。每次询问 2-3 项，不要一次问太多：
- 第1轮：出厂成本（元/件）+ 期望利润率（%）
- 第2轮（缺则追问）：内陆运费（元/件）+ 港口操作费（元/件）
鲁棒性规则：
- 用户可能写「23.5元」「¥23.5」「23.5 CNY」「23.5 人民币」→ 统一提取数值
- 利润率写「15%」→ 自动转为 0.15；写「15」→ 问用户确认是 15% 还是 0.15
- 用户中途说「等等我上传文件」→ 立即切换为方式一
- 收集完成后做预检，让用户确认数据无误再继续
提示用户上传文件（发现用户还没提供成本数据时）：
📋 **请提供产品数据**
推荐上传 CSV 或 Excel 文件（列名不限，系统自动识别）：
产品编号,名称,出厂成本,利润率
SB-4003,收纳盒,23.50,15%
或逐项回复：出厂成本+利润率+运费+港口费
步骤2：获取实时数据（强制）
按 S/A/B 三级策略获取数据。S 级数据获取失败→中止报价，不允许继续。
S 级数据（每次报价强制实时）：
- 汇率 USD/CNY：3条路径依次尝试（央行→中行→Frankfurter API），全失败→中止
- 退税率：search_web 搜索国家税务总局，失败→中止
- 出口管制：search_web 检查目的国是否在制裁清单中，失败→中止
A 级数据（按时效缓存，失败有降级策略）：
运价指数（CFR/CIF 报价时获取）：
1. 调用 scripts/freight_index.py 获取搜索关键词 → search_web 搜索 SCFI/CCFI/FBX
2. 使用 estimate_sea_freight() 估算海运费 → 标注获取时间，7天有效
3. 使用 get_container_capacity() 估算整柜可装数量
4. 降级策略：搜索失败或数据过期（>7天）→ 标注"运价数据暂不可用，使用经验值 ¥{估算值}/柜，建议人工确认"；不中止报价
大宗商品价格（金属/原材料产品时获取）：
1. 调用 scripts/commodity_price.py 的 get_material_commodities() 判断产品材质关联的商品
2. search_web 搜索对应商品价格 → 使用 estimate_material_cost_impact() 估算原材料成本
3. 标注获取时间和波动风险
4. 降级策略：搜索失败 → 标注"原材料价格暂未获取，建议关注近期{LME/SHFE}价格波动"；不中止报价
B 级数据（触发式）：
- 目的国关税（贸易术语含 DDP 时触发）：调用 tariff_lookup.py → search_web → 失败则标注"未核实，建议咨询目的国清关代理"
- 合规检查（目的国为欧盟/受制裁国/产品含电池时触发）：调用 tariff_lookup.py 检查 TRADE_POLICY_ALERTS 预警 → 将结果填入 compliance_notes 字段，随报价单一起输出
步骤2.5：提取来源链接（强制）
每项外部数据获取后，从搜索结果中提取来源官网URL。写入报价单前验证：
1. 用 fetch_web 访问该 URL，确认返回 200 且内容非空
2. 若返回 404/403/空内容/登录页 → 换下一条搜索结果重试
3. 最多尝试 3 条，全部不可用 → 标注"来源链接暂不可用，请手动核实"
4. 验证通过后，以 Markdown 链接格式 [来源名称](已验证URL) 写入报价单
不可编造链接，不可使用搜索引擎聚合页链接，只使用原始数据发布方官网URL。
步骤3：计算报价（统一入口）
使用 scripts/quote_calc.py 的 generate_quotation_with_rebate() 作为唯一报价入口。此函数内置退税计算，无需单独调用 tax_rebate.py。
- 单产品 → 调用
generate_quotation_with_rebate(params) - 多产品 → 调用
generate_batch_quotation(products, base_params)（v7.2 新增），自动输出逐产品报价 + 整单汇总 + 退税总额
报价计算必须走确定性代码，不走 LLM 数学计算。
五大贸易术语公式（v7.5：含汇率转换 + DDP）：
EXW = 出厂成本 ÷ (1 - 利润率) ÷ 汇率 → USD
FOB = (出厂成本 + 内陆运费 + 港口操作费) ÷ (1 - 利润率) ÷ 汇率 → USD
CFR = [FOB + 海运费/单位] → USD
CIF = [(FOB + 海运费/单位) ÷ (1 - 1.1 × 保险费率)] → USD
DDP = CIF + 关税 + 进口增值税 + 目的港费用 → USD（v7.5：含目的国增值税）
DDP 报价时需提供 destination_vat_rate 参数（如德国 0.19、法国 0.20），未提供时自动警告。
- DDP 目的港费用通过 destination_charges_per_unit 参数传入（USD/件，如 0.15）；兼容旧名 destination_charges_per_unit_usd。注意：内部函数 estimate_ddp_cost() 使用 destination_charges_per_unit_usd 参数名，调用时需注意映射。
- 简化假设：DDP 关税计算统一使用 CIF 口径（完税价格=货值+运费+保险）。美国海关实际按 FOB 口径计征关税（不含海运保费），对美 DDP 报价会略微高估关税，方向保守（保护卖方利润），可接受。
输出三层价格区间：最低可接受价、建议报价、锚定报价。
params 必须包含的字段：
- product_name, specs, quantity, trade_term, currency
- exw_cost_per_unit, inland_freight_per_unit, port_fee_per_unit, margin_rate
- exchange_rate, exchange_rate_source, exchange_rate_source_url, exchange_rate_time
- tax_rebate_rate, tax_rebate_source, tax_rebate_source_url, tax_rebate_time
- port_of_loading, port_of_discharge
- compliance_notes（来自步骤 2 的合规检查结果）
- 可选：previous_exchange_rate（用于汇率波动检测，v7.2）
步骤4：生成报价单
按 assets/quote_template.md 模板渲染，必须包含：
- 产品明细（型号、规格、数量、单价、总价）
- 贸易术语 + 币种（默认 USD）
- 报价有效期（默认15天）
- 计算透明卡（各项成本分解+数据来源+获取时间）
- 合规提醒
步骤4.5：跨文化适配（v7.1 新增）
根据客户所在国家/文化圈，自动调整报价单语气和附带邮件风格。详见 references/cross_culture_guide.md。
执行流程：
- 推断文化圈：从询盘文本中提取署名、公司名、用语风格等线索，匹配六大文化圈之一
- 应用风格适配：按
references/cross_culture_guide.md中对应风格调整：
- 报价单顶部添加文化适配标记（如"📌 文化适配：德国/北欧风格"）
- 在报价单末尾添加谈判策略提示（该文化圈的还价空间、付款方式建议）
- 生成附带邮件草稿（符合该文化圈商务礼仪的邮件正文，用户可直接复制发送） - 无法推断时：使用"通用商务"风格，不加文化适配，不附邮件草稿
文化适配不改变报价计算结果，只影响呈现方式和沟通策略。用户提供明确文化偏好时以用户指示为准。
六大文化圈：德国/北欧 | 中东 | 日本/韩国 | 美国/加拿大 | 东南亚 | 拉美/南欧
步骤5：附加免责声明（强制）
所有输出末尾必须附加精简版免责声明，此步骤不可跳过。详见 references/disclaimer_compact.md。
输出规则（强制）
- 报价单与正文之间用
---分隔 - 所有外部数据必须标注：数据来源名称+可点击链接、获取时间、时效窗口，缺一不可；链接从搜索结果中提取官网URL，不可编造，不可使用搜索结果的聚合页链接
- 报价单末尾必须附加免责声明（精简版），不可跳过
- 跨文化适配时，报价单顶部标注文化适配标记，底部附谈判策略提示和邮件草稿
- 所有输出末尾标注："⚠️ AI生成草稿，请人工审核确认后对外使用"
数据获取规则
- 不写死任何 URL：通过 search_web 搜索关键词动态发现数据源
- 搜索关键词在
references/data_source_map.md中维护 - S 级数据至少 3 条获取路径，全部失败才中止
- fetch_web 被拦截时：换下一条搜索结果重试（最多3条）→ 仍失败则 S 级中止、A/B 级标注
边界情况
- 信息不完整：不报价，生成澄清问题
- S 级数据获取失败：中止报价，明确告知用户缺失项
- 产品无匹配：标注"未找到匹配产品，请人工确认"
- 汇率波动 >2%：报价有效期缩至7天，标注风险提示
- 涉及危险品/制裁国/欧盟新规：触发合规检查，标注风险提示
