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

package/skills/r2-shared/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: r2-shared
+version: 1.0.0
+description: "R2-CLI 共享基础技能。安装、统一错误格式、命令概览。r2-auth 和 r2-goods 的前置依赖。触发词：r2-cli、安装、install、错误格式。"
+metadata:
+  requires:
+    bins: ["r2-cli"]
+  cliHelp: "r2-cli --help"
+  related:
+    - "r2-auth"
+    - "r2-goods"
+---
+
+# R2-Shared (v1)
+
+> **Tip**: 始终使用 `--json` 获取结构化输出。所有 `--json` 命令统一错误格式 `{ success: false, error: "..." }`，检查 `success` 判断成败。
+> **Tip**: Agent 获取数据后展示给用户选择，不要让用户自己提供 ID。
+
+二手潮奢交易命令行工具，由 Round2AI 团队维护。覆盖商品上架、认证登录等核心业务域。
+
+## CRITICAL
+
+本 skill 是 r2-auth 和 r2-goods 的共享基础。认证登录详情见 **r2-auth** skill，商品管理详情见 **r2-goods** skill。
+
+## 安装
+
+```bash
+npm install -g @round2ai/r2-cli@latest
+```
+
+## 前置条件
+
+- 先登录：`r2-cli auth login`（支持第二回合 APP / 微信 / 支付宝扫码）
+- 检查状态：`r2-cli auth status`
+
+## 认证命令（详见 r2-auth skill）
+
+| 命令 | 说明 |
+|------|------|
+| `r2-cli auth login --json` | 扫码登录（Agent 推荐，一步完成） |
+| `r2-cli auth xianyu --json` | 闲鱼店铺授权（Agent 推荐，一步完成） |
+| `r2-cli auth status` | 查看登录状态 |
+| `r2-cli auth logout` | 退出登录 |
+
+## 商品管理命令（详见 r2-goods skill）
+
+| 分类 | 命令 | 说明 |
+|------|------|------|
+| 查询 | `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` | 提交挂售上架 |
+
+## Agent 上架路由（概要）
+
+用户说"上架商品"时需要选择正确的方式：
+- **商品在选品库** → `goods up`（店铺 → 仓库 → 选品商品 → 提交价格）
+- **用户提供了图片** → `goods hang-up`（上传图片 → AI 读图识别 → 类目/属性 → 提交）
+- **不确定** → 问用户
+
+> 详细决策规则见 **r2-goods** skill「上架路由决策」章节。
+
+## Agent 上架 4 步流程（概要）
+
+1. `r2-cli goods shops --json` → 展示店铺 → 用户选择
+2. `r2-cli goods stocks --json` → 展示仓库 → 用户选择
+3. `r2-cli goods list --stock-id <id> --json` → 展示商品 → 用户选择
+4. `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` → 提交上架
+
+> 完整参数说明、挂售流程、错误处理见 **r2-goods** skill。
+
+## 统一错误格式
+
+所有 `--json` 命令统一错误格式：
+
+```json
+{ "success": false, "error": "错误信息" }
+```
+
+常见错误：
+
+| 错误信息 | 原因 | 解决方法 |
+|----------|------|----------|
+| `请先运行 r2-cli auth login 登录` | 未登录或 Token 过期 | 执行 `r2-cli auth login --json` |
+| `二维码已过期` / `授权链接已过期` | 扫码超时（5 分钟） | 重新执行命令 |
+| `轮询超时` | 上架结果查询超时 | 稍后用 `r2-cli goods listing` 查看 |

package/dist/package.json

@@ -1,61 +0,0 @@
-{
-  "name": "@round2ai/r2-cli",
-  "version": "1.0.10",
-  "description": "R2-CLI，向 AI 开放二手潮奢交易全链路能力",
-  "main": "dist/r2-cli.js",
-  "type": "module",
-  "bin": {
-    "r2-cli": "./dist/r2-cli.js"
-  },
-  "scripts": {
-    "postinstall": "node scripts/install-skills.js",
-    "build": "cross-env NODE_ENV=development node scripts/build.js",
-    "build:prod": "cross-env NODE_ENV=production node scripts/build.js",
-    "dev": "node scripts/dev.js"
-  },
-  "keywords": [
-    "round2ai",
-    "r2",
-    "r2-cli",
-    "cli",
-    "ai",
-    "fashion",
-    "luxury",
-    "second-hand"
-  ],
-  "files": [
-    "dist",
-    "scripts",
-    "skills",
-    "package.json",
-    "README.md"
-  ],
-  "author": "Round2AI - PURESNAKE Team",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Round2AI/r2-cli"
-  },
-  "dependencies": {
-    "@inquirer/prompts": "^8.4.2",
-    "chalk": "^5.3.0",
-    "commander": "^14.0.3",
-    "figlet": "^1.11.0",
-    "ink": "^7.0.0",
-    "ora": "^9.3.0",
-    "qrcode": "^1.5.4",
-    "react": "^19.2.5"
-  },
-  "devDependencies": {
-    "@types/node": "^25.5.2",
-    "@types/qrcode": "^1.5.6",
-    "@types/react": "^19.2.14",
-    "cross-env": "^10.1.0",
-    "dotenv": "^17.4.2",
-    "esbuild": "^0.28.0",
-    "typescript": "^6.0.2"
-  }
-}

