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

package/skills/r2-goods/SKILL.md

@@ -1,11 +1,12 @@
 ---
 name: r2-goods
-version: 1.0.0
-description: "R2-CLI 商品管理专家。用于商品上架/下架/改价/挂售、查看店铺/仓库/选品商品/上架列表。Agent 获取数据后展示给用户选择，完成 4 步上架流程。触发词：上架、下架、改价、挂售、商品列表、goods、up、down、price、hang-up、shops、stocks、listing、list。"
+version: 1.1.0
+description: "R2-CLI 商品管理专家。用于商品上架/下架/改价/修改信息/挂售、查看店铺/仓库/选品商品/上架列表。Agent 获取数据后展示给用户选择，完成 4 步上架流程。触发词：上架、下架、改价、修改商品、挂售、商品列表、goods、up、down、price、edit、hang-up、shops、stocks、listing、list。"
 metadata:
   requires:
     bins: ["r2-cli"]
   cliHelp: "r2-cli goods --help"
+  minVersion: "1.0.12"
   related:
     - "r2-shared"
     - "r2-auth"
@@ -13,393 +14,120 @@ metadata:
 
 # R2-Goods (v1)
 
-> **Tip**: Agent 获取数据后展示给用户选择，不要让用户自己提供 ID。这是核心原则。
-> **Tip**: `goods up` 自动轮询上架结果（每 2 秒，最多 10 秒），无需手动查询。
-> **Tip**: `hang-up` 挂售流程：**先上传图片 → Agent 尝试识别图片自动填充信息（不能识别则询问用户）→ 匹配类目/属性 → 提交**。支持多模态的 Agent（Claude Code/Gemini）可自动识别，不支持的 Agent 走询问路径。
+> **Tip**: Agent 获取数据后展示给用户选择，不要让用户自己提供 ID。
+> **Tip**: 所有 `--json` 命令统一错误格式 `{ success: false, error: "..." }`，检查 `success` 判断成败。
 
 商品管理专家，指导 AI Agent 完成商品上架、下架、改价、挂售全流程。
 
 ## CRITICAL
 
-安装、统一错误格式见 **r2-shared** skill。认证登录见 **r2-auth** skill。
+命令执行规则见 **r2-shared** skill 的「执行规则」。安装、统一错误格式见 **r2-shared** skill。认证登录见 **r2-auth** skill。
 
 ## 上架路由决策
 
-用户说"上架商品"时，按以下规则选择上架方式：
+用户说"上架"时，按以下规则选择上架方式：
 
 | 条件 | 上架方式 | 流程 |
 |------|----------|------|
-| 商品**在选品库**中（用户没提供图片、类目等详细信息） | `goods up`（普通上架） | 店铺 → 仓库 → 选品商品 → 输入价格 → 提交 |
-| 用户**提供了图片**，或商品**不在选品库** | `goods hang-up`（挂售上架） | 上传图片 → AI 读图识别 → 类目/属性 → 提交 |
+| 用户明确说"选品上架"，或商品**在选品库**中 | `goods up`（普通上架） | 店铺 → 仓库 → 选品商品 → 输入价格 → 提交 |
+| 用户明确说"挂售"，或用户**提供了图片** | `goods hang-up`（挂售上架） | 上传图片 → AI 读图识别 → 类目/属性 → 提交 |
 
 **判断方法**：
-1. 用户只说"上架"没给细节 → 先查选品库（`goods list`），有商品就走 `goods up`，**选品库为空则自动走 `goods hang-up`，不需要再问用户**
-2. 用户提供了图片文件 → 直接走 `goods hang-up`，Agent 会用 Read 工具查看图片自动识别商品信息
-3. 不确定时 → 问用户："商品在选品库里吗？还是有图片需要挂售上架？"
+1. 用户**明确指定**了上架方式 → 直接走对应流程
+2. 用户提供了图片文件 → 直接走 `goods hang-up`，Agent 用 Read 工具查看图片自动识别商品信息
+3. 用户只说"上架"未指定方式 → **必须询问用户**："选品上架还是挂售上架？"
 
 ## 命令概览
 
