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

package/README.md

@@ -146,8 +146,8 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
 |------|------|
 | `r2-cli goods shops [--json]` | 查看所有已授权店铺（跨平台） |
 | `r2-cli goods stocks [--json]` | 查看所有仓库 |
-| `r2-cli goods list [--stock-id <id>] [--stock-goods-id <id>] [--json]` | 查看选品商品（可按仓库或商品 ID 过滤，支持 `--page` 和 `--size`） |
-| `r2-cli goods listing [--json]` | 查询上架列表（支持 `--id` / `--shop-id` / `--stock-goods-id` / `--stock-id` / `--status` / `--platform` 过滤） |
+| `r2-cli goods list [--stock-id <id>] [--stock-goods-id <id>] [--json]` | 查看选品商品（可按仓库或商品 ID 过滤，支持 `--page` 和 `--size`，最大 50） |
+| `r2-cli goods listing [--json]` | 查询上架列表（支持 `--id` / `--shop-id` / `--stock-goods-id` / `--stock-id` / `--status <init|up|down|fail|sold>` / `--platform` 过滤，支持 `--page` / `--size` 分页） |
 
 ### 商品上架/下架/改价
 
@@ -204,7 +204,7 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
 
 建议：
 - Agent 收到"上架"指令时，若用户未明确指定方式（选品上架/挂售上架），**必须询问用户**选择哪种上架方式
-- Agent 自动识别图片并填充商品信息，缺少必填字段（售价、商家编码）时会向用户询问
+- Agent 自动识别图片并填充商品信息，售价必问用户；商家编码优先让用户自定义，不填则自动生成推荐
 - Token 存储在本地 `~/.r2-cli/config.json`（原子写入，防止中断导致配置丢失），注意保护
 
 ---

package/dist/README.md

@@ -146,8 +146,8 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
 |------|------|
 | `r2-cli goods shops [--json]` | 查看所有已授权店铺（跨平台） |
 | `r2-cli goods stocks [--json]` | 查看所有仓库 |
-| `r2-cli goods list [--stock-id <id>] [--stock-goods-id <id>] [--json]` | 查看选品商品（可按仓库或商品 ID 过滤，支持 `--page` 和 `--size`） |
-| `r2-cli goods listing [--json]` | 查询上架列表（支持 `--id` / `--shop-id` / `--stock-goods-id` / `--stock-id` / `--status` / `--platform` 过滤） |
+| `r2-cli goods list [--stock-id <id>] [--stock-goods-id <id>] [--json]` | 查看选品商品（可按仓库或商品 ID 过滤，支持 `--page` 和 `--size`，最大 50） |
+| `r2-cli goods listing [--json]` | 查询上架列表（支持 `--id` / `--shop-id` / `--stock-goods-id` / `--stock-id` / `--status <init|up|down|fail|sold>` / `--platform` 过滤，支持 `--page` / `--size` 分页） |
 
 ### 商品上架/下架/改价
 
@@ -204,7 +204,7 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
 
 建议：
 - Agent 收到"上架"指令时，若用户未明确指定方式（选品上架/挂售上架），**必须询问用户**选择哪种上架方式
-- Agent 自动识别图片并填充商品信息，缺少必填字段（售价、商家编码）时会向用户询问
+- Agent 自动识别图片并填充商品信息，售价必问用户；商家编码优先让用户自定义，不填则自动生成推荐
 - Token 存储在本地 `~/.r2-cli/config.json`（原子写入，防止中断导致配置丢失），注意保护
 
 ---

package/dist/r2-cli.js

