@round2ai/r2-cli 1.0.6 → 1.0.9-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@round2ai/r2-cli",
-  "version": "1.0.6",
+  "version": "1.0.9-beta.0",
   "description": "R2-CLI，向 AI 开放二手潮奢交易全链路能力",
   "main": "dist/r2-cli.js",
   "type": "module",
@@ -14,6 +14,7 @@
   },
   "keywords": [
     "round2ai",
+    "r2",
     "r2-cli",
     "cli",
     "ai",
@@ -23,7 +24,7 @@
   ],
   "files": [
     "dist",
-    ".claude/skills/r2-cli-0.1.0",
+    "skills",
     "package.json",
     "README.md"
   ],
@@ -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

@@ -0,0 +1,80 @@
+---
+name: r2-auth
+description: R2-CLI 认证登录专家。两步式扫码登录和闲鱼店铺授权。用于登录、login、auth、扫码、二维码、授权、xianyu、logout、登出、状态查询场景。Agent 生成二维码后同时展示 unicodeQR 和 qrUrl 给用户。
+---
+
+# R2-Auth Skill
+
+两步式扫码登录 + 闲鱼店铺授权，专为 AI Agent 设计。
+
+## 命令前缀
+
+见 **r2-cli** skill 的"命令前缀自动检测"章节。
+
+## 扫码登录（两步）
+
+### 第 1 步：生成二维码
+
+```bash
+r2-cli auth login qr
+```
+
+输出 JSON：
+```json
+{
+  "qrToken": "xxx",
+  "expireTimeMs": 300000,
+  "pollIntervalMs": 800,
+  "unicodeQR": "█▀▀▀▀▀█ ...",
+  "url": "https://m.puresnake.com/r2/auth/login?qrToken=xxx&from=wechat",
+  "qrUrl": "http://127.0.0.1:52173/login/"
+}
+```
+
+**Agent 必须同时展示以下两种方式**：
+
+1. 将 `unicodeQR` 直接输出到聊天窗口（unicode 半块字符 █▀▄ 可显示为 QR 码）
+2. 输出 `qrUrl` 链接供用户点击在浏览器中打开
+
+两种方式缺一不可。用户可使用**第二回合 APP / 微信 / 支付宝**扫码。
+
+### 第 2 步：立即轮询登录状态
+
+**关键**：输出二维码后，Agent 必须立即在后台启动轮询，不要等待用户回复。
+
+```bash
+r2-cli auth login poll --token <qrToken> --expire <expireTimeMs> --interval <pollIntervalMs>
+```
+
+使用 Bash 工具的 `run_in_background: true` 启动，然后用 `TaskOutput` 阻塞等待。参数取自第 1 步返回的 JSON。
+
+成功：`{ "success": true, "userInfo": { "nickname": "...", "mobile": "..." }, "token": "..." }`
+失败：`{ "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`。
+
+## 其他命令
+
+| 命令 | 说明 |
+|------|------|
+| `r2-cli auth status` | 查看登录状态 |
+| `r2-cli auth logout` | 退出登录 |
+
+## 注意事项
+
+- 二维码默认 5 分钟过期，超时需重新执行第 1 步
+- 登录成功后，后续 goods 等命令可直接使用

package/skills/r2-auth/_meta.json

@@ -0,0 +1,5 @@
+{
+  "ownerId": "round2ai",
+  "slug": "r2-auth",
+  "version": "0.1.0"
+}