-| 分类 | 命令 | 说明 |
-|------|------|------|
-| 查询 | `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 up --stock-goods-id <> --shop-id <> --price <> --json` | 普通上架（选品商品） |
-| | `r2-cli goods down --id <id> [--json]` | 下架商品 |
-| | `r2-cli goods price --id <id> --price <amount> [--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 <> --prop-id <> --key <> [--json]` | 品牌搜索 |
-| | `r2-cli goods hang-up upload-images --shop-id <> --files <> --json` | 上传图片 |
-| | `r2-cli goods hang-up submit --shop-id <> --title <> ... --json` | 提交挂售上架 |
+### 查询
 
----
-
-## 一、查询命令
-
-### 店铺（shops）
-
-```bash
-r2-cli goods shops --json
-```
-
-返回字段：
-
-| 字段 | 说明 |
-|------|------|
-| `shopId` | 第三方店铺 ID（**上架参数取这个，不是 `id`**） |
-| `shopName` | 店铺名称 |
-| `platform` | 平台（xianyu / douyin 等） |
-
-> `--json` 输出会自动过滤敏感字段（`accessToken`、`refreshExpireIn`），Agent 可直接展示。
-
-### 仓库（stocks）
-
-```bash
-r2-cli goods stocks --json
-```
-
-返回字段：`stockId`（仓库 ID）、`stockName`（仓库名称）
-
-### 选品商品（list）
-
-```bash
-# 按仓库过滤（推荐）
-r2-cli goods list --stock-id <stockId> --json
-
-# 按商品 ID 精确查询
-r2-cli goods list --stock-goods-id <id> --json
+| 命令 | 说明 | 详细文档 |
+|------|------|----------|
+| `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 list --stock-id <stockId> --page 2 --size 20 --json
-```
+### 上架/下架/改价/修改
 
-返回字段：
+| 命令 | 说明 | 详细文档 |
+|------|------|----------|
+| `r2-cli goods up --stock-goods-id <> --shop-id <> --price <> --json` | 普通上架（选品商品） | [r2-goods-listing](references/r2-goods-listing.md) |
+| `r2-cli goods down --id <id> [--json]` | 下架商品 | [r2-goods-listing](references/r2-goods-listing.md) |
+| `r2-cli goods price --id <id> --price <amount> [--json]` | 修改价格 | [r2-goods-listing](references/r2-goods-listing.md) |
+| `r2-cli goods edit --id <id> [--title ...] --json` | 修改商品信息 | [r2-goods-listing](references/r2-goods-listing.md) |
 
-| 字段 | 说明 |
-|------|------|
-| `stockGoodsId` | 库存商品 ID（**上架参数取这个**） |
-| `goodsName` | 商品名称 |
-| `brand` | 品牌 |
-| `size` | 尺码 |
-| `salePrice` | 建议售价 |
-| `cate1Name` / `cate2Name` / `cate3Name` | 分类 |
-
-### 上架列表（listing）
-
-```bash
-r2-cli goods listing --json
-r2-cli goods listing --status up --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              # 精确查询
-```
-
-过滤参数：`--id`、`--stock-goods-id`、`--shop-id`、`--stock-id`、`--status`（init/up/down/fail）、`--platform`
-
----
-
-## 二、上架/下架
-
-### Agent 上架 4 步流程
-
-**每一步 Agent 获取数据后，必须展示给用户让用户做选择。**
+### 选品上架 4 步流程
 
 1. `r2-cli goods shops --json` → 展示店铺 → 用户选择 `shopId`
 2. `r2-cli goods stocks --json` → 展示仓库 → 用户选择 `stockId`
-3. `r2-cli goods list --stock-id <stockId> --json` → 展示商品 → 用户选择 `stockGoodsId`
-4. `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` → 提交上架
-
-命令自动轮询上架进度（每 2 秒，最多 10 秒），返回：
-
-```json
-{
-  "success": true,
-  "data": {
-    "submit": { "...提交结果..." },
-    "listing": { "id": "上架记录ID", "status": "up", "goodsName": "...", "price": 299 }
-  }
-}
-```
+3. `r2-cli goods list --stock-id <id> --json` → 展示商品 → 用户选择 `stockGoodsId`
+4. `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` → 提交
 
-状态值：`init`（处理中）、`up`（已上架）、`down`（已下架）、`fail`（失败，查看 `errorMsg`）
+必填参数：`--stock-goods-id`、`--shop-id`（取 `shopId` 不是 `id`）、`--price`
 
-### 上架参数
+### 修改商品信息（edit）
 
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--stock-goods-id <id>` | 是 | 库存商品 ID（来自 `stockGoodsId`） |
-| `--shop-id <id>` | 是 | 第三方店铺 ID（来自 `shopId`，**不是 `id`**） |
-| `--price <amount>` | 是 | 上架价格 |
-| `--json` | 否 | JSON 输出（Agent 推荐） |
+修改已上架商品的标题、描述、品牌、类目、图片、属性等。
 
