CRITICAL — 开始前 必须用 Read 工具读取
../fx-base/SKILL.md，其中包含 feima-lab API 认证和请求规范。fx-base 未安装？执行
npx skills install fangshan101-coder/fx-base安装到同目录下。
海外购物返利助手
3 个能力覆盖海外购物返利全流程：粘贴链接转链 → 搜商家问返利 → 查返利订单。
当前支持商家
商家名（--store 参数必须用此值） |
支持地区 | 域名匹配 | 用户可能的叫法 |
|---|---|---|---|
Adidas |
全球/中国 | *.adidas.com / *.adidas.cn / *.adidas.de / *.adidas.co.uk 等所有 adidas 官方域名 |
阿迪达斯 / 阿迪 / adidas / Adidas |
Space NK NL |
荷兰 | *.spacenk.com（通常含 /nl/ 或 /en_NL/ 路径） |
space nk / spacenk / Space NK 荷兰站 |
designwebstore DE |
德国 | designwebstore.de |
designwebstore / design web store / designwebstore 德国站 |
重要：商家清单由多麦联盟后端决定，不在上表中的商家一律不支持（包括 Amazon、Nike、iHerb、eBay、Shein 等）。用户问清单外商家时直接告知暂不支持，不要调 API 硬查。
商家名映射：用户口头叫法（如"阿迪达斯"）必须先映射到左列的精确值（
Adidas）再传给--store参数，否则 API 会返回store_not_found。
前置条件
- 环境变量
FX_AI_API_KEY：从 feima-lab 开放平台 登录获取。未设置时脚本会返回missing_api_key错误 - 数据流向：用户提供的链接和查询会被发送到
https://api-ai-brain.fenxianglife.com处理，请确保信任该服务后再使用
快速开始
# 快捷命令（推荐，Claude 默认用这组）
node {baseDir}/scripts/run.mjs convert "https://www.adidas.com/us/ultraboost-5-shoes/ID8841.html"
node {baseDir}/scripts/run.mjs store "Adidas"
node {baseDir}/scripts/run.mjs orders
# 等价的标准调用（开发者调试用）
node {baseDir}/scripts/run.mjs call link-convert --url "<URL>"
node {baseDir}/scripts/run.mjs call store-rebate --store "Space NK NL"
node {baseDir}/scripts/run.mjs call order-query --days 30
路由决策
| 用户意图 | 命令 | 渲染模板 |
|---|---|---|
| 发商品链接、要返利链接 | run.mjs convert "<URL>" |
Read {baseDir}/references/link-convert-output.md |
| 问某商家有没有返利、返利多少 | run.mjs store "<精确商家名>" |
Read {baseDir}/references/store-rebate-output.md |
| 查我的返利、我的订单 | run.mjs orders 或 run.mjs orders --days N |
Read {baseDir}/references/order-query-output.md |
链接归属判断
调用接口前，必须先用域名/商家名判断是否在服务范围，避免无效 API 调用：
| 输入类型 | 判断依据 | 动作 |
|---|---|---|
| 商品链接 | 域名匹配「支持商家表」的"域名匹配"列 | 调用 convert |
| 商品链接 | 域名不匹配表中任何商家 | 不调 API，告知"该商家暂未开通返利，目前仅支持 Adidas、Space NK NL、designwebstore DE 三家" |
| 商家名 | 对照"用户可能的叫法"列，能映射到精确商家名 | 用映射后的值调用 store |
| 商家名 | 无法映射到上表任何商家 | 不调 API，告知同上 |
| 查订单 | 直接调用，无需判断 | 调用 orders |
工作流
多接口 skill 必须渐进式输出——先告诉用户"正在查询"，不要等到 API 返回才出声：
Step 1 立即输出："正在查询 {商家名/订单/链接}..."（不等 API 返回）
↓
Step 2 判断链接/商家是否在服务范围（见"链接归属判断"）
↓ 不在 → 告知不支持并结束
↓ 在 → 继续
Step 3 调用对应接口（见"路由决策"）
↓
Step 4 拿到 JSON，Read 对应渲染模板，输出结果
↓
Step 5 用户继续追问 → 回到 Step 1
没有链接时先问用户要。
错误处理
| 现象 | 用户可见提示 | 兜底动作 |
|---|---|---|
| 用户发清单外商家的链接或名字 | "该商家暂未开通返利，目前仅支持 Adidas、Space NK NL、designwebstore DE 三家" | 不调 API，直接回复 |
store_not_found（清单内商家名拼错） |
"没找到该商家，商家名应为：Adidas / Space NK NL / designwebstore DE" | 用精确名称重试；若用户同时给了链接，改走 convert |
no_available_plan |
"该商家暂无可用返利计划" | 告知可能是临时下线，建议稍后重试 |
no_orders |
"近 {days} 天暂无返利订单" | 提示"通过返利链接购物后，订单通常需要 1-3 天才会出现" |
api_unavailable / HTTP 错误 |
"服务暂时不可用，请稍后重试" | 建议 1 分钟后重试 |
missing_api_key |
"请设置环境变量 FX_AI_API_KEY" |
给出 feima-lab 开放平台 链接 |
missing_parameter |
"请发一下商品链接 / 请告诉我要查哪个商家" | 引导用户补充参数 |
不适用场景
以下情况不要调用本 Skill：
- 清单外的任何海外商家（Amazon/Nike/iHerb/eBay/Shein 等）
- 国内电商（淘宝/京东/拼多多/抖音/唯品会/美团等）
- 快递物流查询
- 汇率换算、天气查询
兼容性
- Claude Code / Claude.ai / OpenClaw 本地节点
- Node.js 18+（内置 fetch，无额外依赖）
- 脚本路径解析基于
import.meta.url，支持 symlink 安装
环境依赖
- Node.js 18+
- 环境变量
FX_AI_API_KEY：从 feima-lab 开放平台 登录获取