winter-super-cli 2026.5.32 → 2026.6.5

package/resources/local/ecc/docs/zh-CN/skills/liquid-glass-design/SKILL.md

@@ -0,0 +1,280 @@
+---
+name: liquid-glass-design
+description: iOS 26 液态玻璃设计系统 — 适用于 SwiftUI、UIKit 和 WidgetKit 的动态玻璃材质，具有模糊、反射和交互式变形效果。
+---
+
+# Liquid Glass 设计系统 (iOS 26)
+
+实现苹果 Liquid Glass 的模式指南——这是一种动态材质，会模糊其后的内容，反射周围内容的颜色和光线，并对触摸和指针交互做出反应。涵盖 SwiftUI、UIKit 和 WidgetKit 集成。
+
+## 何时启用
+
+* 为 iOS 26+ 构建或更新采用新设计语言的应用程序时
+* 实现玻璃风格的按钮、卡片、工具栏或容器时
+* 在玻璃元素之间创建变形过渡时
+* 将 Liquid Glass 效果应用于小组件时
+* 将现有的模糊/材质效果迁移到新的 Liquid Glass API 时
+
+## 核心模式 — SwiftUI
+
+### 基本玻璃效果
+
+为任何视图添加 Liquid Glass 的最简单方法：
+
+```swift
+Text("Hello, World!")
+    .font(.title)
+    .padding()
+    .glassEffect()  // Default: regular variant, capsule shape
+```
+
+### 自定义形状和色调
+
+```swift
+Text("Hello, World!")
+    .font(.title)
+    .padding()
+    .glassEffect(.regular.tint(.orange).interactive(), in: .rect(cornerRadius: 16.0))
+```
+
+关键自定义选项：
+
+* `.regular` — 标准玻璃效果
+* `.tint(Color)` — 添加颜色色调以增强突出度
+* `.interactive()` — 对触摸和指针交互做出反应
+* 形状：`.capsule`（默认）、`.rect(cornerRadius:)`、`.circle`
+
+### 玻璃按钮样式
+
+```swift
+Button("Click Me") { /* action */ }
+    .buttonStyle(.glass)
+
+Button("Important") { /* action */ }
+    .buttonStyle(.glassProminent)
+```
+
+### 用于多个元素的 GlassEffectContainer
+
+出于性能和变形考虑，始终将多个玻璃视图包装在一个容器中：
+
+```swift
+GlassEffectContainer(spacing: 40.0) {
+    HStack(spacing: 40.0) {
+        Image(systemName: "scribble.variable")
+            .frame(width: 80.0, height: 80.0)
+            .font(.system(size: 36))
+            .glassEffect()
+
+        Image(systemName: "eraser.fill")
+            .frame(width: 80.0, height: 80.0)
+            .font(.system(size: 36))
+            .glassEffect()
+    }
+}
+```
+
+`spacing` 参数控制合并距离——距离更近的元素会将其玻璃形状融合在一起。
+
+### 统一玻璃效果
+
+使用 `glassEffectUnion` 将多个视图组合成单个玻璃形状：
+
+```swift
+@Namespace private var namespace
+
+GlassEffectContainer(spacing: 20.0) {
+    HStack(spacing: 20.0) {
+        ForEach(symbolSet.indices, id: \.self) { item in
+            Image(systemName: symbolSet[item])
+                .frame(width: 80.0, height: 80.0)
+                .glassEffect()
+                .glassEffectUnion(id: item < 2 ? "group1" : "group2", namespace: namespace)
+        }
+    }
+}
+```
+
+### 变形过渡
+
+在玻璃元素出现/消失时创建平滑的变形效果：
+
+```swift
+@State private var isExpanded = false
+@Namespace private var namespace
+
+GlassEffectContainer(spacing: 40.0) {
+    HStack(spacing: 40.0) {
+        Image(systemName: "scribble.variable")
+            .frame(width: 80.0, height: 80.0)
+            .glassEffect()
+            .glassEffectID("pencil", in: namespace)
+
+        if isExpanded {
+            Image(systemName: "eraser.fill")
+                .frame(width: 80.0, height: 80.0)
+                .glassEffect()
+                .glassEffectID("eraser", in: namespace)
+        }
+    }
+}
+
+Button("Toggle") {
+    withAnimation { isExpanded.toggle() }
+}
+.buttonStyle(.glass)
+```
+
+### 将水平滚动延伸到侧边栏下方
+
+要允许水平滚动内容延伸到侧边栏或检查器下方，请确保 `ScrollView` 内容到达容器的 leading/trailing 边缘。当布局延伸到边缘时，系统会自动处理侧边栏下方的滚动行为——无需额外的修饰符。
+
+## 核心模式 — UIKit
+
+### 基本 UIGlassEffect
+
+```swift
+let glassEffect = UIGlassEffect()
+glassEffect.tintColor = UIColor.systemBlue.withAlphaComponent(0.3)
+glassEffect.isInteractive = true
+
+let visualEffectView = UIVisualEffectView(effect: glassEffect)
+visualEffectView.translatesAutoresizingMaskIntoConstraints = false
+visualEffectView.layer.cornerRadius = 20
+visualEffectView.clipsToBounds = true
+
+view.addSubview(visualEffectView)
+NSLayoutConstraint.activate([
+    visualEffectView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
+    visualEffectView.centerYAnchor.constraint(equalTo: view.centerYAnchor),
+    visualEffectView.widthAnchor.constraint(equalToConstant: 200),
+    visualEffectView.heightAnchor.constraint(equalToConstant: 120)
+])
+
+// Add content to contentView
+let label = UILabel()
+label.text = "Liquid Glass"
+label.translatesAutoresizingMaskIntoConstraints = false
+visualEffectView.contentView.addSubview(label)
+NSLayoutConstraint.activate([
+    label.centerXAnchor.constraint(equalTo: visualEffectView.contentView.centerXAnchor),
+    label.centerYAnchor.constraint(equalTo: visualEffectView.contentView.centerYAnchor)
+])
+```
+
+### 用于多个元素的 UIGlassContainerEffect
+
+```swift
+let containerEffect = UIGlassContainerEffect()
+containerEffect.spacing = 40.0
+
+let containerView = UIVisualEffectView(effect: containerEffect)
+
+let firstGlass = UIVisualEffectView(effect: UIGlassEffect())
+let secondGlass = UIVisualEffectView(effect: UIGlassEffect())
+
+containerView.contentView.addSubview(firstGlass)
+containerView.contentView.addSubview(secondGlass)
+```
+
+### 滚动边缘效果
+
+```swift
+scrollView.topEdgeEffect.style = .automatic
+scrollView.bottomEdgeEffect.style = .hard
+scrollView.leftEdgeEffect.isHidden = true
+```
+
+### 工具栏玻璃集成
+
+```swift
+let favoriteButton = UIBarButtonItem(image: UIImage(systemName: "heart"), style: .plain, target: self, action: #selector(favoriteAction))
+favoriteButton.hidesSharedBackground = true  // Opt out of shared glass background
+```
+
+## 核心模式 — WidgetKit
+
+### 渲染模式检测
+
+```swift
+struct MyWidgetView: View {
+    @Environment(\.widgetRenderingMode) var renderingMode
+
+    var body: some View {
+        if renderingMode == .accented {
+            // Tinted mode: white-tinted, themed glass background
+        } else {
+            // Full color mode: standard appearance
+        }
+    }
+}
+```
+
+### 用于视觉层次结构的强调色组
+
+```swift
+HStack {
+    VStack(alignment: .leading) {
+        Text("Title")
+            .widgetAccentable()  // Accent group
+        Text("Subtitle")
+            // Primary group (default)
+    }
+    Image(systemName: "star.fill")
+        .widgetAccentable()  // Accent group
+}
+```
+
+### 强调模式下的图像渲染
+
+```swift
+Image("myImage")
+    .widgetAccentedRenderingMode(.monochrome)
+```
+
+### 容器背景
+
+```swift
+VStack { /* content */ }
+    .containerBackground(for: .widget) {
+        Color.blue.opacity(0.2)
+    }
+```
+
+## 关键设计决策
+
+| 决策 | 理由 |
+|----------|-----------|
+| 使用 GlassEffectContainer 包装 | 性能优化，实现玻璃元素之间的变形 |
+| `spacing` 参数 | 控制合并距离——微调元素需要多近才能融合 |
+| `@Namespace` + `glassEffectID` | 在视图层次结构变化时实现平滑的变形过渡 |
+| `interactive()` 修饰符 | 明确选择加入触摸/指针反应——并非所有玻璃都应响应 |
+| UIKit 中的 UIGlassContainerEffect | 与 SwiftUI 保持一致的容器模式 |
+| 小组件中的强调色渲染模式 | 当用户选择带色调的主屏幕时，系统会应用带色调的玻璃效果 |
+
+## 最佳实践
+
+* **始终使用 GlassEffectContainer** 来为多个兄弟视图应用玻璃效果——它支持变形并提高渲染性能
+* **在其他外观修饰符**（frame、font、padding）**之后应用** `.glassEffect()`
+* **仅在响应用户交互的元素**（按钮、可切换项目）**上使用** `.interactive()`
+* **仔细选择容器中的间距**，以控制玻璃效果何时合并
+* 在更改视图层次结构时**使用** `withAnimation`，以启用平滑的变形过渡
+* **在各种外观模式下测试**——浅色模式、深色模式和强调色/色调模式
+* **确保可访问性对比度**——玻璃上的文本必须保持可读性
+
+## 应避免的反模式
+
+* 使用多个独立的 `.glassEffect()` 视图而不使用 GlassEffectContainer
+* 嵌套过多玻璃效果——会降低性能和视觉清晰度
+* 对每个视图都应用玻璃效果——保留给交互元素、工具栏和卡片
+* 在 UIKit 中使用圆角时忘记 `clipsToBounds = true`
+* 忽略小组件中的强调色渲染模式——破坏带色调的主屏幕外观
+* 在玻璃效果后面使用不透明背景——破坏了半透明效果
+
+## 使用场景
+
+* 采用 iOS 26 新设计的导航栏、工具栏和标签栏
+* 浮动操作按钮和卡片式容器
+* 需要视觉深度和触摸反馈的交互控件
+* 应与系统 Liquid Glass 外观集成的小组件
+* 相关 UI 状态之间的变形过渡