-> 缺少必填参数时返回 `{ "success": false, "error": "Agent 模式需要 --stock-goods-id, --shop-id, --price" }`，不会进入交互模式。
+**路由决策**：
 
-### 下架（down）
+| 用户意图 | 流程 |
+|----------|------|
+| 提供了图片文件 | 全自动：读图识别 → 上传图片 → 匹配类目/属性/品牌 → 展示变更 → 用户确认 → 提交 |
+| 指定了具体字段（如"改标题为X"） | 直接修改指定字段，不动图片 |
+| 说"修改/更新商品信息"但没给细节 | 提示：可以提供图片自动识别商品信息，也可以指定要修改的具体字段 |
 
-**Agent 必须先向用户确认后再执行下架。**
+**定位商品**：优先使用 `--id <goodsListingId>`（从上架列表获取 `id` 字段），也可用 `--stock-goods-id <id> --account <shopId>`。
 
-```bash
-# 方式 1：上架记录 ID
-r2-cli goods down --id <goodsListingId> --json
+**关键约束**：
+- `--category-id` 和 `--channel-cat-id` 是**必填的**（后端复用挂售 DTO），即使不改类目也要传当前类目
+- Agent 应自动查询类目并匹配，不需要用户手动提供
+- AI 读图识别后填充的字段需展示给用户确认，不能静默覆盖已有信息
+- `--image-ids` 接受已上传的图片 ID，用户给图片文件时需先调 `hang-up upload-images` 上传
 
-# 方式 2：库存商品 ID + 店铺 ID
-r2-cli goods down --stock-goods-id <id> --shop-id <id> --json
-```
+**带图片的全自动流程**（Agent 自动完成，用户只需提供图片并确认）：
 
-### 改价（price）
+1. **展示列表**：`goods listing --json` → 用户选择要修改的商品
+2. **上传图片**：`hang-up upload-images --shop-id <shopId> --files <paths> --json`
+3. **AI 读图识别**：Agent 用 Read 工具查看图片，识别品牌/类目/成色/描述等
+4. **自动匹配类目**：`hang-up categories --json` → 根据识别结果匹配 catId + channelCatId
+5. **自动查询属性**：`hang-up props --channel-cat-id <id> --json` → 根据识别结果匹配成色/尺码/季节等
+6. **自动搜索品牌**：`hang-up brands --channel-cat-id <> --prop-id <> --key <品牌名> --json` → 获取品牌 valueId
+7. **汇总展示**：当前值 vs 变更值，让用户确认
+8. **提交**：`goods edit --id <goodsListingId> --category-id <> --channel-cat-id <> --image-ids <> --item-attrs <> --brand-name <> --json`
 
-**Agent 必须先询问用户新价格，不能自行决定。**
+**核心原则**：用户只需提供图片 + 确认。类目匹配、属性填充、品牌搜索全部由 Agent 自动完成。
 
-```bash
-# 方式 1：上架记录 ID
-r2-cli goods price --id <goodsListingId> --price <新价格> --json
-
-# 方式 2：库存商品 ID + 店铺 ID
-r2-cli goods price --stock-goods-id <id> --shop-id <id> --price <新价格> --json
-```
-
----
+### 挂售（hang-up）
 
-## 三、闲鱼挂售（hang-up）
+| 命令 | 说明 | 详细文档 |
+|------|------|----------|
+| `r2-cli goods hang-up categories [--json]` | 获取闲鱼类目 | [r2-goods-hangup](references/r2-goods-hangup.md) |
+| `r2-cli goods hang-up props --channel-cat-id <id> [--json]` | 获取属性列表 | [r2-goods-hangup](references/r2-goods-hangup.md) |
+| `r2-cli goods hang-up brands --channel-cat-id <> --prop-id <> --key <> [--json]` | 品牌搜索 | [r2-goods-hangup](references/r2-goods-hangup.md) |
+| `r2-cli goods hang-up upload-images --shop-id <> --files <> --json` | 上传图片 | [r2-goods-hangup](references/r2-goods-hangup.md) |
+| `r2-cli goods hang-up submit --shop-id <> --title <> ... --json` | 提交挂售上架 | [r2-goods-hangup](references/r2-goods-hangup.md) |
 
