@round2ai/r2-cli 1.0.16 → 1.0.17

package/README.md

@@ -5,7 +5,7 @@
 
 R2-CLI — 二手潮奢交易命令行工具，由 [Round2AI](https://github.com/Round2AI) 团队维护 — 让人类和 AI Agent 都能在终端中完成商品上架等交易操作。
 
-覆盖商品上架、挂售、商品信息修改、认证登录等核心业务域，提供 19 个命令及 3 个 AI Agent [Skills](./skills/)。
+覆盖闲鱼/淘宝双平台商品上架、挂售、商品信息修改、认证登录等核心业务域，提供 20+ 命令及 3 个 AI Agent [Skills](./skills/)。
 
 [安装](#安装与快速开始) · [AI Agent 快速开始](#快速开始ai-agent) · [Agent Skills](#agent-skills) · [认证](#认证) · [命令](#命令参考) · [进阶用法](#进阶用法) · [安全](#安全与风险提示使用前必读) · [反馈](#反馈与支持)
 
@@ -21,8 +21,9 @@ R2-CLI — 二手潮奢交易命令行工具，由 [Round2AI](https://github.com
 | 类别 | 能力 |
 |------|------|
 | 认证登录 | 扫码登录（第二回合 APP / 微信 / 支付宝）、闲鱼店铺授权、状态查询、登出（Agent 一步式流程） |
-| 商品管理 | 商品上架（4 步流程：获取店铺 → 获取仓库 → 获取选品商品 → 提交上架 + 自动轮询上架结果）、商品信息修改（AI 读图识别 → 自动匹配类目/属性 → 提交修改）、店铺查看、仓库查看、选品商品查看、上架列表查询、下架、改价 |
-| 闲鱼挂售 | 图片上传（自动压缩大图、并行上传、失败重试）→ AI 读图识别商品信息 → 自动匹配类目/属性 → 提交挂售 |
+| 商品管理（闲鱼） | 商品上架（4 步流程）、商品信息修改（AI 读图识别 → 自动匹配类目/属性 → 提交修改）、挂售上架（图片上传 → AI 识别 → 类目/属性匹配 → 提交）、上架列表查询、下架、改价（支持同时修改运费和验货宝） |
+| 商品管理（淘宝） | 阿里资产上架（SPU 查询 → SKU 详情 → 选择 + 价格 → 申请上架）、已上架列表查询、改价、改库存、下架 |
+| 跨平台查询 | 店铺查看、仓库查看、选品商品查看（共享命令，无需指定平台） |
 
 ---
 
@@ -45,8 +46,8 @@ r2-cli auth login
 # 2. 查看授权店铺
 r2-cli goods shops
 
-# 3. 交互式上架
-r2-cli goods up
+# 3. 交互式上架（闲鱼）
+r2-cli goods xianyu up
 ```
 
 ---
@@ -96,8 +97,8 @@ r2-cli goods stocks --json
 r2-cli goods list --stock-id <stockId> --json    # 按仓库过滤
 r2-cli goods list --stock-goods-id <id> --json   # 或按商品 ID 查询
 
-# 4. 提交上架（自动轮询上架结果）
-r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json
+# 4. 提交上架（闲鱼，自动轮询上架结果）
+r2-cli goods xianyu up --stock-goods-id <id> --shop-id <id> --price <amount> --json
 ```
 
 ---
@@ -117,7 +118,7 @@ npx skills add Round2AI/r2-cli --all -y
 |-------|------|
 | `r2-shared` | 共享基础：安装、统一错误格式、命令概览 |
 | `r2-auth` | 认证登录：一步式扫码登录（生成二维码 + 自动轮询，支持第二回合 APP / 微信 / 支付宝）、闲鱼店铺授权、状态查询、登出 |
-| `r2-goods` | 商品管理：4 步上架流程、挂售流程、商品信息修改（AI 读图识别 → 自动匹配类目/属性 → 提交）、下架、改价、店铺/仓库/商品/上架列表查看 |
+| `r2-goods` | 商品管理：闲鱼 4 步上架流程、挂售流程、商品信息修改（AI 读图识别 → 自动匹配类目/属性 → 提交）、下架、改价（运费+验货宝）、淘宝阿里资产上架（SPU/SKU）、店铺/仓库/商品/上架列表查看 |
 
 ---
 
@@ -130,7 +131,10 @@ npx skills add Round2AI/r2-cli --all -y
 | `r2-cli auth login poll --token <>` | 手动轮询登录状态（备选，不推荐） |
 | `r2-cli auth xianyu` | 闲鱼店铺授权（自动打开浏览器，人类使用） |
 | `r2-cli auth xianyu --json` | 闲鱼店铺授权（自动打开浏览器 + JSON 输出，Agent 推荐） |
-| `r2-cli auth xianyu poll --state <>` | 轮询授权状态 JSON（备选，不推荐） |
+| `r2-cli auth xianyu poll --state <>` | 轮询闲鱼授权状态 JSON（备选，不推荐） |
+| `r2-cli auth taobao` | 淘宝店铺授权（自动打开浏览器，人类使用） |
+| `r2-cli auth taobao --json` | 淘宝店铺授权（自动打开浏览器 + JSON 输出，Agent 推荐） |
+| `r2-cli auth taobao poll --state <>` | 轮询淘宝授权状态 JSON（备选，不推荐） |
 | `r2-cli auth status` | 查看登录状态 |
 | `r2-cli auth logout` | 退出登录 |
 
@@ -140,41 +144,53 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
 
 ## 命令参考
 
-### 商品查询
+### 商品查询（跨平台）
 
 | 命令 | 说明 |
 |------|------|
-| `r2-cli goods shops [--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`，最大 50） |
-| `r2-cli goods listing [--json]` | 查询上架列表（支持 `--id` / `--shop-id` / `--stock-goods-id` / `--stock-id` / `--status <init|up|down|fail|sold>` / `--platform` 过滤，支持 `--page` / `--size` 分页） |
 
-### 商品上架/下架/改价
+### 闲鱼上架/下架/改价
 
 | 命令 | 说明 |
 |------|------|
-| `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]` | 下架商品（也可用 `--stock-goods-id <id> --shop-id <id>`） |
-| `r2-cli goods price --id <id> --price <amount> [--json]` | 修改上架价格（也可用 `--stock-goods-id <id> --shop-id <id>`） |
+| `r2-cli goods xianyu up` | 交互式上架（自动轮询上架结果） |
+| `r2-cli goods xianyu up --stock-goods-id <id> --shop-id <id> --price <amount> --json` | Agent 直接上架 |
+| `r2-cli goods xianyu down --id <id> [--json]` | 下架商品（也可用 `--stock-goods-id <id> --shop-id <id>`） |
+| `r2-cli goods xianyu price --id <id> --price <amount> [--transport-fee <amount>] [--json]` | 改价（可同时修改运费） |
+| `r2-cli goods xianyu listing [--json]` | 查询上架列表（支持 `--status <init|up|down|fail|sold>` / `--shop-id` / `--page` / `--size` 过滤） |
 
-### 修改商品信息
+### 淘宝阿里资产管理
 
-修改已上架商品的标题、描述、品牌、类目、图片、属性等。Agent 可自动读图识别并填充商品信息。
+| 命令 | 说明 |
+|------|------|
+| `r2-cli goods taobao alzc spu-query --shop-id <id> --goods-no <no> [--json]` | 查询可申请的 SPU |
+| `r2-cli goods taobao alzc spu-detail --shop-id <id> --jbp-spu-id <id> [--json]` | 查询 SPU 详情（含可申请 SKU） |
+| `r2-cli goods taobao alzc apply --shop-id <id> --jbp-spu-id <id> --apply-skus '<json>' [--json]` | 申请上架 SKU |
+| `r2-cli goods taobao listing --shop-id <id> [--json]` | 查询淘宝已上架列表 |
+| `r2-cli goods taobao price --jbp-spu-id <id> --jbp-sku-id <id> --shop-id <id> --price <amount> --json` | 修改 SKU 价格 |
+| `r2-cli goods taobao down --jbp-spu-id <id> --shop-id <id> [--json]` | 下架阿里资产商品 |
+
+### 闲鱼修改商品信息
+
+修改已上架商品的标题、描述、品牌、类目、图片、属性、运费、验货宝等。Agent 可自动读图识别并填充商品信息。
 
 | 命令 | 说明 |
 |------|------|
-| `r2-cli goods edit --id <id> --category-id <id> --channel-cat-id <id> --json` | 修改商品信息（必填：定位参数 + 类目） |
-| `r2-cli goods edit --id <id> --category-id <id> --channel-cat-id <id> --image-ids <ids> --item-attrs <json> --brand-name <name> --json` | 带图片和属性修改 |
+| `r2-cli goods xianyu edit --id <id> --category-id <id> --channel-cat-id <id> --json` | 修改商品信息（必填：定位参数 + 类目） |
+| `r2-cli goods xianyu edit --id <id> --category-id <id> --channel-cat-id <id> --image-ids <ids> --item-attrs <json> --brand-name <name> --json` | 带图片和属性修改 |
+| `r2-cli goods xianyu edit --id <id> --category-id <id> --channel-cat-id <id> --transport-fee <amount> --yhb --json` | 修改运费和验货宝 |
 
 **定位商品**：优先使用 `--id <goodsListingId>`（从上架列表 `id` 字段获取），也可用 `--stock-goods-id <id> --account <shopId>`。**必填参数**：定位参数（二选一）+ `--category-id` + `--channel-cat-id`（后端必填）
 
 **关键约束**：
 - **类目 ID 必须传**：即使不改类目也要传 `--category-id` 和 `--channel-cat-id`，后端复用挂售 DTO，缺少会报 `getCategoryId() is null`
-- **`--item-attrs` 必须包含所有属性**：后端替换整个属性列表，漏传的属性会被清除。从 `goods hang-up props --channel-cat-id <id> --json` 获取全部属性后，修改目标值，其他保持原样一并传入
+- **`--item-attrs` 必须包含所有属性**：后端替换整个属性列表，漏传的属性会被清除。从 `goods xianyu hang-up props --channel-cat-id <id> --json` 获取全部属性后，修改目标值，其他保持原样一并传入
 - **品牌必须双传**：`--brand-name`（文本字段）+ itemAttrs 中的品牌项（含 propId/valueId/valueName/propName/channelCatId 五个字段），缺一不可
 
-**可选参数**：`--title`、`--desc`、`--image-ids`（需先通过 `hang-up upload-images` 上传）、`--item-attrs`（JSON，5 字段格式）、`--brand-name`、`--stuff-status`、`--goods-no`、`--original-price`、`--size`
+**可选参数**：`--title`、`--desc`、`--image-ids`（需先通过 `hang-up upload-images` 上传）、`--item-attrs`（JSON，5 字段格式）、`--brand-name`、`--stuff-status`、`--goods-no`、`--original-price`、`--size`、`--transport-fee`（运费，默认 0 包邮）、`--yhb`（验货宝）
 
 ### 闲鱼挂售（完整商品信息模式）
 
@@ -182,11 +198,11 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
 
 | 命令 | 说明 |
 |------|------|
-| `r2-cli goods hang-up categories [--json]` | 获取闲鱼类目列表（大分类 → 小分类） |
-| `r2-cli goods hang-up props --channel-cat-id <id> [--json]` | 获取指定类目下的属性列表（含可选值） |
-| `r2-cli goods hang-up brands --channel-cat-id <id> --prop-id <id> --key <keyword> [--json]` | 品牌搜索 |
-| `r2-cli goods hang-up upload-images --shop-id <id> --files <paths> --json` | 批量上传图片到闲鱼（挂售前必须先上传） |
-| `r2-cli goods hang-up submit --shop-id <id> --title <> --price <> --category-id <> --channel-cat-id <> --image-ids <> --stuff-status <> --desc <> --out-item-no <> --json` | 提交挂售上架 |
+| `r2-cli goods xianyu hang-up categories [--json]` | 获取闲鱼类目列表（大分类 → 小分类） |
+| `r2-cli goods xianyu hang-up props --channel-cat-id <id> [--json]` | 获取指定类目下的属性列表（含可选值） |
+| `r2-cli goods xianyu hang-up brands --channel-cat-id <id> --prop-id <id> --key <keyword> [--json]` | 品牌搜索 |
+| `r2-cli goods xianyu hang-up upload-images --shop-id <id> --files <paths> --json` | 批量上传图片到闲鱼（挂售前必须先上传） |
+| `r2-cli goods xianyu hang-up submit --shop-id <id> --title <> --price <> --category-id <> --channel-cat-id <> --image-ids <> --stuff-status <> --desc <> --out-item-no <> --json` | 提交挂售上架 |
 
 **挂售必填参数**：`--shop-id`、`--title`、`--price`、`--category-id`（大分类 ID）、`--channel-cat-id`（小分类 ID）、`--image-ids`（图片 ID，逗号分隔）、`--stuff-status`（成色：100 全新 / -1 准新 / 99 99新 / 95 95新 / 90 9新）、`--desc`（商品描述）、`--out-item-no`（商家编码，同店铺唯一）
 
@@ -202,6 +218,7 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
 |------|------|
 | `r2-cli update` | 一键更新 CLI 和技能 |
 | `r2-cli uninstall` | 卸载 R2-CLI 并清除所有配置 |
+| `r2-cli install` | 交互式引导安装（含 Skills 自动安装） |
 
 ---
 
@@ -216,20 +233,20 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
 
 ### 分页查询
 
-查询类命令（`goods list`、`goods listing`）支持分页：
+查询类命令（`goods list`、`goods xianyu listing`、`goods taobao listing`）支持分页：
 
 ```bash
 # 每页 50 条（最大）
 r2-cli goods list --stock-id <id> --page 1 --size 50 --json
-r2-cli goods listing --status up --page 2 --size 50 --json
+r2-cli goods xianyu listing --status up --page 2 --size 50 --json
 ```
 
 ### 状态过滤
 
 ```bash
-r2-cli goods listing --status up     # 已上架
-r2-cli goods listing --status sold   # 已售出
-r2-cli goods listing --status down   # 已下架
+r2-cli goods xianyu listing --status up     # 已上架
+r2-cli goods xianyu listing --status sold   # 已售出
+r2-cli goods xianyu listing --status down   # 已下架
 ```
 
 ### 跨店铺操作
@@ -237,8 +254,8 @@ r2-cli goods listing --status down   # 已下架
 同一商品可上架到多个店铺，每个操作独立执行：
 
 ```bash
-r2-cli goods up --stock-goods-id <id> --shop-id <shopA> --price <n> --json
-r2-cli goods up --stock-goods-id <id> --shop-id <shopB> --price <n> --json
+r2-cli goods xianyu up --stock-goods-id <id> --shop-id <shopA> --price <n> --json
+r2-cli goods xianyu up --stock-goods-id <id> --shop-id <shopB> --price <n> --json
 ```
 
 ### 批量操作

package/dist/pages/{xianyu-auth.html → third-auth.html}

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
-    <title>闲鱼店铺授权</title>
+    <title>店铺授权</title>
     <style>
       * {
         box-sizing: border-box;
@@ -11,16 +11,16 @@
         padding: 0;
       }
       :root {
-        --primary: #ffe60f;
-        --primary-light: #ffe60f1a;
-        --primary-dark: #ffe60fcc;
+        --primary: #999;
+        --primary-light: #9999991a;
+        --primary-dark: #999999cc;
         --text: #1a1a1a;
         --text-muted: #8c8c8c;
         --bg: #f7f8fa;
         --card: #fff;
         --border: #e8e8e8;
         --radius: 16px;
-        --shadow: 0 2px 16px #ffe60f1a;
+        --shadow: 0 2px 16px #9999991a;
         --success: #52c41a;
         --error: #ff4d4f;
         --info: #1890ff;
@@ -110,7 +110,7 @@
       .auth-btn:hover {
         background: var(--primary-dark);
         transform: translateY(-1px);
-        box-shadow: 0 4px 12px #ffe60f33;
+        box-shadow: 0 4px 12px #99999933;
       }
       .status-icon {
         font-size: 56px;
@@ -177,34 +177,48 @@
   <body>
     <div class="card" id="app">
       <div class="brand">
-        <div class="brand-name">闲鱼授权</div>
+        <div class="brand-name" id="brandName">店铺授权</div>
         <div class="brand-sub">Round2AI</div>
       </div>
-      <img id="qr" src="./qr.png" alt="闲鱼店铺授权" />
+      <img id="qr" src="./qr.png" alt="店铺授权" />
       <p class="status-text" id="statusText">请扫码授权</p>
       <p class="scan-hint">支持 浏览器 / 微信 扫码</p>
       <a class="auth-btn" id="auth-btn" style="display: none" href="#" target="_blank">点击授权</a>
       <p class="hint" id="hint"></p>
     </div>
     <script>
-      const qr = document.getElementById("qr"),
+      var brandTitle = "店铺授权";
+      var qr = document.getElementById("qr"),
         st = document.getElementById("statusText"),
         ht = document.getElementById("hint"),
         app = document.getElementById("app"),
         bd = document.body;
-      const states = {
+      var states = {
         waiting: { icon: "", text: "请扫码授权", hint: "", bg: "", dim: false },
         scanning: { icon: "", text: '<span class="pulse"></span>处理中...', hint: "等待确认中...", bg: "scanning-bg", dim: true },
         success: { icon: "✅", text: "授权成功！", hint: "可关闭此页面", bg: "success-bg", dim: true },
         expired: { icon: "⏰", text: "二维码已过期", hint: "请重新获取", bg: "expired-bg", dim: true },
       };
+      function applyBranding(color, title) {
+        if (color) {
+          document.documentElement.style.setProperty("--primary", color);
+          document.documentElement.style.setProperty("--primary-light", color + "1a");
+          document.documentElement.style.setProperty("--primary-dark", color + "cc");
+          document.documentElement.style.setProperty("--shadow", "0 2px 16px " + color + "1a");
+        }
+        if (title) {
+          brandTitle = title;
+          document.getElementById("brandName").textContent = title;
+          document.title = title;
+        }
+      }
       function render(s) {
-        const d = states[s] || states.waiting;
+        var d = states[s] || states.waiting;
         bd.className = d.bg;
         if (d.icon) {
           qr.style.display = "none";
           app.innerHTML =
-            '<div class="brand"><div class="brand-name">闲鱼授权</div><div class="brand-sub">Round2AI</div></div><div class="status-icon">' +
+            '<div class="brand"><div class="brand-name">' + brandTitle + '</div><div class="brand-sub">Round2AI</div></div><div class="status-icon">' +
             d.icon +
             '</div><p class="status-text">' +
             d.text +
@@ -222,6 +236,7 @@
           return r.json();
         })
         .then(function (data) {
+          applyBranding(data.primaryColor, data.title);
           if (data.authUrl) {
             var btn = document.getElementById("auth-btn");
             btn.href = data.authUrl;
@@ -229,10 +244,10 @@
           }
         })
         .catch(function () {});
-      const es = new EventSource("./events");
+      var es = new EventSource("./events");
       es.onmessage = function (e) {
         try {
-          const d = JSON.parse(e.data);
+          var d = JSON.parse(e.data);
           if (d.status) render(d.status);
         } catch (ex) {}
       };