@round2ai/r2-cli 1.0.7 → 1.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@round2ai/r2-cli",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "R2-CLI，向 AI 开放二手潮奢交易全链路能力",
   "main": "dist/r2-cli.js",
   "type": "module",
@@ -14,6 +14,7 @@
   },
   "keywords": [
     "round2ai",
+    "r2",
     "r2-cli",
     "cli",
     "ai",
@@ -32,7 +33,10 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "repository": "https://github.com/Round2AI/r2-cli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Round2AI/r2-cli"
+  },
   "dependencies": {
     "@inquirer/prompts": "^8.4.2",
     "chalk": "^5.3.0",

package/skills/r2-auth/SKILL.md

@@ -1,25 +1,19 @@
 ---
 name: r2-auth
-description: R2-CLI 认证登录专家。两步式扫码登录：生成二维码图片 + 轮询确认。用于登录、login、auth、扫码、二维码场景。
+description: R2-CLI 认证登录专家。两步式扫码登录和闲鱼店铺授权。用于登录、login、auth、扫码、二维码、授权、xianyu、logout、登出、状态查询场景。Agent 生成二维码后同时展示 unicodeQR 和 qrUrl 给用户。
 ---
 
 # R2-Auth Skill
 
-两步式扫码登录，专为 AI Agent 设计。第一步生成二维码，Agent 将 unicodeQR 直接输出到聊天窗口展示给用户；第二步轮询等待用户扫码确认。
-
-## 安装
-
-```bash
-npm install -g @round2ai/r2-cli@latest
-```
+两步式扫码登录 + 闲鱼店铺授权，专为 AI Agent 设计。
 
 ## 命令前缀
 
-见 **r2-cli** skill 的"命令前缀自动检测"章节。以下文档使用 `r2-cli` 作为前缀，根据检测结果替换。
+见 **r2-cli** skill 的"命令前缀自动检测"章节。
 
-## 登录流程（两步）
+## 扫码登录（两步）
 
-### 第1步：生成二维码
+### 第 1 步：生成二维码
 
 ```bash
 r2-cli auth login qr
@@ -31,14 +25,20 @@ r2-cli auth login qr
   "qrToken": "xxx",
   "expireTimeMs": 300000,
   "pollIntervalMs": 800,
-  "qrPath": "C:\\Users\\xxx\\.r2-cli\\qrcode.png",
-  "unicodeQR": "█▀▀▀▀▀█ ..."
+  "unicodeQR": "█▀▀▀▀▀█ ...",
+  "url": "https://m.puresnake.com/r2/auth/login?qrToken=xxx&from=wechat",
+  "qrUrl": "http://127.0.0.1:52173/login/"
 }
 ```
 
-**Agent 必须**：将 `unicodeQR` 字段的值直接输出到聊天窗口（作为文本回复），不要使用 Read 工具读取 PNG 图片——聊天窗口无法渲染图片，但 unicode 半块字符（█▀▄）可以正常显示。
+**Agent 必须同时展示以下两种方式**：
+
+1. 将 `unicodeQR` 直接输出到聊天窗口（unicode 半块字符 █▀▄ 可显示为 QR 码）
+2. 输出 `qrUrl` 链接供用户点击在浏览器中打开
+
+两种方式缺一不可。用户可使用**第二回合 APP / 微信 / 支付宝**扫码。
 
-### 第2步：立即轮询登录状态
+### 第 2 步：立即轮询登录状态
 
 **关键**：输出二维码后，Agent 必须立即在后台启动轮询，不要等待用户回复。
 
@@ -46,25 +46,27 @@ r2-cli auth login qr
 r2-cli auth login poll --token <qrToken> --expire <expireTimeMs> --interval <pollIntervalMs>
 ```
 
-使用 Bash 工具的 `run_in_background: true` 启动轮询，然后用 `TaskOutput` 阻塞等待结果。参数取自第1步返回的 JSON 字段。
+使用 Bash 工具的 `run_in_background: true` 启动，然后用 `TaskOutput` 阻塞等待。参数取自第 1 步返回的 JSON。
 
-成功输出：
-```json
-{
-  "success": true,
-  "userInfo": { "nickname": "...", "mobile": "..." },
-  "token": "..."
-}
-```
+成功：`{ "success": true, "userInfo": { "nickname": "...", "mobile": "..." }, "token": "..." }`
+失败：`{ "success": false, "error": "轮询超时 ..." }`
 
-失败输出：
-```json
-{
-  "success": false,
-  "error": "轮询超时 ..."
-}
+## 闲鱼店铺授权（两步）
+
+流程与登录相同。
+
+```bash
+# 第 1 步
+r2-cli auth xianyu qr
+# → { "state": "xxx", "expireTimeMs": 300000, "pollIntervalMs": 1000, "unicodeQR": "...", "qrUrl": "..." }
+
+# 第 2 步
+r2-cli auth xianyu poll --state <state> --expire <expireTimeMs> --interval <pollIntervalMs>
+# → 成功：{ "success": true, "shopId": "...", "shopName": "..." }
 ```
 
+Agent 同样必须同时展示 `unicodeQR` 和 `qrUrl`。
+
 ## 其他命令
 
 | 命令 | 说明 |
@@ -72,16 +74,7 @@ r2-cli auth login poll --token <qrToken> --expire <expireTimeMs> --interval <pol
 | `r2-cli auth status` | 查看登录状态 |
 | `r2-cli auth logout` | 退出登录 |
 
-## 人类一键登录
-
-```bash
-r2-cli auth login
-```
-
-直接在终端显示 unicode 二维码，适合人类在 CLI 中使用。
-
 ## 注意事项
 
-- Token 存储在 `~/.r2-cli/config.json`，过期会自动刷新
-- 二维码默认5分钟过期，超时需重新执行第1步
+- 二维码默认 5 分钟过期，超时需重新执行第 1 步
 - 登录成功后，后续 goods 等命令可直接使用

package/skills/r2-cli/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: r2-cli
-description: R2-CLI 二手潮奢交易工具。用于认证登录、基本操作（登录、login、auth、商品、goods）。安装后 AI Agent 可直接调用全部交易能力。
+description: R2-CLI 二手潮奢交易 CLI 工具。用于认证登录、商品上架/下架/改价、查看店铺/仓库/选品商品/上架列表。Agent 获取数据后展示给用户选择，完成 4 步上架流程。触发词：r2-cli、登录、上架、下架、改价、商品、goods、auth、shops、stocks、listing。
 ---
 
 # R2-CLI Skill
 
-R2-CLI 是二手潮奢交易命令行工具，支持商品管理（上架/下架/改价/列表）、认证登录等。
+二手潮奢交易命令行工具。
 
 ## 安装
 
@@ -21,35 +21,50 @@ npm install -g @round2ai/r2-cli@latest
 2. 存在 `dist/r2-cli.js` → `node dist/r2-cli.js`
 3. `r2-cli --version` 成功 → `r2-cli`
 
-以下文档使用 `r2-cli` 作为前缀，根据检测结果替换。
-
-> **注意**：部分平台 npm 会拦截 `--help`/`-h` 等 flag，若 `npm run dev -- --help` 显示的是 npm 帮助，改用 `npx tsx src/entrypoints/r2-cli.tsx --help`。
+> 部分平台 npm 会拦截 `--help` 等 flag，改用 `npx tsx src/entrypoints/r2-cli.tsx --help`。
 
 ## 前置条件
 
-- 必须先登录：`r2-cli auth login`（扫码登录）
-- 检查登录状态：`r2-cli auth status`
-- Token 过期会自动刷新，刷新失败才需要重新登录
-- Token 存储在 `~/.r2-cli/config.json`
+- 先登录：`r2-cli auth login`（支持第二回合 APP / 微信 / 支付宝扫码）
+- 检查状态：`r2-cli auth status`
+
+所有 `--json` 命令输出 `{ success: false, error: "..." }` 格式错误，检查 `success` 判断成败。
 
-## 认证命令 `r2-cli auth`
+## 认证命令
 
 | 命令 | 说明 |
 |------|------|
-| `r2-cli auth login` | 扫码登录（生成二维码 → 手机扫码 → 确认） |
+| `r2-cli auth login` | 扫码登录（交互式，人类用） |
+| `r2-cli auth login qr` | 生成登录二维码 JSON（Agent 第1步） |
+| `r2-cli auth login poll --token <>` | 轮询登录状态 JSON（Agent 第2步） |
+| `r2-cli auth xianyu` | 闲鱼店铺授权（交互式） |
+| `r2-cli auth xianyu qr` | 获取授权二维码 JSON（Agent 第1步） |
+| `r2-cli auth xianyu poll --state <>` | 轮询授权状态 JSON（Agent 第2步） |
+| `r2-cli auth status` | 查看登录状态 |
 | `r2-cli auth logout` | 退出登录 |
-| `r2-cli auth status` | 查看登录状态和用户信息 |
 
-## 商品管理命令 `r2-cli goods`
+> 认证登录的 Agent 两步式流程见 **r2-auth** skill。
+
+## 商品管理命令
 
 | 命令 | 说明 |
 |------|------|
-| `r2-cli goods shops` | 查看已授权店铺（`-p xianyu/douyin`） |
-| `r2-cli goods list` | 寄售商品列表（`--status wait/on/sold/down`） |
-| `r2-cli goods up` | 上架商品（交互式7步向导） |
-| `r2-cli goods down <ids...>` | 下架商品（支持批量） |
-| `r2-cli goods reup <ids...>` | 重新上架（支持批量） |
-| `r2-cli goods price <id> --price <amount>` | 修改售价 |
-
-> 商品管理的详细用法（交互式向导、AI Agent 分步上架）见 **r2-goods** skill。
-> 认证登录的 Agent 两步式流程见 **r2-auth** skill。
+| `r2-cli goods shops [--json]` | 查看所有已授权店铺 |
+| `r2-cli goods stocks [--json]` | 查看所有仓库 |
+| `r2-cli goods list --stock-id <id> [--json]` | 查看仓库中的选品商品 |
+| `r2-cli goods listing [--json]` | 查询上架列表（支持 --id/--shop-id/--status 过滤） |
+| `r2-cli goods up` | 交互式上架 |
+| `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` | Agent 直接上架（自动轮询结果） |
+| `r2-cli goods down --id <id> [--json]` | 下架商品（**必须先确认**） |
+| `r2-cli goods price --id <id> --price <amount> [--json]` | 修改上架价格（**必须先询问用户新价格**） |
+
+### Agent 上架 4 步流程
+
+**核心理念：Agent 获取数据后展示给用户选择，不要让用户自己提供 ID。**
+
+1. `r2-cli goods shops --json` → 展示店铺（shopId、shopName、platform）→ 用户选择
+2. `r2-cli goods stocks --json` → 展示仓库（stockId、stockName）→ 用户选择
+3. `r2-cli goods list --stock-id <id> --json` → 展示商品（stockGoodsId、goodsName、brand、size、salePrice）→ 用户选择
+4. `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` → 提交上架（自动轮询结果）
+
+> 完整流程和参数说明见 **r2-goods** skill。

package/skills/r2-goods/SKILL.md

@@ -1,182 +1,106 @@
 ---
 name: r2-goods
-description: R2-CLI 商品管理专家。用于商品上架、下架、改价、列表等操作，支持交互式向导和 AI Agent 分步执行（上架、下架、商品列表、改价、goods、商品、寄售）。
+description: R2-CLI 商品管理专家。用于商品上架/下架/改价、查看店铺/仓库/选品商品/上架列表。Agent 获取数据后展示给用户选择，完成 4 步上架流程。触发词：上架、下架、改价、商品列表、goods、up、down、price、shops、stocks、listing、list。
 ---
 
 # R2-Goods Skill
 
-商品管理专家，理解闲鱼/抖音商品上架全流程，能指导 AI Agent 正确调用 CLI 命令完成商品操作。
-
-## 安装
-
-```bash
-npm install -g @round2ai/r2-cli@latest
-```
+商品管理专家，指导 AI Agent 完成商品上架、下架、改价全流程。
 
 ## 命令前缀
 
-见 **r2-cli** skill 的"命令前缀自动检测"章节。以下文档使用 `r2-cli` 作为前缀，根据检测结果替换。
+见 **r2-cli** skill 的"命令前缀自动检测"章节。
 
 ## 命令概览
 
 | 命令 | 说明 |
 |------|------|
-| `r2-cli goods shops` | 查看已授权店铺（`-p xianyu/douyin`） |
-| `r2-cli goods list` | 寄售商品列表（`--status wait/on/sold/down`） |
-| `r2-cli goods up` | 交互式上架向导（7步） |
-| `r2-cli goods down <ids...>` | 下架商品（支持批量） |
-| `r2-cli goods reup <ids...>` | 重新上架（支持批量） |
-| `r2-cli goods price <id> --price <amount>` | 修改售价 |
-
-## goods list 选项
-
-- `--status <status>` — `wait`(待上架)、`on`(已上架)、`sold`(已售)、`down`(已下架)
-- `--keyword <keyword>` — 搜索关键词
-- `--page <n>` / `--size <n>` — 分页（size 上限 100）
-
-## 交互式上架（7步）
-
-`r2-cli goods up` 直接进入交互式向导：
+| `r2-cli goods shops [--json]` | 查看所有已授权店铺 |
+| `r2-cli goods stocks [--json]` | 查看所有仓库 |
+| `r2-cli goods list --stock-id <id> [--json]` | 查看仓库中的选品商品 |
+| `r2-cli goods listing [--json]` | 查询上架列表（支持 --id/--shop-id/--status 过滤） |
+| `r2-cli goods up` | 交互式上架 |
+| `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` | Agent 直接上架（自动轮询结果） |
+| `r2-cli goods down --id <id> [--json]` | 下架商品（**必须先确认**） |
+| `r2-cli goods price --id <id> --price <amount> [--json]` | 修改上架价格（**必须先询问用户新价格**） |
 
-1. **店铺选择**（缓存优先）— 有缓存直接确认，无缓存则选平台+店铺
-2. **选择商品** — 从待同步列表中选择
-3. **选择成色** — 成色等级（商品类型固定为普通商品）
-4. **商品描述** — 输入描述
-5. **选择类目** — 主类目 → 子类目
-6. **售价** — 输入售价（必须为正数）
-7. **选择属性** — 品牌/尺码/成色自动匹配
-8. **确认提交** — 展示摘要确认
-
-> 目前仅支持普通商品（bizType=2），严选商品暂不支持。
+---
 
-## AI Agent 分步上架流程
+## Agent 上架流程（4 步）
 
-Agent 无法操作交互式选择器，使用子命令逐步执行：
+**每一步 Agent 获取数据后，必须展示给用户让用户做选择。** 不要让用户自己提供 ID。
 
-```
-1. r2-cli goods list --status wait     → 获取待上架商品列表
-2. r2-cli goods up info <id>           → 获取商品详情 + 店铺 + 地址 + 预填值
-3. r2-cli goods up address ...         → （仅地址为 null 时）设置发货地址
-4. r2-cli goods up categories          → 获取分类树
-5. r2-cli goods up props <catId>       → 获取分类属性 + 品牌搜索
-6. r2-cli goods up submit ...          → 提交上架
-```
-
-### 第1步：获取待上架商品列表
+### 第 1 步：获取店铺 → 用户选择
 
 ```bash
-r2-cli goods list --status wait
-# 表格输出：ID、名称、货号、规格、售价
+r2-cli goods shops --json
 ```
 
-### 第2步：获取商品详情
+展示 `shopId`（第三方店铺 ID，**上架参数取这个，不是 `id`**）、`shopName`、`platform`。
+
+### 第 2 步：获取仓库 → 用户选择
 
 ```bash
-r2-cli goods up info <goodsInfoId>
-# 返回: { shops, selectedShop, goodsDetail(含goodsInfoId), prefill, address }
+r2-cli goods stocks --json
 ```
 
-**prefill 字段**（建议值，Agent 可参考或调整）：
-
-| 字段 | 说明 | 可选值 |
-|------|------|--------|
-| `stuffStatus` | 成色 | `"100"`全新, `"-1"`准新, `"99"`99新, `"95"`95新, `"90"`9新 |
-| `reservePrice` | 建议售价 | 金额 |
-| `desc` | 商品描述 | 文本 |
-| `brandName` | 品牌名 | 用于品牌属性搜索 |
-| `size` | 规格/尺码 | 用于尺码属性匹配 |
+展示 `stockId`、`stockName`。`stockId` 用于第 3 步过滤商品。
 
-**address**：为 `null` 时需先执行 `r2-cli goods up address --save`。
-
-选项：`--shop <shopId>` `-p, --platform <xianyu|douyin>`
-
-### 第3步：设置发货地址（如需要）
-
-非交互式（Agent 推荐）：
+### 第 3 步：获取选品商品 → 用户选择
 
 ```bash
-# 列出省份
-r2-cli goods up address --provinces
-# 列出城市
-r2-cli goods up address --cities <省份名>
-# 列出地区
-r2-cli goods up address --areas <城市名> --province <省份名>
-# 保存地址
-r2-cli goods up address --save --province <省> --city <市> --area-code <code>
+r2-cli goods list --stock-id <stockId> --json
 ```
 
-交互式（人类使用）：
+展示 `stockGoodsId`（**上架参数取这个**）、`goodsName`、`brand`、`size`、`salePrice`。支持翻页（`--page 2`）。
+
+### 第 4 步：提交上架
 
 ```bash
-r2-cli goods up address --set
+r2-cli goods up --stock-goods-id <stockGoodsId> --shop-id <shopId> --price <amount> --json
 ```
 
-查看当前地址：
+命令自动轮询上架进度（每 2 秒，最多 10 秒），返回 `{ success, data: { submit, listing } }`。检查 `data.listing.status` 判断最终状态（init/up/down/fail）。
 
-```bash
-r2-cli goods up address
-```
+### 上架参数
 
-### 第4步：获取分类列表
+| 参数 | 必填 | 来源 |
+|------|------|------|
+| `--stock-goods-id <id>` | 是 | 第 3 步 `stockGoodsId` |
+| `--shop-id <id>` | 是 | 第 1 步 `shopId`（不是 `id`） |
+| `--price <amount>` | 是 | 用户输入 |
+| `-p, --platform` | 否 | 默认 xianyu |
+| `--json` | 否 | Agent 推荐 |
 
-```bash
-r2-cli goods up categories
-# 返回: [{ catId, catName, children: [{ channel, channelCatId }] }]
-```
+---
 
-先选主类目（catId），再选子类目（channelCatId）。
+## 下架商品
 
-### 第5步：获取分类属性
+**Agent 必须先向用户确认后再下架。**
 
 ```bash
-r2-cli goods up props <channelCatId> --brand <keyword>
-# 返回: [{ propId, propName, propsValues: [{ valueId, valueName }], matched? }]
+r2-cli goods down --id <goodsListingId> --json
+# 或 --stock-goods-id <id> --shop-id <id>
 ```
 
-- 品牌属性传 `--brand` 会返回 `matched` 匹配结果
-- Agent 应优先使用 `matched` 中的值
+## 修改价格
 
-### 第6步：提交上架
+**Agent 必须先询问用户新价格，不能自行决定。** 用户说"修改价格"时，先问"要改成多少？"。
 
 ```bash
-r2-cli goods up submit \
-  --data @detail.json \
-  --division-id <id> \
-  --cat-id <catId> \
-  --channel-cat-id <channelCatId> \
-  --goods-no <货号> \
-  --size <规格> \
-  --attrs @attrs.json \
-  --services @services.json
+r2-cli goods price --id <goodsListingId> --price <新价格> --json
+# 或 --stock-goods-id <id> --shop-id <id>
 ```
 
-**`--data`**：goodsDetail JSON（`@file.json` 从文件读取，或直接传 JSON 字符串）。goodsDetail 中已包含 `goodsInfoId`、`account`、`imageList`、`spBizType` 等全量字段，会透传给上架接口。
-
-**必填参数**：`--data`、`--division-id`、`--cat-id`、`--channel-cat-id`
-
-**可选覆盖参数**：
-- `--price <amount>` — 覆盖售价
-- `--stuff <status>` — 覆盖成色
-- `--desc <desc>` — 覆盖描述
-- `--goods-no <no>` — 货号
-- `--size <size>` — 规格
-- `--title <title>` — 标题
-- `--attrs <json>` — 属性列表 JSON（`@file.json` 从文件读取）
-- `--services <json>` — 服务保障 JSON（`@file.json` 从文件读取）
+## 查询上架列表
 
-**attrs 格式**：
-```json
-[
-  { "propId": "xxx", "valueId": "yyy", "valueName": "JORDAN" }
+```bash
+r2-cli goods listing --json
+# 支持 --id / --shop-id / --stock-goods-id / --status <init|up|down|fail> / --platform 过滤
 ```
 
-## 缓存
-
-- **店铺**：首次选择后缓存到 `~/.r2-cli/config.json`，下次自动使用
-- **地址**：`address --save` 或交互式设置后缓存
+---
 
-## 业务约束
+## 错误处理
 
-- 排除商品原始 `price`，只用用户确认的 `reservePrice` 和 `originalPrice`
-- 目前仅支持普通商品（itemBizType=2）
-- Windows 下 JSON 参数建议用 `@file.json` 方式传
+所有命令统一格式：`{ "success": false, "error": "错误信息" }`。检查 `success` 判断成败。