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

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.
Files changed (11) hide show
  1. package/README.md +24 -12
  2. package/dist/README.md +24 -12
  3. package/dist/r2-cli.js +46 -1757
  4. package/package.json +7 -3
  5. package/scripts/install-skills.js +35 -0
  6. package/skills/r2-auth/SKILL.md +31 -45
  7. package/skills/r2-goods/SKILL.md +309 -98
  8. package/skills/r2-shared/SKILL.md +94 -0
  9. package/dist/package.json +0 -60
  10. package/skills/r2-cli/SKILL.md +0 -70
  11. /package/skills/{r2-cli → r2-shared}/_meta.json +0 -0
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
 
6
6
  R2-CLI — 二手潮奢交易命令行工具，由 [Round2AI](https://github.com/Round2AI) 团队维护 — 让人类和 AI Agent 都能在终端中完成商品上架等交易操作。
7
7
 
8
- 覆盖商品上架、认证登录等核心业务域，提供 7 个商品命令及 3 个 AI Agent [Skills](./skills/)。
8
+ 覆盖商品上架、挂售、认证登录等核心业务域，提供 12 个命令及 3 个 AI Agent [Skills](./skills/)。
9
9
 
10
10
  [安装](#安装与快速开始) · [AI Agent 快速开始](#快速开始ai-agent) · [Agent Skills](#agent-skills) · [认证](#认证) · [命令](#命令参考) · [安全](#安全与风险提示)
11
11
 
@@ -22,6 +22,7 @@ R2-CLI — 二手潮奢交易命令行工具，由 [Round2AI](https://github.com
22
22
  |------|------|
23
23
  | 认证登录 | 扫码登录（第二回合 APP / 微信 / 支付宝）、闲鱼店铺授权、状态查询、登出（Agent 一步式流程） |
24
24
  | 商品管理 | 商品上架（4 步流程：获取店铺 → 获取仓库 → 获取选品商品 → 提交上架 + 自动轮询上架结果）、店铺查看、仓库查看、选品商品查看、上架列表查询、下架、改价 |
25
+ | 闲鱼挂售 | 完整商品信息模式：类目查询 → 属性/品牌选择 → 图片上传 → 提交挂售 |
25
26
 
26
27
  ---
27
28
 
@@ -114,9 +115,9 @@ npx skills add Round2AI/r2-cli --all -y
114
115
 
115
116
  | Skill | 说明 |
116
117
  |-------|------|
118
+ | `r2-shared` | 共享基础：安装、统一错误格式、命令概览 |
117
119
  | `r2-auth` | 认证登录：一步式扫码登录（生成二维码 + 自动轮询，支持第二回合 APP / 微信 / 支付宝）、闲鱼店铺授权、状态查询、登出 |
118
- | `r2-cli` | 命令概览：安装检测、认证命令、商品管理命令、命令前缀自动识别 |
119
- | `r2-goods` | 商品管理：4 步上架流程（获取数据 → 展示给用户 → 用户选择 → 提交上架 + 自动轮询结果）、下架、改价、店铺/仓库/商品/上架列表查看 |
120
+ | `r2-goods` | 商品管理：4 步上架流程、挂售流程（类目→属性→图片→提交）、下架、改价、店铺/仓库/商品/上架列表查看 |
120
121
 
121
122
  ---
122
123
 
@@ -139,7 +140,7 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
139
140
 
140
141
  ## 命令参考
141
142
 
142
- ### 商品管理
143
+ ### 商品查询
143
144
 
144
145
  | 命令 | 说明 |
145
146
  |------|------|
@@ -147,20 +148,31 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
147
148
  | `r2-cli goods stocks [--json]` | 查看所有仓库 |
148
149
  | `r2-cli goods list [--stock-id <id>] [--stock-goods-id <id>] [--json]` | 查看选品商品（可按仓库或商品 ID 过滤，支持 `--page` 和 `--size`） |
149
150
  | `r2-cli goods listing [--json]` | 查询上架列表（支持 `--id` / `--shop-id` / `--stock-goods-id` / `--stock-id` / `--status` / `--platform` 过滤） |
151
+
152
+ ### 商品上架/下架
153
+
154
+ | 命令 | 说明 |
155
+ |------|------|
150
156
  | `r2-cli goods up` | 交互式上架（自动轮询上架结果） |
151
157
  | `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` | Agent 直接上架（自动轮询上架结果） |
152
158
  | `r2-cli goods down --id <id> [--json]` | 下架商品（也可用 `--stock-goods-id <id> --shop-id <id>`） |
153
159
  | `r2-cli goods price --id <id> --price <amount> [--json]` | 修改上架价格（也可用 `--stock-goods-id <id> --shop-id <id>`） |
154
160
 
155
- ### 上架参数
161
+ ### 闲鱼挂售（完整商品信息模式）
162
+
163
+ 挂售模式支持完整的商品信息：图片、类目、属性、品牌等。流程：查询类目/属性 → 上传图片 → 提交挂售。
164
+
165
+ | 命令 | 说明 |
166
+ |------|------|
167
+ | `r2-cli goods hang-up categories [--json]` | 获取闲鱼类目列表（大分类 → 小分类） |
168
+ | `r2-cli goods hang-up props --channel-cat-id <id> [--json]` | 获取指定类目下的属性列表（含可选值） |
169
+ | `r2-cli goods hang-up brands --channel-cat-id <id> --prop-id <id> --key <keyword> [--json]` | 品牌搜索 |
170
+ | `r2-cli goods hang-up upload-images --shop-id <id> --files <paths> --json` | 批量上传图片到闲鱼（挂售前必须先上传） |
171
+ | `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` | 提交挂售上架 |
172
+
173
+ **挂售必填参数**：`--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`（商家编码，同店铺唯一）
156
174
 
157
- | 参数 | 必填 | 说明 |
158
- |------|------|------|
159
- | `--stock-goods-id <id>` | 是 | 库存商品 ID（来自选品商品列表的 `stockGoodsId` 字段） |
160
- | `--shop-id <id>` | 是 | 第三方店铺 ID（来自店铺列表的 `shopId` 字段，不是 `id`） |
161
- | `--price <amount>` | 是 | 上架价格（正数） |
162
- | `-p, --platform <platform>` | 否 | 平台，默认 xianyu |
163
- | `--json` | 否 | JSON 输出（Agent 推荐） |
175
+ **挂售可选参数**：`--brand-name`、`--size`、`--goods-no`、`--original-price`、`--item-attrs`（属性列表 JSON）、`--trade-type`（默认 0 仅在线）、`--transport-fee`（默认 0 包邮）、`--yhb`（验货宝）、`--division-id`（默认 330100 杭州）
164
176
 
165
177
  ### 其他命令
166
178
 
package/dist/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
 
6
6
  R2-CLI — 二手潮奢交易命令行工具，由 [Round2AI](https://github.com/Round2AI) 团队维护 — 让人类和 AI Agent 都能在终端中完成商品上架等交易操作。
7
7
 
8
- 覆盖商品上架、认证登录等核心业务域，提供 7 个商品命令及 3 个 AI Agent [Skills](./skills/)。
8
+ 覆盖商品上架、挂售、认证登录等核心业务域，提供 12 个命令及 3 个 AI Agent [Skills](./skills/)。
9
9
 
10
10
  [安装](#安装与快速开始) · [AI Agent 快速开始](#快速开始ai-agent) · [Agent Skills](#agent-skills) · [认证](#认证) · [命令](#命令参考) · [安全](#安全与风险提示)
11
11
 
@@ -22,6 +22,7 @@ R2-CLI — 二手潮奢交易命令行工具，由 [Round2AI](https://github.com
22
22
  |------|------|
23
23
  | 认证登录 | 扫码登录（第二回合 APP / 微信 / 支付宝）、闲鱼店铺授权、状态查询、登出（Agent 一步式流程） |
24
24
  | 商品管理 | 商品上架（4 步流程：获取店铺 → 获取仓库 → 获取选品商品 → 提交上架 + 自动轮询上架结果）、店铺查看、仓库查看、选品商品查看、上架列表查询、下架、改价 |
25
+ | 闲鱼挂售 | 完整商品信息模式：类目查询 → 属性/品牌选择 → 图片上传 → 提交挂售 |
25
26
 
26
27
  ---
27
28
 
@@ -114,9 +115,9 @@ npx skills add Round2AI/r2-cli --all -y
114
115
 
115
116
  | Skill | 说明 |
116
117
  |-------|------|
118
+ | `r2-shared` | 共享基础：安装、统一错误格式、命令概览 |
117
119
  | `r2-auth` | 认证登录：一步式扫码登录（生成二维码 + 自动轮询，支持第二回合 APP / 微信 / 支付宝）、闲鱼店铺授权、状态查询、登出 |
118
- | `r2-cli` | 命令概览：安装检测、认证命令、商品管理命令、命令前缀自动识别 |
119
- | `r2-goods` | 商品管理：4 步上架流程（获取数据 → 展示给用户 → 用户选择 → 提交上架 + 自动轮询结果）、下架、改价、店铺/仓库/商品/上架列表查看 |
120
+ | `r2-goods` | 商品管理：4 步上架流程、挂售流程（类目→属性→图片→提交）、下架、改价、店铺/仓库/商品/上架列表查看 |
120
121
 
121
122
  ---
122
123
 
@@ -139,7 +140,7 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
139
140
 
140
141
  ## 命令参考
141
142
 
142
- ### 商品管理
143
+ ### 商品查询
143
144
 
144
145
  | 命令 | 说明 |
145
146
  |------|------|
@@ -147,20 +148,31 @@ Token 存储在 `~/.r2-cli/config.json`（原子写入防丢失），过期后
147
148
  | `r2-cli goods stocks [--json]` | 查看所有仓库 |
148
149
  | `r2-cli goods list [--stock-id <id>] [--stock-goods-id <id>] [--json]` | 查看选品商品（可按仓库或商品 ID 过滤，支持 `--page` 和 `--size`） |
149
150
  | `r2-cli goods listing [--json]` | 查询上架列表（支持 `--id` / `--shop-id` / `--stock-goods-id` / `--stock-id` / `--status` / `--platform` 过滤） |
151
+
152
+ ### 商品上架/下架
153
+
154
+ | 命令 | 说明 |
155
+ |------|------|
150
156
  | `r2-cli goods up` | 交互式上架（自动轮询上架结果） |
151
157
  | `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` | Agent 直接上架（自动轮询上架结果） |
152
158
  | `r2-cli goods down --id <id> [--json]` | 下架商品（也可用 `--stock-goods-id <id> --shop-id <id>`） |
153
159
  | `r2-cli goods price --id <id> --price <amount> [--json]` | 修改上架价格（也可用 `--stock-goods-id <id> --shop-id <id>`） |
154
160
 
155
- ### 上架参数
161
+ ### 闲鱼挂售（完整商品信息模式）
162
+
163
+ 挂售模式支持完整的商品信息：图片、类目、属性、品牌等。流程：查询类目/属性 → 上传图片 → 提交挂售。
164
+
165
+ | 命令 | 说明 |
166
+ |------|------|
167
+ | `r2-cli goods hang-up categories [--json]` | 获取闲鱼类目列表（大分类 → 小分类） |
168
+ | `r2-cli goods hang-up props --channel-cat-id <id> [--json]` | 获取指定类目下的属性列表（含可选值） |
169
+ | `r2-cli goods hang-up brands --channel-cat-id <id> --prop-id <id> --key <keyword> [--json]` | 品牌搜索 |
170
+ | `r2-cli goods hang-up upload-images --shop-id <id> --files <paths> --json` | 批量上传图片到闲鱼（挂售前必须先上传） |
171
+ | `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` | 提交挂售上架 |
172
+
173
+ **挂售必填参数**：`--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`（商家编码，同店铺唯一）
156
174
 
157
- | 参数 | 必填 | 说明 |
158
- |------|------|------|
159
- | `--stock-goods-id <id>` | 是 | 库存商品 ID（来自选品商品列表的 `stockGoodsId` 字段） |
160
- | `--shop-id <id>` | 是 | 第三方店铺 ID（来自店铺列表的 `shopId` 字段，不是 `id`） |
161
- | `--price <amount>` | 是 | 上架价格（正数） |
162
- | `-p, --platform <platform>` | 否 | 平台，默认 xianyu |
163
- | `--json` | 否 | JSON 输出（Agent 推荐） |
175
+ **挂售可选参数**：`--brand-name`、`--size`、`--goods-no`、`--original-price`、`--item-attrs`（属性列表 JSON）、`--trade-type`（默认 0 仅在线）、`--transport-fee`（默认 0 包邮）、`--yhb`（验货宝）、`--division-id`（默认 330100 杭州）
164
176
 
165
177
  ### 其他命令
166
178