package/scripts/build.js

@@ -1,176 +0,0 @@
-#!/usr/bin/env node
-/**
- * 构建脚本 - 使用 esbuild 打包
- */
-
-import esbuild from "esbuild";
-import fs from "node:fs/promises";
-import path from "path";
-import { fileURLToPath } from "url";
-import * as dotenv from "dotenv";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const rootDir = path.dirname(__dirname);
-
-const nodeEnv = process.env.NODE_ENV || "development";
-const isProd = nodeEnv === "production";
-const envFile = isProd ? ".env.production" : ".env";
-dotenv.config({ path: path.join(rootDir, envFile) });
-const serverBaseUrl = process.env.SERVER_BASEURL || "https://api.qiuxietang.com";
-
-// 入口点配置
-const entryPoints = {
-  "r2-cli": "src/entrypoints/r2-cli.tsx",
-};
-
-// esbuild 配置
-const esbuildConfig = {
-  bundle: true,
-  platform: "node",
-  format: "esm",
-  sourcemap: false,
-  minify: isProd,
-  external: [
-    "commander",
-    "chalk",
-    "figlet",
-    "@inquirer/prompts",
-    "@inquirer/core",
-    "@inquirer/input",
-    "@inquirer/select",
-    "@inquirer/confirm",
-    "@inquirer/checkbox",
-    "mute-stream",
-    "qrcode",
-    "ora",
-    "react",
-    "ink",
-    "react-dom",
-    "react-devtools-core",
-    "uuid",
-  ],
-  banner: {
-    js: '"use strict";',
-  },
-  define: {
-    "process.env.NODE_ENV": JSON.stringify(nodeEnv),
-    "process.env.SERVER_BASEURL": JSON.stringify(serverBaseUrl),
-  },
-  treeShaking: true,
-  splitting: false,
-};
-
-/**
- * 清理输出目录
- */
-async function cleanDist() {
-  const distDir = path.join(rootDir, "dist");
-  try {
-    await fs.rm(distDir, { recursive: true, force: true });
-  } catch (e) {
-    if (e.code === "EBUSY" || e.code === "EPERM") {
-      const files = await fs.readdir(distDir);
-      for (const file of files) {
-        await fs.rm(path.join(distDir, file), { recursive: true, force: true });
-      }
-    } else {
-      throw e;
-    }
-  }
-  await fs.mkdir(distDir, { recursive: true });
-  console.log("🧹 清理输出目录完成");
-}
-
-/**
- * 构建单个入口点
- */
-async function buildEntryPoint(name, entry) {
-  const outputDir = path.join(rootDir, "dist");
-  console.log(`🔨 构建 ${name} -> ${path.relative(rootDir, outputDir)}`);
-
-  const config = { ...esbuildConfig };
-  if (name === "r2-cli") {
-    config.banner = {
-      js: "#!/usr/bin/env node\n",
-    };
-  }
-
-  try {
-    await esbuild.build({
-      ...config,
-      entryPoints: [path.join(rootDir, entry)],
-      outdir: outputDir,
-      // 保持原始文件名，不加 outdir 的 hash 前缀
-      // outdir 会自动生成文件名，不需要 outfile
-    });
-    console.log(`✅ ${name} 构建成功`);
-  } catch (error) {
-    console.error(`❌ ${name} 构建失败:`, error.message);
-    throw error;
-  }
-}
-
-/**
- * 复制必要文件
- */
-async function copyFiles() {
-  const filesToCopy = ["package.json", "README.md"];
-
-  for (const file of filesToCopy) {
-    const src = path.join(rootDir, file);
-    const dest = path.join(rootDir, "dist", file);
-
-    try {
-      await fs.copyFile(src, dest);
-      console.log(`📄 已复制 ${file}`);
-    } catch {
-      // file doesn't exist, skip
-    }
-  }
-
-  // 复制 QR 页面 HTML 文件到 dist/pages/
-  const pagesDir = path.join(rootDir, "dist", "pages");
-  await fs.mkdir(pagesDir, { recursive: true });
-  const htmlSrcDir = path.join(rootDir, "src", "qr-server", "pages");
-  const htmlFiles = await fs.readdir(htmlSrcDir);
-  for (const file of htmlFiles) {
-    if (file.endsWith(".html")) {
-      await fs.copyFile(path.join(htmlSrcDir, file), path.join(pagesDir, file));
-      console.log(`📄 已复制 pages/${file}`);
-    }
-  }
-}
-
-/**
- * 构建项目
- */
-async function build() {
-  console.log("🚀 开始构建 R2-CLI...\n");
-
-  try {
-    // 1. 清理输出目录
-    await cleanDist();
-
-    // 2. 构建所有入口点
-    console.log("🔨 开始构建入口点...\n");
-    for (const [name, entry] of Object.entries(entryPoints)) {
-      await buildEntryPoint(name, entry);
-    }
-
-    // 3. 复制必要文件
-    await copyFiles();
-
-    console.log("\n✅ 构建完成！");
-    console.log("\n📦 输出文件:");
-    Object.keys(entryPoints).forEach((name) => {
-      console.log(`   • dist/${name}.js`);
-    });
-  } catch (error) {
-    console.error("❌ 构建失败:", error);
-    process.exit(1);
-  }
-}
-
-// 运行构建
-build();

