@round2ai/r2-cli 1.0.12 → 1.0.13-beta.0

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@round2ai/r2-cli",
-  "version": "1.0.12",
+  "version": "1.0.13-beta.0",
   "description": "R2-CLI，向 AI 开放二手潮奢交易全链路能力",
   "main": "dist/r2-cli.js",
   "type": "module",
   "bin": {
-    "r2-cli": "./dist/r2-cli.js"
+    "r2-cli": "dist/r2-cli.js"
   },
   "scripts": {
     "postinstall": "node scripts/install-skills.js",
@@ -39,7 +39,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/Round2AI/r2-cli"
+    "url": "git+https://github.com/Round2AI/r2-cli.git"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.4.2",

package/scripts/install-skills.js

@@ -1,63 +1,20 @@
 /**
- * postinstall: 将 skills/ 复制到 ~/.agents/skills/
+ * postinstall: 通过 skills CLI 将本地 skills 安装到所有 Agent 目录
+ * 自动适配 Claude Code / Codex / Gemini CLI 等所有 Agent
  */
 
-import fs from "node:fs";
+import { execSync } from "node:child_process";
 import path from "node:path";
-import os from "node:os";
 import { fileURLToPath } from "node:url";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const pkgSkillsDir = path.join(__dirname, "..", "skills");
-const agentsDir = path.join(os.homedir(), ".agents", "skills");
-
-if (!fs.existsSync(pkgSkillsDir)) process.exit(0);
-
-fs.mkdirSync(agentsDir, { recursive: true });
-
-for (const name of fs.readdirSync(pkgSkillsDir)) {
-  const rawSrc = path.join(pkgSkillsDir, name);
-  let src;
-  try { src = fs.realpathSync(rawSrc); } catch { continue; }
-  if (!fs.statSync(src).isDirectory()) continue;
-
-  const dest = path.join(agentsDir, name);
-  if (fs.existsSync(dest)) {
-    for (const old of fs.readdirSync(dest)) {
-      const oldPath = path.join(dest, old);
-      fs.statSync(oldPath).isDirectory()
-        ? fs.rmSync(oldPath, { recursive: true })
-        : fs.unlinkSync(oldPath);
-    }
-  }
-  fs.mkdirSync(dest, { recursive: true });
-
-  for (const file of fs.readdirSync(src)) {
-    const fileSrc = path.join(src, file);
-    const fileDest = path.join(dest, file);
-    if (fs.statSync(fileSrc).isDirectory()) {
-      copyDir(fileSrc, fileDest);
-    } else {
-      fs.copyFileSync(fileSrc, fileDest);
-    }
-  }
-}
-
-function copyDir(src, dest) {
-  if (fs.existsSync(dest)) {
-    for (const old of fs.readdirSync(dest)) {
-      const oldPath = path.join(dest, old);
-      fs.statSync(oldPath).isDirectory()
-        ? fs.rmSync(oldPath, { recursive: true })
-        : fs.unlinkSync(oldPath);
-    }
-  }
-  fs.mkdirSync(dest, { recursive: true });
-  for (const file of fs.readdirSync(src)) {
-    const fileSrc = path.join(src, file);
-    const fileDest = path.join(dest, file);
-    fs.statSync(fileSrc).isDirectory()
-      ? copyDir(fileSrc, fileDest)
-      : fs.copyFileSync(fileSrc, fileDest);
-  }
+const skillsDir = path.join(__dirname, "..", "skills");
+
+try {
+  execSync(`npx skills add "${skillsDir}" --all -g`, {
+    stdio: "inherit",
+    timeout: 60_000,
+  });
+} catch {
+  // 网络不可用或 skills CLI 失败时静默跳过
 }

package/skills/r2-auth/SKILL.md

@@ -60,6 +60,8 @@ r2-cli auth login --json
 
 ### Agent 操作步骤
 
+> **注意**：不要在命令末尾加 `&`。`run_in_background: true` 已处理后台运行，加 `&` 会导致 shell 立即返回，无法捕获后续输出。
+
 1. 用 Bash 工具 `run_in_background: true` 启动命令
 2. 用 `TaskOutput(block=true, timeout=5000)` 获取第 1 段 JSON
 3. **必须先**将 `qrUrl` 以醒目格式单独一行展示给用户：

package/skills/r2-goods/SKILL.md

@@ -46,7 +46,7 @@ metadata:
 | `r2-cli goods shops [--json]` | 查看已授权店铺 | [r2-goods-query](references/r2-goods-query.md) |
 | `r2-cli goods stocks [--json]` | 查看仓库 | [r2-goods-query](references/r2-goods-query.md) |
 | `r2-cli goods list [--stock-id <id>] [--json]` | 查看选品商品 | [r2-goods-query](references/r2-goods-query.md) |
-| `r2-cli goods listing [--json]` | 查询上架列表 | [r2-goods-query](references/r2-goods-query.md) |
+| `r2-cli goods listing [--status <up/down/sold>] [--json]` | 查询上架列表 | [r2-goods-query](references/r2-goods-query.md) |
 
 ### 上架/下架/改价/修改
 
@@ -118,7 +118,7 @@ metadata:
 5. **汇总展示**：自动填充的字段标 ✅，缺失字段标 ❓ 让用户补充
 6. **提交**：`hang-up submit` — 必填：`shop-id`、`title`、`price`、`category-id`、`channel-cat-id`、`image-ids`、`stuff-status`、`desc`、`out-item-no`
 
-**核心原则**：**图片里能看到的，就别问用户**。只问价格和商家编码，其他全部从图片自动提取。
+**核心原则**：**图片里能看到的，就别问用户**。只问价格和商家编码（优先用户自定义，不填则推荐自动生成），其他全部从图片自动提取。
 
 **关键注意事项**：
 - **品牌必须双传**：`--brand-name` + itemAttrs 中的一项（含 propId/valueId/valueName），缺一不可

package/skills/r2-goods/references/r2-goods-hangup.md

@@ -4,13 +4,14 @@
 
 挂售模式支持完整商品信息：图片、类目、属性等。与普通上架（`goods up`）是不同流程。
 
-**核心理念**：**图片里能看到的，就别问用户**。Agent 从图片中提取一切可识别的信息，用户只需要提供价格和商家编码。
+**核心理念**：**图片里能看到的，就别问用户**。Agent 从图片中提取一切可识别的信息，用户只需要提供价格。
 
 ## 核心原则
 
 - **图片优先**：所有字段优先从图片提取，图片无法识别时才问用户
-- 必须问用户的只有：**价格、商家编码**
-- **必须问用户的条件**：价格（永远无法从图片判断）和商家编码（用户自定义）。其他一切字段都应尝试从图片获取
+- 必须问用户的只有：**价格**
+- 商家编码（`out-item-no`）**优先让用户自定义**，用户不填则推荐自动生成编码（如 `GS20260512-0005`）
+- **必须问用户的条件**：价格（永远无法从图片判断）。其他一切字段都应尝试从图片获取。商家编码优先用户自定义，不填则推荐自动生成
 - **描述必须自动生成**：基于 AI 识别的品牌+款式+颜色+材质+货号自动组合，不要标记为"需要补充"
 - **品牌必须双传**：`--brand-name`（文本字段）+ itemAttrs 中的一项（含 propId/valueId/valueName），缺一不可
 - **季节自动推断**：根据商品类型推断适用季节（夹克/风衣→春秋季，羽绒服→秋冬季，T恤/短裤→夏季），不需要问用户
@@ -69,7 +70,7 @@ r2-cli goods hang-up upload-images --shop-id <shopId> --files /path/img1.jpg,/pa
 | `--goods-no`（货号） | ⚠️ | 有标签则读取，无则留空 |
 | 款式/颜色/材质属性 | ⚠️ | 能识别则自动匹配 propsValues，不能则汇总时问 |
 | `--price`（售价） | ❌ | **必须问用户** |
-| `--out-item-no`（商家编码） | ❌ | **必须问用户** |
+| `--out-item-no`（商家编码） | ⚠️ | 先问用户自定义编码，不填则推荐自动生成（如 `GS20260512-0005`） |
 | `--shop-id`（店铺） | ❌ | 只有一个店铺时自动选，多个则问 |
 
 **成色判断映射**：
@@ -155,7 +156,7 @@ Agent 将所有自动填充和识别结果汇总展示给用户，**一次确认
 ✅ 鞋码：42（图片识别）
 ❓ 季节：？（无法识别，请选择：春季/夏季/秋季/冬季/四季）
 💰 价格：？（必填）
-📋 商家编码：？（必填）
+📋 商家编码：？（优先自定义，不填自动生成）
 ```
 
 **处理顺序**：
@@ -163,7 +164,7 @@ Agent 将所有自动填充和识别结果汇总展示给用户，**一次确认
 2. 让用户补充缺失字段（价格、商家编码、无法识别的属性）
 3. 用户确认后直接提交
 
-**所有参数就绪后直接提交，不需要用户确认**：
+**所有参数就绪后提交**：
 
 ```bash
 r2-cli goods hang-up submit \
@@ -209,11 +210,19 @@ r2-cli goods hang-up submit \
 | 缺失字段 | 何时询问 | 询问方式 |
 |----------|----------|----------|
 | `--price`（售价） | 上传图片时 | "这个商品上架价格是多少？" |
-| `--out-item-no`（商家编码） | 上传图片时 | "商家编码是什么？（同店铺唯一标识）" |
+| `--out-item-no`（商家编码） | 上传图片时 | 先问："商家编码是什么？"用户不填则推荐自动生成编码 |
 | `--shop-id`（店铺） | 流程开始时 | 展示店铺列表让用户选择 |
 | `--title`（标题） | 图片识别无法生成时 | "商品标题用什么？" |
 | `--desc`（描述） | 图片识别无法生成时 | "商品描述？" |
 
+## Agent 常见错误预防
+
+- **不要在命令末尾加 `&`**：如果用 `run_in_background: true` 启动命令，不要额外加 `&`，否则 shell 立即返回，无法捕获后续输出
+- **`--image-ids` 保持字符串**：图片 ID 是 19 位数字（如 `"1086608743767730915"`），JavaScript `Number()` 会精度丢失。拼接时用字符串拼接，不要 `parseInt`/`Number`
+- **`--stuff-status` 准新是数字 `-1`**：不是字符串 `"-1"`，直接传 `--stuff-status -1`
+- **`--item-attrs` 传 JSON 字符串**：值必须是 `JSON.stringify()` 后的字符串，不能直接传对象。命令行示例：`--item-attrs '[{"propId":"x","valueId":"y"}]'`
+- **`--files` 和 `--image-ids` 都是逗号分隔**：不要多次传 `--files`，用逗号拼成单个值：`--files a.jpg,b.jpg`
+
 ## 必填参数
 
 | 参数 | 说明 |

package/skills/r2-goods/references/r2-goods-listing.md

@@ -23,7 +23,24 @@
 }
 ```
 
-状态值：`init`（处理中）、`up`（已上架）、`down`（已下架）、`fail`（失败，查看 `errorMsg`）
+状态值：`init`（处理中）、`up`（已上架）、`down`（已下架）、`fail`（失败，查看 `errorMsg`）、`sold`（已售出）
+
+## 上架列表返回字段
+
+| 字段 | 说明 |
+|------|------|
+| `id` | 上架记录 ID（edit/down/price 的 `--id` 取这个值） |
+| `stockGoodsId` | 库存商品 ID（挂售商品可能为 0） |
+| `shopId` | 店铺 ID |
+| `goodsName` | 商品名称 |
+| `brandName` | 品牌 |
+| `price` | 上架价格 |
+| `status` | 状态：`init`/`up`/`down`/`fail`/`sold` |
+| `thirdItemNo` | 平台商品 ID |
+| `outItemNo` | 商家编码 |
+| `spec` | 规格（尺码） |
+| `platform` | 平台（xianyu） |
+| `gmtCreate` / `gmtModified` | 创建/修改时间戳 |
 
 ## 上架参数
 
@@ -71,6 +88,12 @@ r2-cli goods price --stock-goods-id <id> --shop-id <id> --price <新价格> --js
 | 上架记录 ID | `--id <goodsListingId>` | 推荐，从 listing 的 id 字段取 |
 | 库存商品 + 店铺 | `--stock-goods-id <id> --account <shopId>` | 备选，挂售商品 stockGoodsId 可能为 0 |
 
+### Agent 注意事项
+
+- **`--image-ids` 保持字符串**：图片 ID 是 19 位数字，`Number()` 会精度丢失
+- **`--item-attrs` 传 JSON 字符串**：必须是 `JSON.stringify()` 后的结果，不能直接传对象
+- **即使不改类目也要传 `--category-id` 和 `--channel-cat-id`**：后端必填，缺少会报 `getCategoryId() is null`
+
 ### 必填参数
 
 | 参数 | 说明 |
@@ -126,7 +149,7 @@ r2-cli goods edit \
 
 ```bash
 # 改标题
-r2-cli goods goods edit --id 5 \
+r2-cli goods edit --id 5 \
   --category-id 50106003 --channel-cat-id "f4718bbb04d7ed1facde29f76907b07f" \
   --title "新标题" --json
 

package/skills/r2-goods/references/r2-goods-query.md

@@ -36,7 +36,7 @@ r2-cli goods list --stock-id <stockId> --json
 r2-cli goods list --stock-goods-id <id> --json
 
 # 翻页
-r2-cli goods list --stock-id <stockId> --page 2 --size 20 --json
+r2-cli goods list --stock-id <stockId> --page 2 --size 50 --json
 ```
 
 返回字段：
@@ -54,10 +54,12 @@ r2-cli goods list --stock-id <stockId> --page 2 --size 20 --json
 
 ```bash
 r2-cli goods listing --json
-r2-cli goods listing --status up --json           # 只看已上架
+r2-cli goods listing --status up --json            # 只看已上架
+r2-cli goods listing --status sold --json          # 只看已售出
 r2-cli goods listing --shop-id <id> --json         # 按店铺过滤
 r2-cli goods listing --stock-goods-id <id> --json  # 按商品过滤
 r2-cli goods listing --id <id> --json              # 精确查询
+r2-cli goods listing --page 2 --size 50 --json     # 翻页
 ```
 
-过滤参数：`--id`、`--stock-goods-id`、`--shop-id`、`--stock-id`、`--status`（init/up/down/fail）、`--platform`
+过滤参数：`--id`、`--stock-goods-id`、`--shop-id`、`--stock-id`、`--status`（init/up/down/fail/sold）、`--platform`、`--page`（默认 1）、`--size`（默认 20，最大 50）

package/skills/r2-shared/SKILL.md

@@ -28,6 +28,7 @@ metadata:
 - 所有命令**必须**通过已安装的 `r2-cli` 二进制执行（`r2-cli goods ...`、`r2-cli auth ...`）
 - **禁止**读取项目源码或用 `tsx`/`node` 直接运行源文件
 - 如果 `r2-cli` 命令不可用，提示用户先安装：`npm install -g @round2ai/r2-cli@latest`
+- **不要在命令末尾加 `&`**：如果用 Bash 工具的 `run_in_background: true`，不要额外加 `&`，否则 shell 立即返回导致输出丢失
 
 **版本检查**：
 - 首次使用时，Agent 应运行 `r2-cli --version` 检查当前版本
@@ -66,7 +67,7 @@ npm install -g @round2ai/r2-cli@latest
 | 查询 | `r2-cli goods shops [--json]` | 查看已授权店铺 |
 | | `r2-cli goods stocks [--json]` | 查看仓库 |
 | | `r2-cli goods list [--stock-id <id>] [--json]` | 查看选品商品 |
-| | `r2-cli goods listing [--json]` | 查询上架列表 |
+| | `r2-cli goods listing [--status <up/down/sold>] [--json]` | 查询上架列表 |
 | 上架 | `r2-cli goods up --stock-goods-id <> --shop-id <> --price <> --json` | 普通上架（选品商品） |
 | | `r2-cli goods down --id <id> [--json]` | 下架商品 |
 | | `r2-cli goods price --id <id> --price <amount> [--json]` | 修改价格 |