Skill Cross Border Forex

SKILL.md

# 跨境电商汇率卫士

## 任务目标
- 本 Skill 用于:跨境电商卖家的汇率风险管控工具
- 能力包含:汇率预警监控、成本利润核算、多平台收款对比、批量换算处理
- 触发条件:跨境电商卖家、外贸企业进行汇率管理、成本核算、多平台比价需求

## 目标用户
- 跨境电商卖家（约64.3万家外贸企业，中小企业占比超80%）
- 亚马逊、eBay、速卖通等平台卖家
- 外贸企业财务人员

## 核心价值
不是简单的汇率查询，而是"跨境卖家的汇率风控工具"

---

## 支持货币
- USD（美元）- 亚马逊、eBay美国站
- EUR（欧元）- 欧洲站
- GBP（英镑）- 英国站
- JPY（日元）- 日本站
- AUD（澳元）- 澳洲站
- CAD（加元）- 加拿大站
- CNY（人民币）- 本币基准

## 数据源
- Frankfurter API（实时汇率 + 历史汇率）
- 备用：exchangerate-api.com

---

## 功能一：汇率预警器

### 功能说明
设置汇率阈值，当汇率触及阈值时主动提醒用户关注换汇时机。

### 输入参数
- `--from`: 源货币代码 (如 USD)
- `--to`: 目标货币代码 (如 CNY)
- `--threshold`: 预警阈值（如 "跌破7.1" 或 "涨破7.3"）
- `--current`: 获取当前汇率并与阈值对比

### 调用示例
```bash
python scripts/forex_guard.py --mode alert --from USD --to CNY --threshold 7.1 --direction below
python scripts/forex_guard.py --mode alert --from USD --to CNY --threshold 7.3 --direction above
```

### 输出格式
```
📊 汇率预警报告
━━━━━━━━━━━━━━━━━━━━
💱 货币对：USD/CNY
📈 当前汇率：7.08
⚠️ 预警阈值：7.10（跌破提醒）
🔔 状态：已触发！
━━━━━━━━━━━━━━━━━━━━
💡 建议：美元/人民币已跌破7.10，当前汇率7.08，建议关注换汇时机
⏰ 预警时间：2026-04-20 15:30
━━━━━━━━━━━━━━━━━━━━
⚠️ 风险提示：本工具仅供参考，不构成投资建议
```

---

## 功能二：成本核算器

### 功能说明
计算跨境电商商品的实际利润，考虑平台费率、佣金、手续费等成本。

### 输入参数
- `--mode`: cost-calculator
- `--cost-cny`: 商品成本（人民币）
- `--price-foreign`: 售价（外币）
- `--currency`: 销售平台货币（USD/EUR/GBP/JPY/AUD/CAD）
- `--platform`: 平台名称（amazon/ebay/aliexpress/wish）
- `--rate`: 汇率（可选，不提供则自动获取）

### 调用示例
```bash
python scripts/forex_guard.py --mode cost-calculator --cost-cny 100 --price-foreign 20 --currency USD --platform amazon
```

### 平台费率参考
| 平台 | 佣金率 | 提现手续费 | 参考费率 |
|-----|-------|----------|---------|
| Amazon | 8-15% | 0.5-1% | 综合约1.5-2% |
| eBay | 10% | 0.5-1% | 综合约1.5% |
| AliExpress | 5-8% | 0.5% | 综合约1% |
| Wish | 15% | 0.5% | 综合约1% |

### 输出格式
```
💰 跨境电商成本核算报告
━━━━━━━━━━━━━━━━━━━━
📦 商品信息
  • 成本（CNY）：¥100.00
  • 售价（USD）：$20.00
  • 销售平台：Amazon 美国站
  
💱 汇率信息
  • 当前汇率：7.10
  • 汇率来源：Frankfurter API
  
💵 收入计算
  • 美元收入：$20.00
  • 折合人民币：¥142.00
  • 平台佣金（约1.5%）：¥2.13
  • 提现手续费（约0.5%）：¥0.71
  • 实际到账：¥139.16
  
📊 利润分析
  • 商品成本：¥100.00
  • 实际利润：¥39.16
  • 利润率：28.15%
  
📉 汇率波动影响
  • 汇率波动±1%：±¥1.39
  • 汇率波动±2%：±¥2.78
  • 汇率波动±5%：±¥6.95
━━━━━━━━━━━━━━━━━━━━
⚠️ 风险提示：以上为估算值，实际利润以账单为准
```

---

## 功能三：多平台汇率对比

### 功能说明
对比不同收款平台的汇率差异，推荐最优收款方式。

### 输入参数
- `--mode`: platform-compare
- `--currency`: 收款货币
- `--amount`: 收款金额

### 调用示例
```bash
python scripts/forex_guard.py --mode platform-compare --currency USD --amount 10000
```