@@ -1482,14 +1482,14 @@ import chalk8 from "chalk";
 function createListCommand() {
   const command = new Command8("list");
   command.description("\u67E5\u770B\u4ED3\u5E93\u4E2D\u7684\u9009\u54C1\u5546\u54C1");
-  command.option("--stock-id <id>", "\u4ED3\u5E93 ID\uFF08\u4ECE goods stocks \u83B7\u53D6\uFF09").option("--stock-goods-id <id>", "\u5E93\u5B58\u5546\u54C1 ID").option("--page <n>", "\u9875\u7801", "1").option("--size <n>", "\u6BCF\u9875\u6570\u91CF", "20").option("--json", "\u8F93\u51FA JSON\uFF08\u4F9B AI Agent \u4F7F\u7528\uFF09");
+  command.option("--stock-id <id>", "\u4ED3\u5E93 ID\uFF08\u4ECE goods stocks \u83B7\u53D6\uFF09").option("--stock-goods-id <id>", "\u5E93\u5B58\u5546\u54C1 ID").option("--page <n>", "\u9875\u7801", "1").option("--size <n>", "\u6BCF\u9875\u6570\u91CF\uFF08\u6700\u5927 50\uFF09", "20").option("--json", "\u8F93\u51FA JSON\uFF08\u4F9B AI Agent \u4F7F\u7528\uFF09");
   command.action(
     jsonAction(async (options) => {
       const result = await getSelectGoodsList({
         stockId: options.stockId || void 0,
         stockGoodsId: options.stockGoodsId || void 0,
         page: Number(options.page) || 1,
-        size: Number(options.size) || 20
+        size: Math.min(Number(options.size) || 20, 50)
       });
       const data = result ?? { items: [], total: 0 };
       if (options.json) {
@@ -1534,7 +1534,8 @@ var STATUS_MAP = {
   init: { label: "\u5F85\u4E0A\u67B6", color: "yellow" },
   up: { label: "\u5DF2\u4E0A\u67B6", color: "green" },
   down: { label: "\u5DF2\u4E0B\u67B6", color: "gray" },
-  fail: { label: "\u5931\u8D25", color: "red" }
+  fail: { label: "\u5931\u8D25", color: "red" },
+  sold: { label: "\u5DF2\u552E\u51FA", color: "blue" }
 };
 var COL_ID3 = 4;
 var COL_STATUS2 = 8;
@@ -1610,7 +1611,7 @@ function ListingTable({ items, total }) {
 function createListingCommand() {
   const command = new Command9("listing");
   command.description("\u67E5\u8BE2\u4E0A\u67B6\u5546\u54C1\u5217\u8868");
-  command.option("--id <id>", "\u4E0A\u67B6\u8BB0\u5F55 ID").option("--stock-goods-id <id>", "\u5E93\u5B58\u5546\u54C1 ID").option("--shop-id <id>", "\u5E97\u94FA ID").option("--stock-id <id>", "\u4ED3\u5E93 ID").option("-s, --status <status>", "\u72B6\u6001\u8FC7\u6EE4\uFF08init/up/down/fail\uFF09").option("-p, --platform <platform>", "\u5E73\u53F0", "xianyu").option("--json", "\u8F93\u51FA JSON\uFF08\u4F9B AI Agent \u4F7F\u7528\uFF09");
+  command.option("--id <id>", "\u4E0A\u67B6\u8BB0\u5F55 ID").option("--stock-goods-id <id>", "\u5E93\u5B58\u5546\u54C1 ID").option("--shop-id <id>", "\u5E97\u94FA ID").option("--stock-id <id>", "\u4ED3\u5E93 ID").option("-s, --status <status>", "\u72B6\u6001\u8FC7\u6EE4\uFF08init/up/down/fail/sold\uFF09").option("-p, --platform <platform>", "\u5E73\u53F0", "xianyu").option("--page <n>", "\u9875\u7801", "1").option("--size <n>", "\u6BCF\u9875\u6570\u91CF\uFF08\u6700\u5927 50\uFF09", "20").option("--json", "\u8F93\u51FA JSON\uFF08\u4F9B AI Agent \u4F7F\u7528\uFF09");
   command.action(
     jsonAction(async (options) => {
       const result = await getListingList({
@@ -1619,7 +1620,9 @@ function createListingCommand() {
         shopId: options.shopId,
         stockId: options.stockId,
         status: options.status,
-        platform: options.platform
+        platform: options.platform,
+        page: Number(options.page) || 1,
+        size: Math.min(Number(options.size) || 20, 50)
       });
       const data = result ?? { items: [], total: 0 };
       if (options.json) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@round2ai/r2-cli",
-  "version": "1.0.12-beta.2",
+  "version": "1.0.13-beta.0",
   "description": "R2-CLI，向 AI 开放二手潮奢交易全链路能力",
   "main": "dist/r2-cli.js",
   "type": "module",

package/scripts/install-skills.js

@@ -11,7 +11,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const skillsDir = path.join(__dirname, "..", "skills");
 
 try {
-  execSync(`npx skills add "${skillsDir}" --all`, {
+  execSync(`npx skills add "${skillsDir}" --all -g`, {
     stdio: "inherit",
     timeout: 60_000,
   });

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) |
 
 ### 上架/下架/改价/修改
 

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

@@ -156,7 +156,7 @@ Agent 将所有自动填充和识别结果汇总展示给用户，**一次确认
 ✅ 鞋码：42（图片识别）
 ❓ 季节：？（无法识别，请选择：春季/夏季/秋季/冬季/四季）
 💰 价格：？（必填）
-📋 商家编码：？（必填）
+📋 商家编码：？（优先自定义，不填自动生成）
 ```
 
 **处理顺序**：
@@ -164,7 +164,7 @@ Agent 将所有自动填充和识别结果汇总展示给用户，**一次确认
 2. 让用户补充缺失字段（价格、商家编码、无法识别的属性）
 3. 用户确认后直接提交
 
-**所有参数就绪后直接提交，不需要用户确认**：
+**所有参数就绪后提交**：
 
 ```bash
 r2-cli goods hang-up submit \
@@ -215,6 +215,14 @@ r2-cli goods hang-up submit \
 | `--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]` | 修改价格 |