@puyinkai/xiaobao-cli 0.1.8 → 0.1.10

package/skills/wangxiaobao-quick-qa/SKILL.md

@@ -17,7 +17,7 @@ metadata:
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录 / 过期就调 `xiaobao-cli auth login`
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录 / 过期就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）
 - **必须有激活项目**：命令内部自动从激活项目状态读 tenant/project，
   调用方**不要传** tenant/project 参数。如果 命令 返回
   `error: 'NO_ACTIVE_PROJECT'`，让用户跑 `wangxiaobao-switch-project` skill
@@ -178,7 +178,7 @@ xiaobao-cli qa "评估一下客户 12345 的成交概率，相关录音 audioId:
 
 - **`error: 'NO_ACTIVE_PROJECT'`** — 还没设过激活项目 → 跑
   `wangxiaobao-switch-project` skill 后重试
-- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登，重试一次
+- **401 / token 过期** — 走 `auth login --no-wait --force` split-flow 重登，重试一次
 - **响应耗时 > 30 分钟** — 后端慢到打满 CLI timeout → 告诉用户"上游慢，稍后重试"
 - **answer 为空** — 上游这一轮没产出最终文本 → 让用户换个 prompt 重试
 - **用户想"批量出报告"** — 拦住：本期 CLI 没有报告生成 skill，

package/skills/wangxiaobao-shared/SKILL.md

@@ -53,13 +53,15 @@ xiaobao-cli customer list --portrait 高意向
 # 步骤 A：发起，立即返回（约 0.5s），拿到 verification_uri
 xiaobao-cli auth login --no-wait
 # stdout: { "awaiting_authorization": true, "verification_uri": "...",
+#           "verification_link": "[点击完成旺小宝登录授权](https://...)",
 #           "user_code": "...", "expires_in": 300, "interval": 5, ... }
 # device_code 不在 stdout —— 已安全存到 ~/.xiaobao/pending-auth.json（0600）
 ```
 
-agent 拿到后：把 `verification_uri` **原样**发给用户（放进只含 URL 的代码块，
-不要改写不要做 URL 编码），让用户浏览器打开授权，然后**结束本轮**，把控制权
-交还用户。
+agent 拿到后：把 stdout 里的 `verification_link` 字段**原样**发给用户 —— 它
+已经是 markdown 可点击链接 `[点击完成旺小宝登录授权](https://...)`，直接粘进
+回复正文（**不要**放进代码块 —— 代码块里链接不可点击），用户点一下即可在浏览器
+打开授权。**不要**改写链接、不要做 URL 编码。发完**结束本轮**，把控制权交还用户。
 
 ```bash
 # 步骤 B：用户回复"授权完成"后，直接换 token（秒级）——
@@ -118,12 +120,12 @@ Agent 消费时**只 parse stdout JSON**，stderr 是辅助。
 
 ### 常见错误码
 
-| code | 触发场景 | hint 内 actionable 命令 |
-| --- | --- | --- |
-| `NOT_AUTHENTICATED` | 未登录 / token 过期且 refresh_token 也失效 | `xiaobao-cli auth login` |
-| `NO_ACTIVE_PROJECT` | 没设激活项目就跑了需要 tenant/project 的命令 | `xiaobao-cli project list` + `xiaobao-cli project use ...` |
+| code | 触发场景 | hint 内 actionable 命令                                          |
+| --- | --- |---------------------------------------------------------------|
+| `NOT_AUTHENTICATED` | 未登录 / token 过期且 refresh_token 也失效 | `xiaobao-cli auth login --no-wait`（split-flow，见上方登录段） |
+| `NO_ACTIVE_PROJECT` | 没设激活项目就跑了需要 tenant/project 的命令 | `xiaobao-cli project list` + `xiaobao-cli project use ...`    |
 | `API_ERROR` | 上游 ai-open / saas API 返非 2xx | 看 `details.status` 和 `details.body`，可能 token scope 不够 / 上游临时挂 |
-| `BAD_METHOD` | `api` 命令传错 HTTP method | 用 GET / POST / PUT / PATCH / DELETE |
+| `BAD_METHOD` | `api` 命令传错 HTTP method | 用 GET / POST / PUT / PATCH / DELETE                           |
 
 遇到 `NOT_AUTHENTICATED` 或 `NO_ACTIVE_PROJECT` 时**立即按 hint 走**，不要追问用户。
 

package/skills/wangxiaobao-switch-project/SKILL.md

@@ -17,7 +17,7 @@ metadata:
 
 ## 执行前必读
 
-- 必须先通过 `xiaobao-cli auth login` 完成 OAuth 登录；token 没拿到时本 skill 不能继续
+- 必须先走 `auth login --no-wait` split-flow 完成 OAuth 登录（见 wangxiaobao-shared）；token 没拿到时本 skill 不能继续
 - **不要**自己 fs.writeFile 写 `.env` 或任何文件——状态落地走
   `xiaobao-cli project use`，由 CLI 统一管理权限和路径
 - 多个项目时**必须让用户挑**，绝对不要自动选择第一个；只有一个项目时才可以自动选
@@ -58,7 +58,7 @@ metadata:
   或不带 keyword 看全量；**不要**直接说"没有项目"
 - **没带 `--keyword`** → 账号确实没有可访问的项目，结束
 
-如果 命令 报错（401 / token 过期等），先调 `xiaobao-cli auth login --force` 重新登录，再重试一次。
+如果 命令 报错（401 / token 过期等），先走 `auth login --no-wait --force` split-flow 重新登录，再重试一次。
 
 ### 第 2 步：展示并让用户选
 
@@ -146,7 +146,7 @@ tenant/project + `updatedAt`。如果用户问"现在是哪个项目""当前激
 
 | 错误现象 | 根本原因 | 解决方案 |
 |---|---|---|
-| `xiaobao-cli project list` 返回 401 / token 过期 | 没登录或 refresh 失败 | 调 `xiaobao-cli auth login --force` 重新走 device flow |
+| `xiaobao-cli project list` 返回 401 / token 过期 | 没登录或 refresh 失败 | 走 `auth login --no-wait --force` split-flow 重登 |
 | `count == 0`（没带 keyword） | 账号无任何租户/项目权限 | 让用户找管理员加权限，本 skill 不继续 |
 | `count == 0`（带了 keyword） | 关键字没匹配到任何项目 | 换更短关键字 / 不带 keyword 看全量，别直接说"没项目" |
 | 用户输入的编号超出范围 | 选错了 | 重新提示当前可选编号区间 |

package/skills/wangxiaobao-visit-query/SKILL.md

@@ -16,7 +16,7 @@ metadata:
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就 `xiaobao-cli auth login`
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）
 - **必须有激活项目**：命令内部自动读，缺失返回 `NO_ACTIVE_PROJECT`
 - **数据权限隔离**：跟客户接口一样，按当前用户授权可见顾问范围过滤
 - LocalDateTime 格式：`yyyy-MM-dd HH:mm:ss`（空格分隔），CLI 自动转
@@ -194,7 +194,7 @@ xiaobao-cli visit list --customer-id 1685535452481236993 --page 1 --size 5
 ## 常见错误与排查
 
 - **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
-- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登
+- **401 / token 过期** — 走 `auth login --no-wait --force` split-flow 重登
 - **`total: 0`** — 时间窗内确实没数据，或当前用户授权范围内没有匹配的接待顾问
 - **customerName 模糊但没匹到** — 客户名拼写差异（"李女士" vs "李小姐"）；
   改用 `xiaobao-cli customer list` 反查精确 customerId