### 平台汇率参考（模拟，实际以各平台为准）
| 收款平台 | 参考汇率折扣 | 说明 |
|---------|------------|------|
| 亚马逊全球收款 | 中行现汇价-0.3% | 官方收款，安全便捷 |
| PayPal | 中行现汇价-2.5% | 广泛使用，到账快 |
| 连连支付 | 中行现汇价-0.8% | 专注跨境，专线费率 |
| PingPong | 中行现汇价-0.6% | 透明费率，次日达 |
| WorldFirst | 中行现汇价-0.3% | 蚂蚁旗下，费率优惠 |

### 输出格式
```
🏦 多平台收款汇率对比
━━━━━━━━━━━━━━━━━━━━
💱 收款货币：USD（美元）
💵 收款金额：$10,000.00
📊 基准汇率（Bank of China）：7.10

┌─────────────┬──────────┬──────────┬──────────┐
│ 收款平台     │ 汇率折扣  │ 实际汇率  │ 实际到账  │
├─────────────┼──────────┼──────────┼──────────┤
│ 亚马逊全球收款│ -0.3%    │ 7.0787   │ ¥70,787  │
│ PingPong    │ -0.6%    │ 7.0574   │ ¥70,574  │
│ 连连支付     │ -0.8%    │ 7.0432   │ ¥70,432  │
│ WorldFirst  │ -0.3%    │ 7.0787   │ ¥70,787  │
│ PayPal      │ -2.5%    │ 6.9225   │ ¥69,225  │
└─────────────┴──────────┴──────────┴──────────┘

💡 最优选择：亚马逊全球收款 / WorldFirst
   • 实际到账：¥70,787
   • 比PayPal多：¥1,562（节省2.24%）
   
💡 次优选择：PingPong
   • 实际到账：¥70,574
   • 适合中等规模卖家

━━━━━━━━━━━━━━━━━━━━
⚠️ 风险提示：汇率随时波动，实际到账以结汇时为准
```

---

## 功能四：批量换算

### 功能说明
支持多笔订单金额批量换算，汇总统计汇率波动影响。

### 输入参数
- `--mode`: batch-convert
- `--currency`: 源货币
- `--target`: 目标货币
- `--amounts`: 逗号分隔的金额列表，或指定文件路径
- `--file`: JSON格式订单文件路径

### 调用示例
```bash
python scripts/forex_guard.py --mode batch-convert --currency USD --target CNY --amounts 1500,2500,3000,2000,1000
```

### 输出格式
```
📋 批量换算报告
━━━━━━━━━━━━━━━━━━━━
💱 换算方向：USD → CNY
📅 换算日期：2026-04-20
📊 基准汇率：7.10

┌──────┬────────────┬────────────┬────────────┐
│ 序号  │ 美元金额    │ 人民币金额  │ 汇率波动±1% │
├──────┼────────────┼────────────┼────────────┤
│  1   │ $1,500.00  │ ¥10,650.00 │   ±¥106.50 │
│  2   │ $2,500.00  │ ¥17,750.00 │   ±¥177.50 │
│  3   │ $3,000.00  │ ¥21,300.00 │   ±¥213.00 │
│  4   │ $2,000.00  │ ¥14,200.00 │   ±¥142.00 │
│  5   │ $1,000.00  │ ¥7,100.00  │   ±¥71.00  │
└──────┴────────────┴────────────┴────────────┘

📊 汇总统计
  • 订单笔数：5笔
  • 美元总额：$10,000.00
  • 人民币总额：¥71,000.00
  • 汇率波动±1%影响：±¥710.00
  • 汇率波动±2%影响：±¥1,420.00

💡 建议：如汇率波动敏感，可考虑分批换汇降低风险
━━━━━━━━━━━━━━━━━━━━
```

---

## 风险提示（必须输出）
⚠️ **重要声明**：
1. 本工具仅供参考，不构成任何投资建议
2. 汇率实时波动，实际换汇以银行/平台实时汇率为准
3. 平台费率可能调整，请以各平台最新费率为准
4. 跨境电商经营需遵守当地法律法规

---

## 资源索引
- 脚本:见 [scripts/forex_guard.py](scripts/forex_guard.py)
  - 用途:汇率预警、成本核算、多平台对比、批量换算
  - 参数:--mode(工作模式), --from/--to(货币对), --threshold(阈值), --direction(方向), --cost-cny(成本), --price-foreign(售价), --currency(货币), --platform(平台), --amount(金额), --amounts(批量金额), --file(文件)

---

## 注意事项
- 货币代码必须使用标准3位字母代码(如USD、CNY、EUR)
- 汇率数据来自Frankfurter API，可能存在轻微延迟
- 平台费率为参考值，实际费率请咨询服务商
- 批量换算建议单次不超过100笔