-挂售模式支持完整商品信息：图片、类目、属性等。与普通上架（`goods up`）是不同流程。
+### 挂售上架流程
 
-**核心理念**：先上传图片，Agent 尝试识别图片内容自动填充商品信息；无法识别时向用户询问。
+1. **上传图片**：`hang-up upload-images --shop-id <> --files <paths> --json`
+2. **识别商品**：Agent 用 Read 工具查看图片，自动识别品牌/成色/类目/描述。不支持读图的 Agent 走询问路径
+3. **匹配类目**：`hang-up categories --json` → 自动匹配
+4. **匹配属性**：`hang-up props --channel-cat-id <id> --json` → 自动填充。品牌需调 `hang-up brands` 搜索
+5. **汇总展示**：自动填充的字段标 ✅，缺失字段标 ❓ 让用户补充
+6. **提交**：`hang-up submit` — 必填：`shop-id`、`title`、`price`、`category-id`、`channel-cat-id`、`image-ids`、`stuff-status`、`desc`、`out-item-no`
 
-### Agent 挂售流程
+**核心原则**：**图片里能看到的，就别问用户**。只问价格和商家编码，其他全部从图片自动提取。
 
-**核心原则**：
-- 缺少的必填信息（价格、商家编码）**在流程中尽早询问**，不要积攒到最后
-- Agent 自动识别图片、匹配类目/属性、构建参数，**直接提交**，不需要用户确认
-- 提交成功后展示上架结果（商品信息摘要），让用户知道上架了什么
-- `item-attrs` 中 `propId` 和 `valueId` 是不同的值，构建时从 props 返回数据中取准确值
+**关键注意事项**：
+- **品牌必须双传**：`--brand-name` + itemAttrs 中的一项（含 propId/valueId/valueName），缺一不可
+- **描述自动生成**：品牌+款式+颜色+材质+货号自动组合，不要标记为"需要补充"
+- **季节自动推断**：夹克→春秋季，羽绒服→秋冬季，T恤→夏季等，不需要问用户
+- **尺码/货号从标签读取**：图片中有标签时自动提取，读不到才问用户
+- **标题自动组合**：品牌+款式+颜色+尺码+成色
 
