@round2ai/r2-cli 1.0.13-beta.0 → 1.0.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -15
- package/dist/README.md +1 -15
- package/dist/r2-cli.js +46 -2162
- package/package.json +1 -1
- package/skills/r2-goods/SKILL.md +10 -42
- package/skills/r2-shared/SKILL.md +0 -2
package/package.json
CHANGED
package/skills/r2-goods/SKILL.md
CHANGED
|
@@ -48,14 +48,15 @@ metadata:
|
|
|
48
48
|
| `r2-cli goods list [--stock-id <id>] [--json]` | 查看选品商品 | [r2-goods-query](references/r2-goods-query.md) |
|
|
49
49
|
| `r2-cli goods listing [--status <up/down/sold>] [--json]` | 查询上架列表 | [r2-goods-query](references/r2-goods-query.md) |
|
|
50
50
|
|
|
51
|
-
###
|
|
51
|
+
### 上架/下架/改价
|
|
52
52
|
|
|
53
53
|
| 命令 | 说明 | 详细文档 |
|
|
54
54
|
|------|------|----------|
|
|
55
55
|
| `r2-cli goods up --stock-goods-id <> --shop-id <> --price <> --json` | 普通上架(选品商品) | [r2-goods-listing](references/r2-goods-listing.md) |
|
|
56
56
|
| `r2-cli goods down --id <id> [--json]` | 下架商品 | [r2-goods-listing](references/r2-goods-listing.md) |
|
|
57
57
|
| `r2-cli goods price --id <id> --price <amount> [--json]` | 修改价格 | [r2-goods-listing](references/r2-goods-listing.md) |
|
|
58
|
-
|
|
58
|
+
|
|
59
|
+
> **暂未开放**:`goods edit`(修改商品信息)接口尚未发布正式版,暂时不可用。
|
|
59
60
|
|
|
60
61
|
### 选品上架 4 步流程
|
|
61
62
|
|
|
@@ -66,39 +67,6 @@ metadata:
|
|
|
66
67
|
|
|
67
68
|
必填参数:`--stock-goods-id`、`--shop-id`(取 `shopId` 不是 `id`)、`--price`
|
|
68
69
|
|
|
69
|
-
### 修改商品信息(edit)
|
|
70
|
-
|
|
71
|
-
修改已上架商品的标题、描述、品牌、类目、图片、属性等。
|
|
72
|
-
|
|
73
|
-
**路由决策**:
|
|
74
|
-
|
|
75
|
-
| 用户意图 | 流程 |
|
|
76
|
-
|----------|------|
|
|
77
|
-
| 提供了图片文件 | 全自动:读图识别 → 上传图片 → 匹配类目/属性/品牌 → 展示变更 → 用户确认 → 提交 |
|
|
78
|
-
| 指定了具体字段(如"改标题为X") | 直接修改指定字段,不动图片 |
|
|
79
|
-
| 说"修改/更新商品信息"但没给细节 | 提示:可以提供图片自动识别商品信息,也可以指定要修改的具体字段 |
|
|
80
|
-
|
|
81
|
-
**定位商品**:优先使用 `--id <goodsListingId>`(从上架列表获取 `id` 字段),也可用 `--stock-goods-id <id> --account <shopId>`。
|
|
82
|
-
|
|
83
|
-
**关键约束**:
|
|
84
|
-
- `--category-id` 和 `--channel-cat-id` 是**必填的**(后端复用挂售 DTO),即使不改类目也要传当前类目
|
|
85
|
-
- Agent 应自动查询类目并匹配,不需要用户手动提供
|
|
86
|
-
- AI 读图识别后填充的字段需展示给用户确认,不能静默覆盖已有信息
|
|
87
|
-
- `--image-ids` 接受已上传的图片 ID,用户给图片文件时需先调 `hang-up upload-images` 上传
|
|
88
|
-
|
|
89
|
-
**带图片的全自动流程**(Agent 自动完成,用户只需提供图片并确认):
|
|
90
|
-
|
|
91
|
-
1. **展示列表**:`goods listing --json` → 用户选择要修改的商品
|
|
92
|
-
2. **上传图片**:`hang-up upload-images --shop-id <shopId> --files <paths> --json`
|
|
93
|
-
3. **AI 读图识别**:Agent 用 Read 工具查看图片,识别品牌/类目/成色/描述等
|
|
94
|
-
4. **自动匹配类目**:`hang-up categories --json` → 根据识别结果匹配 catId + channelCatId
|
|
95
|
-
5. **自动查询属性**:`hang-up props --channel-cat-id <id> --json` → 根据识别结果匹配成色/尺码/季节等
|
|
96
|
-
6. **自动搜索品牌**:`hang-up brands --channel-cat-id <> --prop-id <> --key <品牌名> --json` → 获取品牌 valueId
|
|
97
|
-
7. **汇总展示**:当前值 vs 变更值,让用户确认
|
|
98
|
-
8. **提交**:`goods edit --id <goodsListingId> --category-id <> --channel-cat-id <> --image-ids <> --item-attrs <> --brand-name <> --json`
|
|
99
|
-
|
|
100
|
-
**核心原则**:用户只需提供图片 + 确认。类目匹配、属性填充、品牌搜索全部由 Agent 自动完成。
|
|
101
|
-
|
|
102
70
|
### 挂售(hang-up)
|
|
103
71
|
|
|
104
72
|
| 命令 | 说明 | 详细文档 |
|
|
@@ -106,17 +74,17 @@ metadata:
|
|
|
106
74
|
| `r2-cli goods hang-up categories [--json]` | 获取闲鱼类目 | [r2-goods-hangup](references/r2-goods-hangup.md) |
|
|
107
75
|
| `r2-cli goods hang-up props --channel-cat-id <id> [--json]` | 获取属性列表 | [r2-goods-hangup](references/r2-goods-hangup.md) |
|
|
108
76
|
| `r2-cli goods hang-up brands --channel-cat-id <> --prop-id <> --key <> [--json]` | 品牌搜索 | [r2-goods-hangup](references/r2-goods-hangup.md) |
|
|
109
|
-
| `r2-cli goods hang-up upload-images --shop-id <> --files <> --json` | 上传图片 | [r2-goods-hangup](references/r2-goods-hangup.md) |
|
|
110
77
|
| `r2-cli goods hang-up submit --shop-id <> --title <> ... --json` | 提交挂售上架 | [r2-goods-hangup](references/r2-goods-hangup.md) |
|
|
111
78
|
|
|
79
|
+
> **暂未开放**:`hang-up upload-images`(上传图片)接口尚未发布正式版,暂时不可用。
|
|
80
|
+
|
|
112
81
|
### 挂售上架流程
|
|
113
82
|
|
|
114
|
-
1.
|
|
115
|
-
2.
|
|
116
|
-
3.
|
|
117
|
-
4.
|
|
118
|
-
5.
|
|
119
|
-
6. **提交**:`hang-up submit` — 必填:`shop-id`、`title`、`price`、`category-id`、`channel-cat-id`、`image-ids`、`stuff-status`、`desc`、`out-item-no`
|
|
83
|
+
1. **识别商品**:Agent 用 Read 工具查看图片,自动识别品牌/成色/类目/描述。不支持读图的 Agent 走询问路径
|
|
84
|
+
2. **匹配类目**:`hang-up categories --json` → 自动匹配
|
|
85
|
+
3. **匹配属性**:`hang-up props --channel-cat-id <id> --json` → 自动填充。品牌需调 `hang-up brands` 搜索
|
|
86
|
+
4. **汇总展示**:自动填充的字段标 ✅,缺失字段标 ❓ 让用户补充
|
|
87
|
+
5. **提交**:`hang-up submit` — 必填:`shop-id`、`title`、`price`、`category-id`、`channel-cat-id`、`image-ids`、`stuff-status`、`desc`、`out-item-no`
|
|
120
88
|
|
|
121
89
|
**核心原则**:**图片里能看到的,就别问用户**。只问价格和商家编码(优先用户自定义,不填则推荐自动生成),其他全部从图片自动提取。
|
|
122
90
|
|
|
@@ -71,11 +71,9 @@ npm install -g @round2ai/r2-cli@latest
|
|
|
71
71
|
| 上架 | `r2-cli goods up --stock-goods-id <> --shop-id <> --price <> --json` | 普通上架(选品商品) |
|
|
72
72
|
| | `r2-cli goods down --id <id> [--json]` | 下架商品 |
|
|
73
73
|
| | `r2-cli goods price --id <id> --price <amount> [--json]` | 修改价格 |
|
|
74
|
-
| 修改 | `r2-cli goods edit --id <> --category-id <> --channel-cat-id <> ... --json` | 修改商品信息(定位推荐 `--id`) |
|
|
75
74
|
| 挂售 | `r2-cli goods hang-up categories [--json]` | 获取闲鱼类目 |
|
|
76
75
|
| | `r2-cli goods hang-up props --channel-cat-id <id> [--json]` | 获取属性列表 |
|
|
77
76
|
| | `r2-cli goods hang-up brands --channel-cat-id <> --prop-id <> --key <> [--json]` | 品牌搜索 |
|
|
78
|
-
| | `r2-cli goods hang-up upload-images --shop-id <> --files <> --json` | 上传图片 |
|
|
79
77
|
| | `r2-cli goods hang-up submit --shop-id <> --title <> ... --json` | 提交挂售上架 |
|
|
80
78
|
|
|
81
79
|
## 其他命令
|