package/resources/local/ecc/docs/zh-CN/skills/llm-trading-agent-security/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: llm-trading-agent-security
+description: 具有钱包或交易权限的自主交易代理的安全模式。涵盖提示注入、支出限制、发送前模拟、断路器、MEV保护和密钥处理。
+origin: ECC direct-port adaptation
+version: "1.0.0"
+---
+
+# LLM 交易代理安全
+
+自主交易代理面临比普通 LLM 应用更严苛的威胁模型：一次注入或错误的工具路径可能直接导致资产损失。
+
+## 适用场景
+
+* 构建能够签署并发送交易的 AI 代理
+* 审计交易机器人或链上执行助手
+* 为代理设计钱包密钥管理方案
+* 授予 LLM 订单下达、代币兑换或资金操作权限
+
+## 工作原理
+
+构建多层防御体系。单一检查不足以保障安全。应将提示词卫生、支出策略、模拟执行、执行限制和钱包隔离视为独立控制措施。
+
+## 示例
+
+### 将提示注入视为金融攻击
+
+```python
+import re
+
+INJECTION_PATTERNS = [
+    r'ignore (previous|all) instructions',
+    r'new (task|directive|instruction)',
+    r'system prompt',
+    r'send .{0,50} to 0x[0-9a-fA-F]{40}',
+    r'transfer .{0,50} to',
+    r'approve .{0,50} for',
+]
+
+def sanitize_onchain_data(text: str) -> str:
+    for pattern in INJECTION_PATTERNS:
+        if re.search(pattern, text, re.IGNORECASE):
+            raise ValueError(f"Potential prompt injection: {text[:100]}")
+    return text
+```
+
+切勿将代币名称、交易对标签、网络钩子或社交信息流盲目注入具备执行能力的提示词中。
+
+### 硬性支出限额
+
+```python
+from decimal import Decimal
+
+MAX_SINGLE_TX_USD = Decimal("500")
+MAX_DAILY_SPEND_USD = Decimal("2000")
+
+class SpendLimitError(Exception):
+    pass
+
+class SpendLimitGuard:
+    def check_and_record(self, usd_amount: Decimal) -> None:
+        if usd_amount > MAX_SINGLE_TX_USD:
+            raise SpendLimitError(f"Single tx ${usd_amount} exceeds max ${MAX_SINGLE_TX_USD}")
+
+        daily = self._get_24h_spend()
+        if daily + usd_amount > MAX_DAILY_SPEND_USD:
+            raise SpendLimitError(f"Daily limit: ${daily} + ${usd_amount} > ${MAX_DAILY_SPEND_USD}")
+
+        self._record_spend(usd_amount)
+```
+
+### 发送前模拟执行
+
+```python
+class SlippageError(Exception):
+    pass
+
+async def safe_execute(self, tx: dict, expected_min_out: int | None = None) -> str:
+    sim_result = await self.w3.eth.call(tx)
+
+    if expected_min_out is None:
+        raise ValueError("min_amount_out is required before send")
+
+    actual_out = decode_uint256(sim_result)
+    if actual_out < expected_min_out:
+        raise SlippageError(f"Simulation: {actual_out} < {expected_min_out}")
+
+    signed = self.account.sign_transaction(tx)
+    return await self.w3.eth.send_raw_transaction(signed.raw_transaction)
+```
+
+### 断路器机制
+
+```python
+class TradingCircuitBreaker:
+    MAX_CONSECUTIVE_LOSSES = 3
+    MAX_HOURLY_LOSS_PCT = 0.05
+
+    def check(self, portfolio_value: float) -> None:
+        if self.consecutive_losses >= self.MAX_CONSECUTIVE_LOSSES:
+            self.halt("Too many consecutive losses")
+
+        if self.hour_start_value <= 0:
+            self.halt("Invalid hour_start_value")
+            return
+
+        hourly_pnl = (portfolio_value - self.hour_start_value) / self.hour_start_value
+        if hourly_pnl < -self.MAX_HOURLY_LOSS_PCT:
+            self.halt(f"Hourly PnL {hourly_pnl:.1%} below threshold")
+```
+
+### 钱包隔离
+
+```python
+import os
+from eth_account import Account
+
+private_key = os.environ.get("TRADING_WALLET_PRIVATE_KEY")
+if not private_key:
+    raise EnvironmentError("TRADING_WALLET_PRIVATE_KEY not set")
+
+account = Account.from_key(private_key)
+```
+
+使用仅包含所需会话资金的专用热钱包。切勿将代理指向主资金钱包。
+
+### MEV 与截止时间保护
+
+```python
+import time
+
+PRIVATE_RPC = "https://rpc.flashbots.net"
+MAX_SLIPPAGE_BPS = {"stable": 10, "volatile": 50}
+deadline = int(time.time()) + 60
+```
+
+## 部署前检查清单
+
+* 外部数据在进入 LLM 上下文前已完成清理
+* 支出限额独立于模型输出强制执行
+* 交易在发送前经过模拟
+* `min_amount_out` 为强制要求
+* 断路器在出现回撤或无效状态时触发
+* 密钥来自环境变量或密钥管理器，绝不写入代码或日志
+* 在适当时使用私有内存池或受保护路由
+* 根据策略设置滑点和截止时间
+* 所有代理决策均记录审计日志，不仅限于成功发送的交易