package/scripts/dev.js

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-/**
- * 开发模式 - 直接运行源码
- */
-
-import { spawn } from 'child_process';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const rootDir = path.dirname(__dirname);
-
-const child = spawn('npx', ['tsx', 'src/entrypoints/r2-cli.tsx', ...process.argv.slice(2)], {
-  cwd: rootDir,
-  stdio: 'inherit',
-  shell: true,
-});
-
-child.on('exit', (code) => {
-  process.exit(code ?? 1);
-});

package/skills/r2-cli/SKILL.md

@@ -1,70 +0,0 @@
----
-name: r2-cli
-description: R2-CLI 二手潮奢交易 CLI 工具。用于认证登录、商品上架/下架/改价、查看店铺/仓库/选品商品/上架列表。Agent 获取数据后展示给用户选择，完成 4 步上架流程。触发词：r2-cli、登录、上架、下架、改价、商品、goods、auth、shops、stocks、listing。
----
-
-# R2-CLI Skill
-
-二手潮奢交易命令行工具，由 Round2AI 团队维护。覆盖商品上架、认证登录等核心业务域。
-
-## 安装
-
-```bash
-npm install -g @round2ai/r2-cli@latest
-```
-
-## 命令前缀自动检测
-
-首次使用时检测一次，后续所有命令使用检测到的前缀：
-
-1. 项目目录有 `package.json`（name 含 r2-cli）→ `npm run dev --`
-2. 存在 `dist/r2-cli.js` → `node dist/r2-cli.js`
-3. `r2-cli --version` 成功 → `r2-cli`
-
-> 部分平台 npm 会拦截 `--help` 等 flag，改用 `npx tsx src/entrypoints/r2-cli.tsx --help`。
-
-## 前置条件
-
-- 先登录：`r2-cli auth login`（支持第二回合 APP / 微信 / 支付宝扫码）
-- 检查状态：`r2-cli auth status`
-
-所有 `--json` 命令输出 `{ success: false, error: "..." }` 格式错误，检查 `success` 判断成败。
-
-## 认证命令
-
-| 命令 | 说明 |
-|------|------|
-| `r2-cli auth login` | 扫码登录（自动打开浏览器，人类使用） |
-| `r2-cli auth login --json` | 扫码登录（自动打开浏览器 + JSON 输出，Agent 推荐） |
-| `r2-cli auth login poll --token <>` | 手动轮询登录状态（备选方案，不推荐） |
-| `r2-cli auth xianyu` | 闲鱼店铺授权（自动打开浏览器，人类使用） |
-| `r2-cli auth xianyu --json` | 闲鱼店铺授权（自动打开浏览器 + JSON 输出，Agent 推荐） |
-| `r2-cli auth xianyu poll --state <>` | 手动轮询授权状态（备选方案，不推荐） |
-| `r2-cli auth status` | 查看登录状态 |
-| `r2-cli auth logout` | 退出登录 |
-
-> 认证登录的详细 Agent 操作流程见 **r2-auth** skill。
-
-## 商品管理命令
-
-| 命令 | 说明 |
-|------|------|
-| `r2-cli goods shops [--json]` | 查看所有已授权店铺（跨平台） |
-| `r2-cli goods stocks [--json]` | 查看所有仓库 |
-| `r2-cli goods list [--stock-id <id>] [--stock-goods-id <id>] [--json]` | 查看选品商品（两个过滤参数均为可选，支持 `--page` 和 `--size`） |
-| `r2-cli goods listing [--json]` | 查询上架列表（支持 `--id` / `--shop-id` / `--stock-goods-id` / `--stock-id` / `--status` / `--platform` 过滤） |
-| `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>`） |
-
-## Agent 上架 4 步流程
-
-**核心原则：Agent 获取数据后展示给用户选择，不要让用户自己提供 ID。**
-
-1. `r2-cli goods shops --json` → 展示店铺（`shopId`、`shopName`、`platform`）→ 用户选择
-2. `r2-cli goods stocks --json` → 展示仓库（`stockId`、`stockName`）→ 用户选择
-3. `r2-cli goods list --stock-id <id> --json` → 展示商品（`stockGoodsId`、`goodsName`、`brand`、`size`、`salePrice`）→ 用户选择（也可用 `--stock-goods-id <id>` 查询单个商品）
-4. `r2-cli goods up --stock-goods-id <id> --shop-id <id> --price <amount> --json` → 提交上架（自动轮询结果）
-
-> 完整流程、参数说明和注意事项见 **r2-goods** skill。