fanli

> **CRITICAL** — 开始前 **必须**用 Read 工具读取 [`../fx-base/SKILL.md`](../fx-base/SKILL.md)，其中包含 fenxiang-ai API 认证和请求规范。 > > fx-base 未安装？执行 `npx skills install fangshan101-coder/fx-base` 安装到同目录下。 # 省钱购物助手 一次 `convert` 调用 → 同时拿到商品信息 + 比价 + 历史价 → 直接按模板渲染输出。 ## 前置条件 - 环境变量 `FX_AI_API_KEY`：从 [fenxiang-ai 开放平台](https://platform.fenxiang-ai.com/) 登录获取。未设置时脚本会返回 `missing_api_key` 错误 - **数据流向**：用户提供的商品链接会被发送到 `https://api-ai-brain.fenxianglife.com` 进行解析，请确保信任该服务后再使用 ## 快速开始 ```bash # 快捷命令（推荐） node {baseDir}/scripts/run.mjs convert "<链接或口令>" # 美团链接转链 node {baseDir}/scripts/run.mjs convert "https://click.meituan.com/t?t=1&c=2&p=xxx" # 等价的标准调用 node {baseDir}/scripts/run.mjs call convert --tpwd "<链接或口令>" # 查看接口帮助 node {baseDir}/scripts/run.mjs call convert --help ``` 返回 JSON 包含：商品详情 + `comparePriceData`（比价） + `historyPriceData`（历史价）。 服务端 `includeComparePrice` 和 `includeHistoryPrice` 默认 `true`，无需额外传参。 ## 路由决策 | 用户意图 | 快捷命令 | 标准调用 | 渲染模板 | |---------|---------|---------|---------| | 发链接、问值不值得买、问优惠券、没说意图 | `convert "<链接>"` | `call convert --tpwd "<链接>"` | Read `{baseDir}/references/convert-output.md` | | 明确说"比价"、"哪家便宜" | `compare-price "<链接>"` | `call compare-price --productIdentifier "<链接>"` | Read `{baseDir}/references/compare-price-output.md` | | 明确说"历史价"、"价格走势" | — | `call convert --tpwd "<链接>" --includeComparePrice false` | Read `{baseDir}/references/convert-output.md` | 所有命令前缀：`node {baseDir}/scripts/run.mjs` **默认用 `convert`**，它一次返回商品信息 + 比价 + 历史价全部数据。美团链接（`click.meituan.com`、`dpurl.cn`、`meituan.com`、`imeituan://` 等）同样走 `convert` 路径，数据结构与电商一致。`convert` 支持两个可选参数控制返回内容： - `--includeComparePrice true/false`（默认 true） - `--includeHistoryPrice true/false`（默认 true） 历史价路径走 `convert` 而非独立接口，是因为购买建议需要到手价（`finalPrice`）与历史价比较，而独立的历史价接口不返回到手价。 **输出格式**：所有接口支持 `--format json`（默认）或 `--format table`。如果下游 Agent 需要结构化数据而非 Markdown 渲染，直接用 `--format json` 跳过模板渲染。 ## 工作流 ``` 收到链接/口令 → 输出"正在查询商品信息..." → 根据上方路由表调用对应接口 → 拿到 JSON → Read 路由表中对应的渲染模板，按模板输出 ``` 没有链接时先问用户要。 ## 错误处理 接口返回错误时，告知用户具体原因并给建议，不要返回原始 JSON： | 现象 | 用户可见提示 | |------|-------------| | `missing_parameter` | 请发一下商品链接或淘口令 | | `errorMessage: "未找到相关商品"` | 没找到商品信息，请检查链接是否正确 | | `topLowestItems` 为空 | 暂无比价数据 | | `historyPriceData` 不存在 | 暂无历史价格数据 | | `missing_api_key` | 请设置环境变量 `FX_AI_API_KEY`，从 [fenxiang-ai 开放平台](https://platform.fenxiang-ai.com/) 登录获取 | | `api_unavailable` / HTTP 错误 | 服务暂时不可用，请稍后再试 | ## 不适用场景 以下情况**不要**调用本 Skill： - 快递物流查询 - 汇率换算、天气查询 - 闲鱼/二手交易（无标准价格体系） - 没有具体商品链接的购物讨论 ## 环境依赖 - Node.js 18+（内置 fetch，无需额外依赖） - 环境变量 `FX_AI_API_KEY`：从 [fenxiang-ai 开放平台](https://platform.fenxiang-ai.com/) 登录获取