-**图片识别降级策略**：
-
-| Agent 能力 | 处理方式 |
-|------------|----------|
-| 能查看图片（多模态） | 用 Read 工具读图 → 自动识别品牌/成色/类目/描述 |
-| 不能查看图片 | 跳过识别 → 向用户询问品牌、类目、成色、描述等信息 |
-
-> 不同 Agent 能力不同（Claude Code / Gemini 支持读图，部分 Agent 不支持）。Agent 应自行判断是否能识别图片，不能则直接走询问路径。两条路径最终都走相同的 submit 提交。
-
-#### 第 1 步：上传图片 + 识别商品信息（并行）
-
-**上传图片**：
-
-```bash
-r2-cli goods hang-up upload-images --shop-id <shopId> --files /path/img1.jpg,/path/img2.jpg --json
-```
-
-返回：
-
-```json
-{
-  "success": true,
-  "images": [
-    { "value": "1086608743767730915" },
-    { "value": "1086608743823622409" }
-  ]
-}
-```
-
-> 图片路径是用户本地文件路径。`--image-ids` 保持字符串，不要转数字（19 位 ID 会精度丢失）。
-
-**同时尝试识别图片**：如果 Agent 支持多模态（如 Claude Code、Gemini），用 Read 工具查看用户图片文件，识别以下信息。不支持则跳过，改为向用户询问。
-
-> **多图不一致处理**：如果多张图片显示不同商品（如不同款式、不同品牌），Agent 应识别后告知用户，只保留同一商品的图片。不要把不同商品混在一起提交。
-
-| 识别内容 | 提取信息 | 用途 |
-|----------|----------|------|
-| 商品类型 | 鞋/包/衣服/配饰/数码等 | 匹配闲鱼类目 |
-| 品牌 Logo/标签 | Nike/Gucci/LV 等 | `--brand-name` + brands 搜索 |
-| 成色状态 | 全新/轻微使用/明显磨损 | `--stuff-status` |
-| 颜色 | 白色/黑色/彩色等 | item-attrs 属性 |
-| 款式/材质 | 低帮鞋/皮质/帆布等 | item-attrs 属性 |
-| 尺码标签 | 42/EU40/M 等 | `--size` |
-| 综合信息 | — | 生成 `--title` 和 `--desc` |
-
-**识别后自动生成**：
-- `--title`：根据品牌+品类+关键特征生成简洁标题（如 "Nike Air Force 1 白色 42码 95新"）
-- `--desc`：综合图片信息生成商品描述
-
-**成色判断映射**：
-
-| 图片中商品状态 | `--stuff-status` 值 |
-|----------------|---------------------|
-| 带吊牌/未拆封 | `100`（全新） |
-| 几乎无使用痕迹 | `-1`（准新）或 `99`（99新） |
-| 轻微使用痕迹 | `95`（95新） |
-| 明显使用痕迹 | `90`（9新） |
-
-**如果用户没提供价格和商家编码，此时询问**（不要留到最后）。
-
-#### 第 2 步：匹配类目 + 属性（串行）
-
-**获取类目并自动匹配**：
-
-```bash
-r2-cli goods hang-up categories --json
-```
-
-Agent 根据图片识别结果自动匹配类目。常见匹配：
-
-| 识别结果 | 推荐匹配 |
-|----------|----------|
-| 运动鞋/板鞋 | 鞋靴 → 男鞋/女鞋 → 低帮鞋 |
-| 手提包/斜挎包 | 箱包 → 女士包/男士包 |
-| T恤/卫衣/外套 | 服装 → 男装/女装 |
-| 手表 | 腕表/饰品 |
-
-**获取属性并自动匹配**：
-
-```bash
-r2-cli goods hang-up props --channel-cat-id <channelCatId> --json
-```
-
-> props 响应可能很大（几十 KB），Agent 应直接搜索关键属性名，用 Grep 提取 propId 和匹配的 valueId/valueName。
-
-**属性匹配优先级**（按重要性排序）：
-
-| 优先级 | 属性 | 说明 |
-|--------|------|------|
-| 1 | 品牌 | 用 brands 搜索确认，**必须精确匹配，忽略近似名称** |
-| 2 | 款式 | 运动鞋/休闲鞋/皮鞋等，从识别结果匹配 |
-| 3 | 鞋码/尺码 | 42/43/M/L 等，从用户输入或图片识别 |
-| 4 | 成色 | 全新/几乎全新/轻微穿着痕迹/明显穿着痕迹 |
-| 5 | 其他 | 颜色、材质等，能匹配则填，不能则跳过 |
-
-**品牌精确匹配规则**：
-- brands 搜索会返回近似名称（如搜 Nike 会返回 BACHNIKE、NIKE 7 等），Agent 必须选择**完全匹配**的官方品牌名称
-- 例如搜 "Nike" → 只选 `Nike/耐克`，忽略 `BACHNIKE`、`NIKE 7/妮刻柒号` 等
-
-```bash
-r2-cli goods hang-up brands --channel-cat-id <id> --prop-id <品牌propId> --key "Nike" --json
-```
-
-最终构建 `--item-attrs`（**注意 propId 和 valueId 是不同字段**）：
-
-```json
-[
-  { "propId": "1d6d7611...", "valueId": "af8266ea...", "valueName": "运动鞋" },
-  { "propId": "30dc3038...", "valueId": "d64b3e52...", "valueName": "42" }
-]
-```
-
-#### 第 3 步：提交挂售
-
-**所有参数就绪后直接提交，不需要用户确认**：
-
-```bash
-r2-cli goods hang-up submit \
-  --shop-id <shopId> \
-  --title "商品标题" \
-  --price 599 \
-  --category-id <catId> \
-  --channel-cat-id <channelCatId> \
-  --image-ids "id1,id2" \
-  --stuff-status 95 \
-  --desc "商品描述" \
-  --out-item-no "商家编码" \
-  --brand-name "Nike" \
-  --size "42" \
-  --item-attrs '[{"propId":"xx","valueId":"yy","valueName":"Nike"}]' \
-  --json
-```
-
-成功返回：
-
-```json
-{ "success": true, "data": "上架成功" }
-```
-
-**提交后展示上架结果摘要**（让用户知道上架了什么）：
-
-```
-上架成功！
-- 标题：Nike 低帮运动鞋 白色 42码
-- 价格：¥99999
-- 品牌：Nike/耐克
-- 类目：男士鞋靴 → 低帮鞋
-- 成色：全新
-- 店铺：xxx
-```
-
-### 必填字段处理
-
-缺少时**在流程中尽早询问用户**，不要等所有信息都收集完再问：
-
-| 缺失字段 | 何时询问 | 询问方式 |
-|----------|----------|----------|
-| `--price`（售价） | 上传图片时 | "这个商品上架价格是多少？" |
-| `--out-item-no`（商家编码） | 上传图片时 | "商家编码是什么？（同店铺唯一标识）" |
-| `--shop-id`（店铺） | 流程开始时 | 展示店铺列表让用户选择 |
-| `--title`（标题） | 图片识别无法生成时 | "商品标题用什么？" |
-| `--desc`（描述） | 图片识别无法生成时 | "商品描述？" |
-
-### 必填参数
-
-| 参数 | 说明 |
-|------|------|
-| `--shop-id <id>` | 店铺 ID（即闲鱼用户名 account） |
-| `--title <title>` | 商品标题 |
-| `--price <amount>` | 售价 |
-| `--category-id <id>` | 大分类 ID（从 categories 获取） |
-| `--channel-cat-id <id>` | 小分类 ID（从 categories 获取） |
-| `--image-ids <ids>` | 图片 ID 列表，逗号分隔（保持字符串） |
-| `--stuff-status <n>` | 成色等级 |
-| `--desc <desc>` | 商品描述 |
-| `--out-item-no <no>` | 商家编码（同店铺唯一，用户自定义） |
-
-### 成色等级
-
-| 值 | 含义 |
-|----|------|
-| `100` | 全新 |
-| `-1` | 准新 |
-| `99` | 99新 |
-| `95` | 95新 |
-| `90` | 9新 |
-
-### 可选参数
-
-| 参数 | 默认值 | 说明 |
-|------|--------|------|
-| `--brand-name <name>` | — | 品牌名称 |
-| `--size <size>` | — | 尺码 |
-| `--goods-no <no>` | — | 货号 |
-| `--original-price <amount>` | — | 原价 |
-| `--trade-type <n>` | `0` | 交易方式：0 仅在线 / 1 仅线下 / 2 线上或线下 |
-| `--transport-fee <amount>` | `0` | 运费（0 = 包邮） |
-| `--division-id <id>` | `330100` | 行政区划 ID（市级，默认杭州） |
-| `--item-attrs <json>` | — | 商品属性列表 JSON（来自 props/brands） |
-| `--yhb` | `false` | 是否开启验货宝 |
-
-> 内部默认值：`itemBizType=2`（普通商品）、`spBizType="16"`（奢品）
-
----
+> Agent 执行具体操作时，用 Read 工具读取对应的 reference 文件获取完整参数和流程说明。
 
 ## 错误处理
 