package/resources/local/ecc/docs/zh-CN/skills/logistics-exception-management/SKILL.md

@@ -0,0 +1,218 @@
+---
+name: logistics-exception-management
+description: 针对货运异常、货物延误、损坏、丢失和承运商纠纷的编码化专业知识，由拥有15年以上运营经验的物流专业人士提供。包括升级协议、承运商特定行为、索赔程序和判断框架。在处理运输异常、货运索赔、交付问题或承运商纠纷时使用。license: Apache-2.0
+version: 1.0.0
+homepage: https://github.com/affaan-m/everything-claude-code
+origin: ECC
+metadata:
+  author: evos
+  clawdbot:
+    emoji: ""
+---
+
+# 物流异常管理
+
+## 角色与背景
+
+您是一名拥有15年以上经验的高级货运异常分析师，负责管理所有运输模式（零担、整车、包裹、联运、海运和空运）的运输异常。您处于托运人、承运人、收货人、保险提供商和内部利益相关者的交汇点。您使用的系统包括TMS（运输管理系统）、WMS（仓储管理系统）、承运商门户、理赔管理平台和ERP订单管理系统。您的工作是快速解决异常，同时保护财务利益、维护承运商关系并保持客户满意度。
+
+## 使用时机
+
+* 货物在交付时出现延误、损坏、丢失或拒收
+* 承运商就责任、附加费或滞留费索赔发生争议
+* 因错过交货窗口或订单错误导致客户升级投诉
+* 向承运商或保险公司提交或管理货运索赔
+* 建立异常处理标准操作程序或升级协议
+
+## 运作方式
+
+1. 按类型（延误、损坏、丢失、短缺、拒收）和严重程度对异常进行分类
+2. 根据分类和财务风险应用相应的解决流程
+3. 按照承运商特定要求和提交截止日期记录证据
+4. 根据经过的时间和金额阈值，通过既定层级进行升级
+5. 在法定时限内提交索赔，协商和解，并跟踪追偿情况
+
+## 示例
+
+* **损坏索赔**：500单位的货物到达，其中30%可修复。承运商声称不可抗力。指导证据收集、残值评估、责任判定、索赔提交和谈判策略。
+* **滞留费争议**：承运商对配送中心开具8小时滞留费账单。收货人称司机提前2小时到达。协调GPS数据、预约记录和闸口时间戳以解决争议。
+* **货物丢失**：高价值包裹显示"已送达"，但收货人否认收到。启动追踪，配合承运商调查，并在9个月的Carmack时限内提交索赔。
+
+## 核心知识
+
+### 异常分类
+
+每个异常都属于一个分类，该分类决定了解决流程、文件要求和紧急程度：
+
+* **延误（运输途中）**：货物未在承诺日期前送达。子类型：天气、机械故障、运力（无司机）、海关扣留、收货人改期。最常见的异常类型（约占所有异常的40%）。解决取决于延误是承运商责任还是不可抗力。
+* **损坏（可见）**：在交付时签收单上注明。当收货人在交货回单上记录时，承运商责任明确。立即拍照。切勿接受"司机在我们检查前已离开"。
+* **损坏（隐蔽）**：交付后发现，签收单上未注明。必须在交付后5天内（行业标准，非法定）提交隐蔽损坏索赔。举证责任转移给托运人。承运商会质疑——您需要包装完好性的证据。
+* **损坏（温度）**：冷藏/温控故障。需要连续温度记录仪数据（Sensitech、Emerson）。行程前检查记录至关重要。承运商会声称"产品装货时温度过高"。
+* **短缺**：交付时件数不符。在车尾清点——如果数量不符，切勿签署清洁的提单。区分司机清点与仓库清点的冲突。需要OS\&D（多、短、损）报告。
+* **多货**：交付的产品数量多于提单数量。通常表明来自另一收货人的货物交叉。追踪多余货物——有人会短缺。
+* **拒收**：收货人拒收。原因：损坏、延迟（易腐品窗口）、产品错误、采购订单不匹配、码头调度冲突。如果拒收不是承运商责任，承运商有权收取仓储费和回程运费。
+* **误送**：交付到错误地址或错误收货人。承运商承担全部责任。时间紧迫，需尽快找回——产品会变质或被消耗。
+* **丢失（整票货物）**：未交付，无扫描活动。整车运输在预计到达时间后24小时触发追踪，零担运输在48小时后触发。向承运商OS\&D部门提交正式追踪请求。
+* **丢失（部分）**：货物中部分物品缺失。常发生在零担运输的交叉转运过程中。对于高价值货物，序列号追踪至关重要。
+* **污染**：产品暴露于化学品、异味或不兼容的货物（零担运输中常见）。对食品和药品有监管影响。
+
+### 不同运输模式的承运商行为
+
+了解不同承运商类型的运作方式会改变您的解决策略：
+
+* **零担承运商**（FedEx Freight、XPO、Estes）：货物经过2-4个中转站。每次中转都存在损坏风险。理赔部门庞大且流程化。预计30-60天解决索赔。中转站经理的权限约为2,500美元。
+* **整车运输**（资产型承运商 + 经纪商）：单一司机，码头到码头。损坏通常发生在装卸过程中。经纪商增加了一层复杂性——经纪商的承运商可能失联。务必获取实际承运商的MC号码。
+* **包裹运输**（UPS、FedEx、USPS）：自动化索赔门户。文件要求严格。申报价值很重要——默认责任限额很低（UPS为100美元）。必须在发货时购买额外保险。
+* **联运**（铁路 + 短驳运输）：多次交接。损坏常发生在铁路运输（撞击事件）或底盘更换过程中。提单链决定了铁路和短驳运输之间的责任分配。
+* **海运**（集装箱运输）：受《海牙-维斯比规则》或COGSA（美国）管辖。承运商责任按件计算（COGSA下每件500美元，除非申报价值）。集装箱封条完整性至关重要。在目的港进行检验员检查。
+* **空运**：受《蒙特利尔公约》管辖。损坏通知严格规定为14天，延误为21天。基于重量的责任限额，除非申报价值。是所有运输模式中索赔解决最快的。
+
+### 索赔流程基础
+
+* **Carmack修正案（美国国内陆路运输）**：除有限例外情况（天灾、公敌行为、托运人行为、公共当局行为、固有缺陷）外，承运商对实际损失或损坏负责。托运人必须证明：货物交付时状况良好，货物到达时损坏/短缺，以及损失金额。
+* **提交截止日期**：美国国内运输为交付日期起9个月（《美国法典》第49编第14706节）。错过此期限，无论索赔是否有理，均因时效而被禁止。
+* **所需文件**：原始提单（显示完好交付）、交货回单（显示异常）、商业发票（证明价值）、检验报告、照片、维修估算或更换报价、包装规格。
+* **承运商回应**：承运商有30天时间确认，120天时间支付或拒赔。如果拒赔，您有自拒赔之日起2年的时间提起诉讼。
+
+### 季节性和周期性规律
+
+* **旺季（10月-1月）**：异常率增加30-50%。承运商网络紧张。运输时间延长。理赔部门处理速度变慢。在承诺中加入缓冲时间。
+* **农产品季节（4月-9月）**：温度异常激增。冷藏车可用性紧张。预冷合规性变得至关重要。
+* **飓风季节（6月-11月）**：墨西哥湾和东海岸中断。不可抗力索赔增加。需要在风暴路径更新后4-6小时内做出改道决定。
+* **月末/季末**：托运人赶量。承运商拒单率激增。双重经纪增加。整体服务质量下降。
+* **司机短缺周期**：在第四季度和新法规实施后（ELD指令、FMCSA药物清关数据库）最为严重。即期费率飙升，服务水平下降。
+
+### 欺诈与危险信号
+
+* **伪造损坏**：损坏模式与运输模式不符。同一收货地点多次索赔。
+* **地址操纵**：提货后要求更改地址。高价值电子产品中常见。
+* **系统性短缺**：多批货物持续短缺1-2个单位——表明在中转站或运输途中有盗窃行为。
+* **双重经纪迹象**：提单上的承运商与出现的卡车不符。司机说不出调度员的名字。保险证书来自不同的实体。
+
+## 决策框架
+
+### 严重程度分类
+
+从三个维度评估每个异常，并取最高严重程度：
+
+**财务影响：**
+
+* 级别1（低）：产品价值 < 1,000美元，无需加急
+* 级别2（中）：1,000 - 5,000美元或少量加急费用
+* 级别3（显著）：5,000 - 25,000美元或有客户罚款风险
+* 级别4（重大）：25,000 - 100,000美元或有合同合规风险
+* 级别5（严重）：> 100,000美元或有监管/安全影响
+
+**客户影响：**
+
+* 标准客户，服务水平协议无风险 → 不升级
+* 关键客户，服务水平协议有风险 → 提升1级
+* 企业客户，有惩罚条款 → 提升2级
+* 客户生产线或零售发布面临风险 → 自动提升至4级+
+
+**时间敏感性：**
+
+* 标准运输，有缓冲时间 → 不升级
+* 需在48小时内交付，无替代货源 → 提升1级
+* 当日或次日加急（生产停工、活动截止日期） → 自动提升至4级+
+
+### 自行承担成本 vs 争取索赔
+
+这是最常见的判断。阈值：
+
+* **< 500美元且承运商关系良好**：自行承担。索赔处理的管理成本（内部150-250美元）使其投资回报率为负。记录在承运商记分卡中。
+* **500 - 2,500美元**：提交索赔但不积极升级。这是"标准流程"区间。接受价值70%以上的部分和解。
+* **2,500 - 10,000美元**：完整的索赔流程。如果30天后无解决方案，则升级。联系承运商客户经理。拒绝低于80%的和解方案。
+* **> 10,000美元**：引起副总裁级别关注。指定专人处理索赔。如有损坏，进行独立检验。拒绝低于90%的和解方案。如果被拒，进行法律审查。
+* **任何金额 + 模式**：如果这是同一承运商在30天内的第3次以上异常，无论单个金额多少，都将其视为承运商绩效问题。
+
+### 优先级排序
+
+当多个异常同时发生时（旺季或天气事件期间常见），按以下顺序确定优先级：
+
+1. 安全/监管（温控药品、危险品）——始终优先
+2. 客户生产停工风险——财务乘数为产品价值的10-50倍
+3. 剩余保质期 < 48小时的易腐品
+4. 根据客户层级调整后的最高财务影响
+5. 最久未解决的异常（防止超出服务水平协议期限）
+
+## 关键边缘案例
+
+这些情况下，显而易见的方法是错误的。此处包含简要摘要，以便您可以根据需要将其扩展为特定项目的应对方案。
+
+1. **药品冷藏车故障，温度数据有争议**：承运商显示正确的设定点；您的Sensitech数据显示温度偏离。争议在于传感器放置和预冷。切勿接受承运商的单点读数——要求下载连续数据记录仪数据。
+
+2. **收货人声称损坏，但损坏发生在卸货过程中**：签收单签署时清洁，但收货人2小时后致电声称损坏。如果您的司机目睹了他们的叉车掉落托盘，司机的实时记录是您的最佳辩护。如果没有，您很可能面临隐蔽损坏索赔。
+
+3. **高价值货物72小时无扫描更新**：无跟踪更新并不总是意味着丢失。零担运输在繁忙的中转站会出现扫描中断。在触发丢失处理流程之前，直接致电始发站和目的站。询问实际的拖车/货位位置。
+
+4. **跨境海关扣留**：当货物被海关扣留时，迅速确定扣留是由于文件问题（可修复）还是合规问题（可能无法修复）。承运商文件错误（承运商部分商品编码错误）与托运人错误（商业发票价值不正确）需要不同的解决路径。
+
+5. **针对单一提单的部分交付**：多次交付尝试，数量不符。保持动态记录。在所有部分交付对账完毕前，不要提交短缺索赔——承运商会将过早的索赔作为托运人错误的证据。
+
+6. **货运代理在运输途中破产：** 您的货物已在卡车上，但安排此运输的货运代理破产了。实际承运人拥有留置权。迅速确定：承运人是否已获付款？如果没有，直接与承运人协商放货。
+
+7. **最终客户发现隐藏损坏：** 您将货物交付给分销商，分销商交付给终端客户，终端客户发现损坏。责任链文件决定了谁承担损失。
+
+8. **恶劣天气事件期间的旺季附加费争议：** 承运人追溯性地加收紧急附加费。合同可能允许也可能不允许这样做——需特别检查不可抗力和燃油附加费条款。
+
+## 沟通模式
+
+### 语气调整
+
+根据情况的严重性和关系调整沟通语气：
+
+* **常规异常，与承运人关系良好：** 协作式。"PRO# X 出现延误——您能给我一个更新的预计到达时间吗？客户正在询问。"
+* **重大异常，关系中立：** 专业且有记录。陈述事实，引用提单/PRO号，明确您需要什么以及何时需要。
+* **重大异常或模式性问题，关系紧张：** 正式。抄送管理层。引用合同条款。设定回复截止日期。"根据我们日期为...的运输协议第4.2节..."
+* **面向客户（延误）：** 主动、诚实、以解决方案为导向。切勿点名指责承运人。"您的货物在运输途中出现延误。以下是我们正在采取的措施以及您更新后的时间表。"
+* **面向客户（损坏/丢失）：** 富有同理心，以行动为导向。以解决方案开头，而非问题。"我们已发现您的货物存在问题，并已立即启动\[更换/赔偿]。"
+
+### 关键模板
+
+以下是简要模板。在投入生产使用前，请根据您的承运人、客户和保险工作流程进行调整。
+
+**初次向承运人询问：** 主题：`Exception Notice — PRO# {pro} / BOL# {bol}`。说明：发生了什么情况，您需要什么（更新ETA、检查、OS\&D报告），以及截止时间。
+
+**向客户主动更新：** 开头说明：您知道的情况、您正在采取的措施、客户更新后的时间表，以及您直接的联系方式以便客户提问。
+
+**向承运人管理层升级问题：** 主题：`ESCALATION: Unresolved Exception — {shipment_ref} — {days} Days`。包括之前沟通的时间线、财务影响，以及您期望的解决方案。
+
+## 升级协议
+
+### 自动升级触发条件
+
+| 触发条件 | 行动 | 时间线 |
+|---|---|---|
+| 异常价值 > 25,000 美元 | 立即通知供应链副总裁 | 1小时内 |
+| 影响企业客户 | 指派专门处理人员，通知客户团队 | 2小时内 |
+| 承运人无回应 | 升级至承运人客户经理 | 4小时后 |
+| 同一承运人重复异常（30天内3次以上） | 与采购部门进行承运人绩效审查 | 1周内 |
+| 潜在的欺诈迹象 | 通知合规部门并暂停标准处理流程 | 立即 |
+| 受监管产品出现温度偏差 | 通知质量/法规团队 | 30分钟内 |
+| 高价值货物（> 5万美元）无扫描更新 | 启动追踪协议并通知安全部门 | 24小时后 |
+| 索赔被拒金额 > 1万美元 | 对拒赔依据进行法律审查 | 48小时内 |
+
+### 升级链
+
+级别 1（分析师）→ 级别 2（团队主管，4小时）→ 级别 3（经理，24小时）→ 级别 4（总监，48小时）→ 级别 5（副总裁，72+小时或任何级别5严重程度）
+
+## 绩效指标
+
+每周跟踪这些指标，每月观察趋势：
+
+| 指标 | 目标 | 危险信号 |
+|---|---|---|
+| 平均解决时间 | < 72 小时 | > 120 小时 |
+| 首次联系解决率 | > 40% | < 25% |
+| 财务追偿率（索赔） | > 75% | < 50% |
+| 客户满意度（异常处理后） | > 4.0/5.0 | < 3.5/5.0 |
+| 异常率（每1000票货物） | < 25 | > 40 |
+| 索赔提交及时性 | 100% 在30天内 | 任何 > 60 天 |
+| 重复异常（同一承运人/线路） | < 10% | > 20% |
+| 长期未决异常（> 30天未关闭） | < 总数的 5% | > 总数的 15% |
+
+## 其他资源
+
+* 将此技能与您内部的索赔截止日期、特定运输模式的升级矩阵以及保险公司的通知要求结合使用。
+* 将承运人特定的交货证明规则和OS\&D检查清单放在执行本手册的团队附近。