R2 Auth

R2-Auth (v1.1)

扫码登录 + 第三方平台授权（闲鱼/淘宝），专为 AI Agent 设计。

前置：先读取 r2-shared skill（执行规则、版本检查、错误格式、Token 恢复）。

扫码登录（auth login）

一步式（推荐）

r2-cli auth login --json

命令自动轮询，不需要手动调用 auth login poll。依次输出两段 JSON：

第 1 段：QR 信息（立即输出）

{
  "qrToken": "xxx",
  "expireTimeMs": 300000,
  "qrUrl": "http://127.0.0.1:52173/login/"
}

第 2 段：登录结果（用户扫码确认后输出）

{ "success": true, "userInfo": { "nickname": "...", "mobile": "..." } }

Agent 操作步骤

1. 启动 r2-cli auth login --json（设置 5 分钟超时）

2. 读取输出，获取第 1 段 JSON

3. 必须先将 qrUrl 醒目展示给用户：

   请在浏览器中打开此链接扫码登录：http://127.0.0.1:PORT/login/
   

4. 不要关闭/中断命令 — 正在自动轮询

5. 告知用户用第二回合 APP / 微信 / 支付宝扫描页面上的二维码

6. 等待第 2 段 JSON（最长 5 分钟）

7. 检查 success 判断结果

为什么必须先展示链接：浏览器自动打开在 Windows/远程/SSH 环境经常失败，qrUrl 是用户扫码的唯一保障。

第三方平台授权（auth platform）

授权第三方店铺，流程与登录类似：

r2-cli auth platform --name xianyu --json    # 闲鱼
r2-cli auth platform --name taobao --json    # 淘宝

第 1 段：{ "state": "xxx", "qrUrl": "http://127.0.0.1:PORT/login-xianyu/", "expireTimeMs": 300000 }

第 2 段：{ "success": true, "shopId": "...", "shopName": "..." }

Agent 操作步骤与登录相同：启动 → 获取 QR → 先展示 qrUrl → 不中断，等待结果。

什么时候需要授权：使用某平台命令时返回"没有已授权的店铺"，需先执行对应平台授权。

其他命令

错误处理

统一错误格式和常见错误恢复见 r2-shared skill。

401 自动刷新：CLI 收到 401 时会自动用本地 refreshToken 调 /user/refresh 换新 token 并透明重试，Agent 通常无感知。只有当命令最终返回 登录已过期 / 请重新登录 时（即 refreshToken 也失效），才需要引导用户重新扫码登录。