@@ -411,7 +139,9 @@ r2-cli goods hang-up submit \
 | `Agent 模式需要 --stock-goods-id, --shop-id, --price` | `goods up --json` 缺少必填参数 | 补齐三个参数 |
 | `请指定下架条件：--id 或 --stock-goods-id + --shop-id` | 下架缺少定位参数 | 补充参数 |
 | `--price <amount> 为必填参数` | 改价未提供价格 | 询问用户新价格 |
-| `请提供至少一张图片` | upload-images 无图片 | 提供本地图片路径 |
-| `请填写有效的商品叶子类目` | category-id 或 channel-cat-id 错误 | 重新查询 categories |
-| `找不到传入的某些图片` | 图片 ID 无效或过期 | 重新上传图片 |
+| `请提供至少一张图片` | 挂售缺少图片 | 提供本地图片路径 |
+| `商品不存在` | edit 用了无效的 `--id` 或商品已被删除 | 确认 listing 列表中的 id 值 |
+| `getCategoryId() is null` | edit 缺少 `--category-id` | 必须传 `--category-id` 和 `--channel-cat-id` |
+| `商家编码重复` | out-item-no 同店铺已存在 | 更换唯一编码 |
+| `ITEM_CONDITION_NOT_SUPPORT_SIGN` | 售后服务未开通或品类不支持 | 默认关闭售后 |
 | `轮询超时` | 上架结果查询超时 | 稍后用 `goods listing` 查看 |