package/skills/r2-cli/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: r2-cli
+description: R2-CLI 二手潮奢交易 CLI 工具。用于认证登录、商品上架/下架/改价、查看店铺/仓库/选品商品/上架列表。Agent 获取数据后展示给用户选择，完成 4 步上架流程。触发词：r2-cli、登录、上架、下架、改价、商品、goods、auth、shops、stocks、listing。
+---
+
+# R2-CLI Skill
+
+二手潮奢交易命令行工具。
+
+## 安装
+
+```bash
+npm install -g @round2ai/r2-cli@latest
+```
+
+## 命令前缀自动检测
+
+首次使用时检测一次，后续所有命令使用检测到的前缀：
+
+1. 项目目录有 `package.json`（name 含 r2-cli）→ `npm run dev --`
+2. 存在 `dist/r2-cli.js` → `node dist/r2-cli.js`
+3. `r2-cli --version` 成功 → `r2-cli`
+
+> 部分平台 npm 会拦截 `--help` 等 flag，改用 `npx tsx src/entrypoints/r2-cli.tsx --help`。
+
+## 前置条件
+
+- 先登录：`r2-cli auth login`（支持第二回合 APP / 微信 / 支付宝扫码）
+- 检查状态：`r2-cli auth status`
+
+所有 `--json` 命令输出 `{ success: false, error: "..." }` 格式错误，检查 `success` 判断成败。
+
+## 认证命令
+
+| 命令 | 说明 |
+|------|------|
+| `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` | 退出登录 |
+
+> 认证登录的 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-cli/_meta.json

@@ -0,0 +1,5 @@
+{
+  "ownerId": "round2ai",
+  "slug": "r2-cli",
+  "version": "0.1.0"
+}

package/skills/r2-goods/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: r2-goods
+description: R2-CLI 商品管理专家。用于商品上架/下架/改价、查看店铺/仓库/选品商品/上架列表。Agent 获取数据后展示给用户选择，完成 4 步上架流程。触发词：上架、下架、改价、商品列表、goods、up、down、price、shops、stocks、listing、list。
+---
+
+# R2-Goods Skill
+
+商品管理专家，指导 AI Agent 完成商品上架、下架、改价全流程。
+
+## 命令前缀
+
+见 **r2-cli** 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 步：获取店铺 → 用户选择
+
+```bash
+r2-cli goods shops --json
+```
+
+展示 `shopId`（第三方店铺 ID，**上架参数取这个，不是 `id`**）、`shopName`、`platform`。
+
+### 第 2 步：获取仓库 → 用户选择
+
+```bash
+r2-cli goods stocks --json
+```
+
+展示 `stockId`、`stockName`。`stockId` 用于第 3 步过滤商品。
+
+### 第 3 步：获取选品商品 → 用户选择
+
+```bash
+r2-cli goods list --stock-id <stockId> --json
+```
+
+展示 `stockGoodsId`（**上架参数取这个**）、`goodsName`、`brand`、`size`、`salePrice`。支持翻页（`--page 2`）。
+
+### 第 4 步：提交上架
+
+```bash
+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）。
+
+### 上架参数
+
+| 参数 | 必填 | 来源 |
+|------|------|------|
+| `--stock-goods-id <id>` | 是 | 第 3 步 `stockGoodsId` |
+| `--shop-id <id>` | 是 | 第 1 步 `shopId`（不是 `id`） |
+| `--price <amount>` | 是 | 用户输入 |
+| `-p, --platform` | 否 | 默认 xianyu |
+| `--json` | 否 | Agent 推荐 |
+
+---
+
+## 下架商品
+
+**Agent 必须先向用户确认后再下架。**
+
+```bash
+r2-cli goods down --id <goodsListingId> --json
+# 或 --stock-goods-id <id> --shop-id <id>
+```
+
+## 修改价格
+
+**Agent 必须先询问用户新价格，不能自行决定。** 用户说"修改价格"时，先问"要改成多少？"。
+
+```bash
+r2-cli goods price --id <goodsListingId> --price <新价格> --json
+# 或 --stock-goods-id <id> --shop-id <id>
+```
+
+## 查询上架列表
+
+```bash
+r2-cli goods listing --json
+# 支持 --id / --shop-id / --stock-goods-id / --status <init|up|down|fail> / --platform 过滤
+```
+
+---
+
+## 错误处理
+
+所有命令统一格式：`{ "success": false, "error": "错误信息" }`。检查 `success` 判断成败。

package/skills/r2-goods/_meta.json

@@ -0,0 +1,5 @@
+{
+  "ownerId": "round2ai",
+  "slug": "r2-goods",
+  "version": "0.1.0"
+}