@puyinkai/xiaobao-cli 0.1.0 → 0.1.8

package/dist/{token-store-CHZ_rJQk.mjs → token-store-CXizLE2_.mjs}

@@ -1,6 +1,6 @@
 import { existsSync } from "node:fs";
-import { homedir } from "node:os";
 import { join } from "node:path";
+import { homedir } from "node:os";
 import { chmod, mkdir, readFile, unlink, writeFile } from "node:fs/promises";
 //#region src/core/token-store.ts
 /**
@@ -19,6 +19,7 @@ import { chmod, mkdir, readFile, unlink, writeFile } from "node:fs/promises";
 const PRIMARY_DIR = join(homedir(), ".xiaobao");
 const PRIMARY_TOKEN_FILE = join(PRIMARY_DIR, "token.json");
 const LEGACY_TOKEN_FILE = join(homedir(), ".openclaw", "state", "wangxiaobao", "token.json");
+const PENDING_AUTH_FILE = join(PRIMARY_DIR, "pending-auth.json");
 /**
 * Read order: primary → legacy fallback. Returns null if both missing.
 */
@@ -58,12 +59,16 @@ async function writeToken(resp) {
 	return tokenInfo;
 }
 /**
-* Only deletes the primary file. Legacy openclaw path is left intact so a
-* `xiaobao-cli auth logout` doesn't silently nuke the plugin's token.
+* Clears both the primary file AND the legacy openclaw fallback path. After
+* `xiaobao-cli auth logout` the user expects to be fully logged out across all
+* known token locations — leaving the legacy file behind would cause
+* `auth whoami` to read it back via fallback and report `logged_in: true`,
+* confusing users ("logout 没用"). The refresh_token is best-effort revoked
+* server-side before this call, so the legacy file is already a dead token.
 */
 async function clearToken() {
-	try {
-		await unlink(PRIMARY_TOKEN_FILE);
+	for (const f of [PRIMARY_TOKEN_FILE, LEGACY_TOKEN_FILE]) try {
+		await unlink(f);
 	} catch (e) {
 		if (e.code !== "ENOENT") throw e;
 	}
@@ -81,5 +86,40 @@ function decodeJwtPayload(jwt) {
 		return null;
 	}
 }
+async function writePendingAuth(p) {
+	await mkdir(PRIMARY_DIR, {
+		recursive: true,
+		mode: 448
+	});
+	await writeFile(PENDING_AUTH_FILE, JSON.stringify(p, null, 2), { mode: 384 });
+	try {
+		await chmod(PENDING_AUTH_FILE, 384);
+	} catch {}
+}
+async function readPendingAuth() {
+	if (!existsSync(PENDING_AUTH_FILE)) return null;
+	try {
+		return JSON.parse(await readFile(PENDING_AUTH_FILE, "utf-8"));
+	} catch (e) {
+		if (e.code === "ENOENT") return null;
+		throw e;
+	}
+}
+async function clearPendingAuth() {
+	try {
+		await unlink(PENDING_AUTH_FILE);
+	} catch (e) {
+		if (e.code !== "ENOENT") throw e;
+	}
+}
+/** Thrown by `auth login --resume` when there is no usable pending device_code. */
+var NoPendingAuthError = class extends Error {
+	code = "NO_PENDING_AUTH";
+	hint = "先跑 `xiaobao-cli auth login --no-wait` 发起设备授权，在浏览器完成授权后再跑 `xiaobao-cli auth login --resume`。";
+	constructor(message = "没有待完成的设备授权（从未发起，或 device_code 已过期）") {
+		super(message);
+		this.name = "NoPendingAuthError";
+	}
+};
 //#endregion
-export { writeToken as a, readToken as i, decodeJwtPayload as n, isAccessTokenValid as r, clearToken as t };
+export { isAccessTokenValid as a, writePendingAuth as c, decodeJwtPayload as i, writeToken as l, clearPendingAuth as n, readPendingAuth as o, clearToken as r, readToken as s, NoPendingAuthError as t };

package/dist/{use-DV9Ii3Tn.mjs → use-BZES4FZC.mjs}

@@ -1,5 +1,5 @@
-import { n as writeResult, t as writeError } from "./format-BZvv8lYc.mjs";
-import { n as saveActiveProject } from "./project-store-Bz5kf-EI.mjs";
+import { r as saveActiveProject } from "./project-store-CKVJa54T.mjs";
+import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/project/use.ts
 /**

package/dist/{visit-Ct3Vea8I.mjs → visit-CX0Mc1n6.mjs}

@@ -5,7 +5,7 @@ var visit_default = defineCommand({
 		name: "visit",
 		description: "客户来访分页查询"
 	},
-	subCommands: { list: () => import("./list-Bkyi95YO.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-CD08BRLk.mjs").then((m) => m.default) }
 });
 //#endregion
 export { visit_default as default };

package/dist/{whoami-DwTHvI4B.mjs → whoami-CZVez-rm.mjs}

@@ -1,5 +1,5 @@
-import { i as readToken, n as decodeJwtPayload } from "./token-store-CHZ_rJQk.mjs";
-import { n as writeResult, t as writeError } from "./format-BZvv8lYc.mjs";
+import { i as decodeJwtPayload, s as readToken } from "./token-store-CXizLE2_.mjs";
+import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/auth/whoami.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puyinkai/xiaobao-cli",
-  "version": "0.1.0",
+  "version": "0.1.8",
   "description": "旺小宝 CLI — host-agnostic 14 tools (openclaw-xiaobao plugin 的 CLI 等价物)",
   "type": "module",
   "bin": {
@@ -9,7 +9,7 @@
   "files": [
     "dist/**/*.mjs",
     "dist/**/*.d.mts",
-    "skills/**/SKILL.md",
+    "skills/**/*.md",
     "README.md"
   ],
   "engines": {

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

@@ -1,83 +1,47 @@
 ---
 name: wangxiaobao-audio-query
-description: |
-  旺小宝录音只读查询技能。按时间 / 销售 / 翻页查询录音元数据列表，可选地抽样取单条转录文本预览。**不写文件、不动游标**——是 `wangxiaobao-audio-wiki` 的"探查 / 抽样"版。
-
-  **当以下情况时使用此 Skill**:
-  (1) 用户提到"看看有哪些录音"、"查录音"、"列录音"、"哪些销售有几条录音"、"录音多不多"
-  (2) 用户想抽样几条录音文本预览，但不想批量入库
-  (3) 用户在 sync 之前想估个量、看一下数据形状
-  (4) 用户问"张三/某销售本周打了几个电话"、"上周末有几条客户对话"
-  (5) 任何"看一眼录音"而**不**触发"同步 / 入库 / 归档"意图的场景
+version: 0.1.0
+description: "旺小宝录音只读查询：按时间窗 + 可选顾问过滤分页查录音元数据列表（audioId / fileId / startTime / duration / 销售 / 签名 fileUrl），或按 audioId 查单条转录文本（含 talkRatios 说话人占比 + texts 分段 ASR）。不写文件、不动游标，是 wangxiaobao-audio-wiki 的探查/抽样版。高频命令: xiaobao-cli audio list --from --to [--user-id <id>] [--user-id-list a,b,c] [--page N] [--size N]、xiaobao-cli audio text <audio-id>。何时用：用户说看看有哪些录音/查录音/列录音/某销售本周打了几个电话/抽样几条录音文本预览/估个量/看一眼录音；任何看一眼录音而不触发同步入库归档意图的场景。"
+metadata:
+  requires:
+    bins: ["xiaobao-cli"]
+  cliHelp: "xiaobao-cli audio --help"
 ---
 
-> **Host-agnostic CLI skill** — 本 skill 假设 `xiaobao-cli` 已装到 PATH
-> (`npm i -g @puyinkai/xiaobao-cli` 或 `npx -y @puyinkai/xiaobao-cli`)。
-> Agent 通过 shell 工具（Bash / Run / Shell）执行命令、读 **stdout JSON** 消费；
-> stderr 是进度/错误提示。退出码 0 = 成功，非 0 = 业务/网络错（错误对象同时打到 stdout 可解析）。
->
-> CLI 14 个子命令跟 openclaw-xiaobao plugin 14 个 tool **1:1 等价**，返回 JSON
-> 结构完全一致（`{status, ok, data: {...}}`）。skill 里看到的 `resp.data.data.xxx`
-> 取数路径直接对 stdout JSON 用 `jq` / `JSON.parse` 即可。
->
-> **plugin tool → CLI 命令翻译表（数组参数走逗号分隔）**：
->
-> | plugin tool | CLI 命令 |
-> | --- | --- |
-> | `xiaobao_authorize { force? }` | `xiaobao-cli auth login [--force]` |
-> | `xiaobao_whoami` | `xiaobao-cli auth whoami` |
-> | `xiaobao_logout` | `xiaobao-cli auth logout` |
-> | `xiaobao_list_projects { keyword? }` | `xiaobao-cli project list [--keyword <kw>]` |
-> | `xiaobao_switch_project { tenantId, tenantName, projectId, projectName }` | `xiaobao-cli project use --tenant-id ... --tenant-name ... --project-id ... --project-name ...` |
-> | `xiaobao_list_consultants` | `xiaobao-cli consultant list` |
-> | `xiaobao_list_audio { fromDate, toDate, userId?, userIdList?, page, size }` | `xiaobao-cli audio list --from "..." --to "..." [--user-id ...] [--user-id-list a,b,c] [--page N] [--size N]` |
-> | `xiaobao_get_audio_text { audioId }` | `xiaobao-cli audio text <audioId>` |
-> | `xiaobao_list_customers { ... }` | `xiaobao-cli customer list [--user-id] [--user-name] [--customer-name] [--customer-phone] [--portrait] [--from] [--to] [--page] [--size]` |
-> | `xiaobao_list_visits { ... }` | `xiaobao-cli visit list [--customer-id] [--customer-name] [--from] [--to] [--page] [--size]` |
-> | `xiaobao_list_customer_focus { visitIds, customerIds, audioIds, category, classification, fromDate, toDate, ... }` | `xiaobao-cli focus list [--visit-ids a,b] [--customer-ids a,b] [--audio-ids a,b] [--category ...] [--classification ...] [--from ...] [--to ...]` |
-> | `xiaobao_list_customer_resistance { ... }` | `xiaobao-cli resistance list [同 focus]` |
-> | `xiaobao_quick_qa { prompt, threadId? }` | `xiaobao-cli qa "<prompt>" [--thread-id ...]` |
-> | `xiaobao_api { method, path, query, body, headers }` | `xiaobao-cli api <METHOD> <PATH> [--query k=v] [--body '<json>'] [--headers k=v]` |
->
-> 用 `--format toon` 切到 TOON（uniform 数组省 30-50% token，LLM 上下文优化）；
-> 用 `--format json`（默认）保持 JSON。state 路径：`~/.xiaobao/`（fallback 读 `~/.openclaw/state/wangxiaobao/`）。
-
-
 # 旺小宝录音查询
 
+> **CRITICAL** —— 跑命令前 MUST 先用 Read tool 读取 [`../wangxiaobao-shared/SKILL.md`](../wangxiaobao-shared/SKILL.md)（一份共享文档讲清安装 / 登录 / 选项目 / 错误码 / 输出协议等所有 xiaobao-cli 命令通用的前置约定）。
+
 只读探查录音。**没有副作用**——不写 wiki / 不推游标，
 所以用错也没成本，鼓励放心调用。
 
-> 想要"完整入库流程"（拉全部文本 → 写 wiki/raw/audio/ → 推进游标），切到
-> `wangxiaobao-audio-wiki` skill。本 skill 跟那个的边界就是**有没有副作用**。
-
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao_whoami`，未登录 / 过期就调 `xiaobao_authorize`
-- **必须有激活项目**：tenant/project 由 tool 内部从
-  `~/.openclaw/state/wangxiaobao/active-project.json` 读，调用方不需要传任何
-  tenant/project 参数。如果 tool 返回 `error: 'NO_ACTIVE_PROJECT'`，
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`，未登录 / 过期就调 `xiaobao-cli auth login`
+- **必须有激活项目**：tenant/project 由 命令内部从
+  `~/.xiaobao/active-project.json` 读，调用方不需要传任何
+  tenant/project 参数。如果 命令 返回 `error: 'NO_ACTIVE_PROJECT'`，
   让用户跑 `wangxiaobao-switch-project` skill 后再重试
 - **绝不要**写文件、推游标。即使用户随口说"顺便存一下"也要拦：
   那是 `wangxiaobao-audio-wiki` 的事，本 skill 一旦写盘就破坏了"只读"承诺
 - LocalDateTime 字段格式：`yyyy-MM-dd HH:mm:ss`（**空格**分隔，不带时区）。
-  pierre 框架的 Jackson 反序列化只认这个格式；带 `T` 或 `+08:00` 会被 plugin
+  pierre 框架的 Jackson 反序列化只认这个格式；带 `T` 或 `+08:00` 会被 CLI
   容错处理，但传空格形式最稳
 
 ---
 
 ## 快速索引：意图 → 工具
 
-| 用户意图               | plugin tool                | 关键参数                                  |
+| 用户意图               | 命令                | 关键参数                                  |
 | ---------------------- | -------------------------- | ----------------------------------------- |
-| 列某时段所有录音元数据 | `xiaobao_list_audio`       | `fromDate` / `toDate`                     |
-| 列某销售的录音         | `xiaobao_list_audio`       | `+ userId: <uid>`（多个销售用 `userIdList`） |
-| 反查销售 user-id       | `xiaobao_list_consultants` | 无参（拿当前用户授权范围内的所有顾问）   |
-| 看总数 / 估个量        | `xiaobao_list_audio`       | `page: 1, size: 1`，只读 `total`          |
-| 翻页继续看             | `xiaobao_list_audio`       | `page += 1`                               |
-| 看某条录音转录预览     | `xiaobao_get_audio_text`   | `audioId`（从 list_audio 结果拿）         |
-
-**tool 参数里没有** `tenantId` / `projectId` —— plugin 内部从激活项目状态读。
+| 列某时段所有录音元数据 | `xiaobao-cli audio list`       | `--from` / `--to`                     |
+| 列某销售的录音         | `xiaobao-cli audio list`       | `+ --user-id <uid>`（多个销售用 `--user-id-list`） |
+| 反查销售 user-id       | `xiaobao-cli consultant list` | 无参（拿当前用户授权范围内的所有顾问）   |
+| 看总数 / 估个量        | `xiaobao-cli audio list`       | `--page 1 --size 1`，只读 `total`          |
+| 翻页继续看             | `xiaobao-cli audio list`       | `--page` 递增                               |
+| 看某条录音转录预览     | `xiaobao-cli audio text`   | `--audio-id`（从 list_audio 结果拿）         |
+
+**命令 参数里没有** `tenantId` / `projectId` —— CLI 内部从激活项目状态读。
 如果还没激活过项目，跑 `wangxiaobao-switch-project` skill 先设一次。
 
 ---
@@ -100,33 +64,33 @@ description: |
 
 ### 2. 分页：page 从 **1** 开始
 
-PageParam 默认 `page: 1, size: 10`，传 `page: 0` 上游会报错。读 `total` +
+PageParam 默认 `--page 1 --size 10`，传 `page: 0` 上游会报错。读 `total` +
 当前 `page * size` 判断是否还有下一页，需要时翻页；浏览概览时第 1 页通常
-够用。`size` 上限 500（schema 已限制），预览展示建议 20。
+够用。`--size` 上限 500（schema 已限制），预览展示建议 20。
 
 ### 3. 按销售筛选：先反查 user-id 再过滤
 
-不带 `userId` / `userIdList` 就拉**所有人**的录音。要筛某个销售：
+不带 `--user-id` / `--user-id-list` 就拉**所有人**的录音。要筛某个销售：
 
-- 用户能直接给 user-id（数字）→ 用 `userId: <id>`（单个）或
+- 用户能直接给 user-id（数字）→ 用 `--user-id <id>`（单个）或
   `userIdList: [<id1>, <id2>, ...]`（多个）
-- 只知道名字 → 调 **`xiaobao_list_consultants`**（无参），拿到当前用户
-  授权范围内的所有顾问（含 `userName` / `userId`），按名字 match 后取 `userId`
-  传给 `xiaobao_list_audio`
+- 只知道名字 → 调 **`xiaobao-cli consultant list`**（无参），拿到当前用户
+  授权范围内的所有顾问（含 `--user-name` / `--user-id`），按名字 match 后取 `--user-id`
+  传给 `xiaobao-cli audio list`
 
 > 已弃用做法："先 list_audio 不带 filter，再扫 content[].saleName 反查"——
 > 这种 hack 在录音数据稀疏 / 时间窗短时找不到目标销售。**改用
-> `xiaobao_list_consultants` 反查**，精确且快。
+> `xiaobao-cli consultant list` 反查**，精确且快。
 
 ### 4. 单条文本预览：按需调，不要全量
 
-`xiaobao_get_audio_text` 一次拿一条录音的转录。**只在用户挑了具体某条之
+`xiaobao-cli audio text` 一次拿一条录音的转录。**只在用户挑了具体某条之
 后再调**，不要 list 完顺手把每条都 get_audio_text 一遍——那是 sync skill
 的事。一次会话 1-3 条样本预览足够。
 
 ### 5. 响应外层结构
 
-`xiaobao_list_audio` 和 `xiaobao_get_audio_text` 都返回 pierre 框架的
+`xiaobao-cli audio list` 和 `xiaobao-cli audio text` 都返回 pierre 框架的
 `Result<T>` 包：
 
 ```jsonc
@@ -139,7 +103,7 @@ PageParam 默认 `page: 1, size: 10`，传 `page: 0` 上游会报错。读 `tota
 
 list_audio 里 `data` 又是 `PageResult<AudioPageResp>`：
 `{ page, size, total, content[] }`，所以**取元数据数组**要写
-`resp.data.data.content`（plugin tool 不展开 envelope，原样返回）。
+`resp.data.data.content`（命令 不展开 envelope，原样返回）。
 
 ---
 
@@ -147,14 +111,8 @@ list_audio 里 `data` 又是 `PageResult<AudioPageResp>`：
 
 ### 场景 1：列今天所有录音
 
-```jsonc
-// xiaobao_list_audio
-{
-  "fromDate": "2026-05-12 00:00:00",
-  "toDate":   "2026-05-12 23:59:59",
-  "page": 1,
-  "size": 20
-}
+```bash
+xiaobao-cli audio list --from "2026-05-12 00:00:00" --to "2026-05-12 23:59:59" --page 1 --size 20
 ```
 
 渲染给用户（按 startTime desc，audioId 必须显示——后面取文本要用）：
@@ -172,13 +130,8 @@ list_audio 里 `data` 又是 `PageResult<AudioPageResp>`：
 
 只关心 `total`，第 1 页就够：
 
-```jsonc
-{
-  "fromDate": "2026-05-10 00:00:00",
-  "toDate":   "2026-05-12 00:00:00",
-  "page": 1,
-  "size": 1
-}
+```bash
+xiaobao-cli audio list --from "2026-05-10 00:00:00" --to "2026-05-12 00:00:00" --page 1 --size 1
 ```
 
 回复：「周末两天共 23 条录音，主要集中在周日下午」。
@@ -187,9 +140,8 @@ list_audio 里 `data` 又是 `PageResult<AudioPageResp>`：
 
 用户从场景 1 列表里挑了序号 1（audioId=12345）：
 
-```jsonc
-// xiaobao_get_audio_text
-{ "audioId": 12345 }
+```bash
+xiaobao-cli audio text 12345
 ```
 
 渲染：
@@ -209,24 +161,17 @@ audioId 12345 · 张三 · 2026-05-12 10:23:11（12 分钟）
 
 用户说"张三本周打了几个"——只知道名字：
 
-1. 调 `xiaobao_list_consultants`（无参）→ 拿到 `[{ userId, userName, ... }, ...]`
-2. 在结果里找 `userName === "张三"` 的 `userId`
-3. 调 `xiaobao_list_audio` 带 `userId: <张三的 userId>` + 本周时间窗
+1. 调 `xiaobao-cli consultant list`（无参）→ 拿到 `[{ userId, userName, ... }, ...]`
+2. 在结果里找 `userName === "张三"` 的 `--user-id`
+3. 调 `xiaobao-cli audio list` 带 `--user-id <张三的 userId>` + 本周时间窗
 
-```jsonc
-// step 1
-// xiaobao_list_consultants
-{}
+```bash
+# step 1: 反查张三的 user-id
+xiaobao-cli consultant list
 
-// step 2 ——找到 张三 的 userId = 100
-// step 3
-// xiaobao_list_audio
-{
-  "fromDate": "2026-05-06 00:00:00",
-  "toDate":   "2026-05-13 00:00:00",
-  "userId":   100,
-  "page": 1, "size": 20
-}
+# step 2: 假设找到张三的 userId = 100
+# step 3: 用 --user-id 过滤
+xiaobao-cli audio list --from "2026-05-06 00:00:00" --to "2026-05-13 00:00:00" --user-id 100 --page 1 --size 20
 ```
 
 如果 list-consultants 里**找不到张三**——说明当前登录用户没权限看张三
@@ -239,14 +184,14 @@ audioId 12345 · 张三 · 2026-05-12 10:23:11（12 分钟）
 
 - **`code: "400"` / `msg: "消息转换异常"`** — fromDate/toDate 格式不对。
   必须 `yyyy-MM-dd HH:mm:ss` 空格分隔，不带时区。
-- **401 / token 过期** — 调 `xiaobao_authorize { force: true }` 重登，重试一次。
+- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登，重试一次。
 - **`total: 0`** — 时间窗口里确实没数据，或激活的租户/项目错了。
   让用户跑 `wangxiaobao-switch-project` skill 确认或重新激活项目。
 - **`error: 'NO_ACTIVE_PROJECT'`** — 还没设过激活项目。让用户跑
   `wangxiaobao-switch-project` skill 后重试本 skill。
-- **翻页拿不到下一页** — 检查 `page` 是不是从 1 开始（不是 0），
+- **翻页拿不到下一页** — 检查 `--page` 是不是从 1 开始（不是 0），
   `page * size > total` 时已经到末页。
-- **`saleName` 是空的** — 上游 user info 缺失，可以只用 `userId` 标识，
+- **`saleName` 是空的** — 上游 user info 缺失，可以只用 `--user-id` 标识，
   跟用户说"该录音的销售信息上游缺失"。
 - **想"批量转文本看看"** — 拦住：批量取文本是 `wangxiaobao-audio-wiki`
   的事（带写文件 + 推游标），本 skill 设计上每次会话最多预览 1-3 条。

package/skills/wangxiaobao-audio-wiki/SKILL.md

@@ -1,82 +1,42 @@
 ---
 name: wangxiaobao-audio-wiki
-description: |
-  旺小宝录音入库技能。把指定时间窗口的录音同步到本地，按 **项目/顾问/日期/录音** 四层目录归档到 llm-wiki 知识库（`wiki/projects/{projectId}-{projectName}/raw/audio/...`），并引导后续 ingest 阶段提炼出 **顾问画像 / 客户 / 话题 / 话术** 四类 Layer 2 知识页。每个旺小宝项目对应一个独立 wiki 目录，切项目不串味。一站式工作流：sync 阶段拉数据写 raw/，ingest 阶段提炼为可检索的销售知识。
-
-  **当以下情况时使用此 Skill**:
-  (1) 用户提到"拉录音"、"同步录音"、"旺小宝录音"、"音频归档"、"录音入库"、"建录音知识库"
-  (2) 用户希望把旺小宝的录音长期沉淀成可检索的销售知识 wiki
-  (3) 用户给定了时间范围或希望"从上次同步到现在"继续拉取
-  (4) 用户想为某位置业顾问建立画像、统计客户跟进、整理话术
-  (5) 用户在 query skill 看完一眼后想"完整存下来 + 提炼成知识"
+version: 0.1.0
+description: "旺小宝录音入库：把指定时间窗的录音同步到本地，按 项目/顾问/日期/录音 四层目录归档到 llm-wiki 知识库（wiki/projects/{projectId}-{projectName}/raw/audio/...），再 ingest 提炼为 顾问画像 / 客户 / 话题 / 话术 四类 Layer 2 知识页。每个旺小宝项目对应一个独立 wiki 目录不串味；一站式 sync→ingest 工作流。底层依赖: xiaobao-cli audio list 拉元数据 + xiaobao-cli audio text 拉文本，配合 Read/Write 工具落盘 + 维护 .cursor 增量游标。何时用：用户说拉录音/同步录音/旺小宝录音/音频归档/录音入库/建录音知识库；要为某位置业顾问建立画像、统计客户跟进、整理话术；要把旺小宝录音长期沉淀成可检索的销售知识 wiki。"
+metadata:
+  requires:
+    bins: ["xiaobao-cli"]
+  cliHelp: "xiaobao-cli audio --help"
 ---
 
-> **Host-agnostic CLI skill** — 本 skill 假设 `xiaobao-cli` 已装到 PATH
-> (`npm i -g @puyinkai/xiaobao-cli` 或 `npx -y @puyinkai/xiaobao-cli`)。
-> Agent 通过 shell 工具（Bash / Run / Shell）执行命令、读 **stdout JSON** 消费；
-> stderr 是进度/错误提示。退出码 0 = 成功，非 0 = 业务/网络错（错误对象同时打到 stdout 可解析）。
->
-> CLI 14 个子命令跟 openclaw-xiaobao plugin 14 个 tool **1:1 等价**，返回 JSON
-> 结构完全一致（`{status, ok, data: {...}}`）。skill 里看到的 `resp.data.data.xxx`
-> 取数路径直接对 stdout JSON 用 `jq` / `JSON.parse` 即可。
->
-> **plugin tool → CLI 命令翻译表（数组参数走逗号分隔）**：
->
-> | plugin tool | CLI 命令 |
-> | --- | --- |
-> | `xiaobao_authorize { force? }` | `xiaobao-cli auth login [--force]` |
-> | `xiaobao_whoami` | `xiaobao-cli auth whoami` |
-> | `xiaobao_logout` | `xiaobao-cli auth logout` |
-> | `xiaobao_list_projects { keyword? }` | `xiaobao-cli project list [--keyword <kw>]` |
-> | `xiaobao_switch_project { tenantId, tenantName, projectId, projectName }` | `xiaobao-cli project use --tenant-id ... --tenant-name ... --project-id ... --project-name ...` |
-> | `xiaobao_list_consultants` | `xiaobao-cli consultant list` |
-> | `xiaobao_list_audio { fromDate, toDate, userId?, userIdList?, page, size }` | `xiaobao-cli audio list --from "..." --to "..." [--user-id ...] [--user-id-list a,b,c] [--page N] [--size N]` |
-> | `xiaobao_get_audio_text { audioId }` | `xiaobao-cli audio text <audioId>` |
-> | `xiaobao_list_customers { ... }` | `xiaobao-cli customer list [--user-id] [--user-name] [--customer-name] [--customer-phone] [--portrait] [--from] [--to] [--page] [--size]` |
-> | `xiaobao_list_visits { ... }` | `xiaobao-cli visit list [--customer-id] [--customer-name] [--from] [--to] [--page] [--size]` |
-> | `xiaobao_list_customer_focus { visitIds, customerIds, audioIds, category, classification, fromDate, toDate, ... }` | `xiaobao-cli focus list [--visit-ids a,b] [--customer-ids a,b] [--audio-ids a,b] [--category ...] [--classification ...] [--from ...] [--to ...]` |
-> | `xiaobao_list_customer_resistance { ... }` | `xiaobao-cli resistance list [同 focus]` |
-> | `xiaobao_quick_qa { prompt, threadId? }` | `xiaobao-cli qa "<prompt>" [--thread-id ...]` |
-> | `xiaobao_api { method, path, query, body, headers }` | `xiaobao-cli api <METHOD> <PATH> [--query k=v] [--body '<json>'] [--headers k=v]` |
->
-> 用 `--format toon` 切到 TOON（uniform 数组省 30-50% token，LLM 上下文优化）；
-> 用 `--format json`（默认）保持 JSON。state 路径：`~/.xiaobao/`（fallback 读 `~/.openclaw/state/wangxiaobao/`）。
-
-
 # 旺小宝录音入库
 
+> **CRITICAL** —— 跑命令前 MUST 先用 Read tool 读取 [`../wangxiaobao-shared/SKILL.md`](../wangxiaobao-shared/SKILL.md)（一份共享文档讲清安装 / 登录 / 选项目 / 错误码 / 输出协议等所有 xiaobao-cli 命令通用的前置约定）。
+
 完整工作流：**登录 → 选项目 → 翻页拉元数据 → 逐条取文本 → 按
 **项目 / 顾问 / 日期 / 录音** 分层写 wiki → 推进游标 → ingest 提炼为
 Layer 2 知识页**。
 
-> 每个旺小宝项目落到独立的 `wiki/projects/{projectId}-{projectName}/`
-> 目录，**切项目不会污染另一个项目的录音/顾问画像/客户档案**。同 cwd 下
-> 可并存多个项目的 wiki。
-
-> 只想看一眼录音元数据列表（不写文件、不推游标）请用 `wangxiaobao-audio-query`
-> skill。本 skill 跟它的边界是 **写入 vs 只读**。
-
 ## 上游接口
 
-| 接口 | plugin tool | 用途 |
+| 接口 | 命令 | 用途 |
 | --- | --- | --- |
-| `POST /ai-open/audio/page` | `xiaobao_list_audio` | 分页列录音元数据 |
-| `GET /ai-open/audio/text/{audioId}` | `xiaobao_get_audio_text` | 单条录音转录文本 + 说话人占比 |
+| `POST /ai-open/audio/page` | `xiaobao-cli audio list` | 分页列录音元数据 |
+| `GET /ai-open/audio/text/{audioId}` | `xiaobao-cli audio text` | 单条录音转录文本 + 说话人占比 |
 
 ## 执行前必读
 
-1. **登录**：先调 `xiaobao_whoami`；未登录 / 过期就调 `xiaobao_authorize`。
-2. **激活项目**：tool 内部从 `~/.openclaw/state/wangxiaobao/active-project.json`
-   读 tenant/project。如果任何 tool 返回 `error: 'NO_ACTIVE_PROJECT'`，
+1. **登录**：先调 `xiaobao-cli auth whoami`；未登录 / 过期就调 `xiaobao-cli auth login`。
+2. **激活项目**：命令内部从 `~/.xiaobao/active-project.json`
+   读 tenant/project。如果任何 命令 返回 `error: 'NO_ACTIVE_PROJECT'`，
    先走 `wangxiaobao-switch-project` skill 让用户选。
 3. **拿到 projectId / projectName**（写 wiki 路径用）：调一次
-   `xiaobao_list_projects` 后定位当前 active-project 对应行，或者直接复用
-   `xiaobao_switch_project` 上一次的返回值里的 `activeProject` 字段。
+   `xiaobao-cli project list` 后定位当前 active-project 对应行，或者直接复用
+   `xiaobao-cli project use` 上一次的返回值里的 `activeProject` 字段。
 4. **wiki 输出目录**：默认 `./wiki/`（cwd 下）。如果用户在 cwd `./.env`
    配了 `WIKI_DIR`，用 `${WIKI_DIR}/`。raw/ 子目录是 llm-wiki Layer 1，
    **不可变**。
 5. **游标变量名**：`WB_SYNC_CURSOR`，**仍写到 cwd `./.env`**（游标是 per-workspace
-   的同步进度，不是 plugin 全局状态，跟 active-project 不一样），格式
+   的同步进度，不是 CLI 全局状态，跟 active-project 不一样），格式
    `yyyy-MM-dd HH:mm:ss`。
 6. **wiki schema 必读**：业务知识页结构详见
    [`references/audio-wiki-schema.md`](references/audio-wiki-schema.md)
@@ -88,7 +48,7 @@ Layer 2 知识页**。
 `yyyy-MM-dd HH:mm:ss`（中间空格分隔，**不是** ISO 的 `T`）。
 
 - ✅ `"2026-05-12 12:00:00"`
-- ⚠️ `"2026-05-12T12:00:00"`（plugin tool 内部会自动转空格，但 SKILL 里直接传空格更稳）
+- ⚠️ `"2026-05-12T12:00:00"`（命令 内部会自动转空格，但 SKILL 里直接传空格更稳）
 - ❌ `"2026-05-12T12:00:00+08:00"`（带时区会被剥掉，避免传）
 
 ## 工作流
@@ -109,12 +69,12 @@ Layer 2 知识页**。
 for each window [winStart, winEnd):
   page = 1                              # ⚠️ PageParam 默认从 1 开始
   loop:
-    resp = xiaobao_list_audio {
+    resp = xiaobao-cli audio list {
       fromDate: winStart,
       toDate:   winEnd,
       page,
       size: 50
-      # ⚠️ 没有 tenantId / projectId —— plugin 自己从 active-project 读
+      # ⚠️ 没有 tenantId / projectId —— CLI 自己从 active-project 读
     }
     pageResult = resp.data.data           # Result<PageResult<...>> 拨开两层 envelope
     records = pageResult.content
@@ -124,7 +84,7 @@ for each window [winStart, winEnd):
     否则 page += 1
 ```
 
-若 tool 返回 401 → 调 `xiaobao_authorize { force: true }` 后重试当前窗口
+若 命令 返回 401 → 调 `xiaobao-cli auth login --force` 后重试当前窗口
 （最多重试一次）。
 
 ### 第 3 步：逐条取文本
@@ -132,7 +92,7 @@ for each window [winStart, winEnd):
 每条 record（有 audioId）单独调一次：
 
 ```
-text = xiaobao_get_audio_text {
+text = xiaobao-cli audio text {
   audioId: record.audioId
   # ⚠️ 没有 tenantId / projectId
 }
@@ -157,12 +117,6 @@ wiki/projects/{projectId}-{projectName}/raw/audio/{userId}-{saleName}/{yyyy-MM-d
 - 第 2 层 `{yyyy-MM-dd}/` — 录音发生时的日期（从 `record.startTime` 拿）
 - 第 3 层 `{audioId}.md` — 单条录音
 
-> projectId / projectName 取自 plugin 全局 active-project 状态
-> （`~/.openclaw/state/wangxiaobao/active-project.json`，由
-> `wangxiaobao-switch-project` skill / `xiaobao_switch_project` tool 写入）。
-> 本 skill **不读** cwd `.env` 里的 tenant/project，但 sync 游标
-> `WB_SYNC_CURSOR` 仍写在 cwd `.env`。
-
 **frontmatter 必填**：
 
 ```yaml
@@ -196,7 +150,7 @@ parent_consultant: "[[consultants/100-张三]]"
 正文：把 `text.texts[]` 按 "speaker: content" 逐行排好，行首带时间戳。
 
 **写入策略**：
-- 用 Write tool 创建文件，**同名文件已存在就跳过**（raw 幂等不可变）
+- 用 Write tool 创建文件（Claude Code 内置写文件工具），**同名文件已存在就跳过**（raw 幂等不可变）
 - 写完一个窗口报"本窗口写入 N 条 / 跳过 M 条同名 / 跳过 K 条无文本"
 
 > 完整 frontmatter 字段含义 + saleName sanitize 规则见
@@ -279,7 +233,7 @@ wiki/projects/{projectId}-{projectName}/
 | "从游标继续" / "继续同步"  | from = WB_SYNC_CURSOR, to = now                               |
 | "重跑某天"                 | 临时用指定窗口，**不**回退游标                                |
 | "干跑 / dry-run"           | 走前 3 步但跳过第 4-5 步的写盘和游标更新                      |
-| "只看某个销售的"           | 先调 `xiaobao_list_consultants` 反查 user-id，再 list_audio 带 `userId: <sale-user-id>` |
+| "只看某个销售的"           | 先调 `xiaobao-cli consultant list` 反查 user-id，再 list_audio 带 `--user-id <sale-user-id>` |
 | "把张三本周的录音存下来"   | 同上 + 时间窗口限定本周                                       |
 | "ingest 录音建知识库"      | 跳到第 7 步（前提：raw/ 已经有数据）                          |
 | "拉完顺便 ingest"          | 走完整 7 步（sync + ingest 一站式）                           |
@@ -289,8 +243,8 @@ wiki/projects/{projectId}-{projectName}/
 ## 完整链路
 
 ```
-1. xiaobao_authorize             — 拿到 token
-2. wangxiaobao-switch-project    — 选好租户/项目，写 ~/.openclaw/state/wangxiaobao/active-project.json
+1. xiaobao-cli auth login             — 拿到 token
+2. wangxiaobao-switch-project    — 选好租户/项目，写 ~/.xiaobao/active-project.json
 3. 本 skill - sync 阶段          — 翻页拉 → 逐条取文本 → 按 顾问/日期 写 raw → 推进游标
 4. 本 skill - ingest 阶段         — 读 raw/ → 提炼 4 层 Layer 2 知识页 → 更新 index/log
 ```
@@ -305,9 +259,9 @@ wiki/projects/{projectId}-{projectName}/
 - Token 有效期由 phoenix 端 client 配置决定（默认 1h access + 30d refresh）。
 - 游标为空时默认从 7 天前开始。
 - 首次跑或拉历史范围大时建议先 dry-run。
-- API 路径已封装在 plugin tool 里，**不要**用 `xiaobao_api` 自己拼
+- API 路径已封装在 命令 里，**不要**用 `xiaobao-cli api` 自己拼
   `/audio/page` / `/audio/text/{id}`。
-- 激活项目状态在 `~/.openclaw/state/wangxiaobao/active-project.json`（plugin
+- 激活项目状态在 `~/.xiaobao/active-project.json`（CLI
   全局单份，跟 cwd 无关）；游标 `WB_SYNC_CURSOR` 在 cwd `.env`（per-workspace）。
 - `wiki/projects/.../raw/audio/` 是 Layer 1 不可变，**不要**回写、改名、删除。
 - **批量取文本要节制并发**：一个窗口可能几十条录音，串行调（不要 parallel
@@ -317,13 +271,13 @@ wiki/projects/{projectId}-{projectName}/
 
 ## 常见错误与排查
 
-- **`xiaobao_list_audio` 返回 401** — token 过期 → `xiaobao_authorize { force: true }` 重登
-- **`xiaobao_get_audio_text` 返回 `data: null` / `texts: []`** — 转录未就绪 / 录音异常 → 跳过该条
+- **`xiaobao-cli audio list` 返回 401** — token 过期 → `xiaobao-cli auth login --force` 重登
+- **`xiaobao-cli audio text` 返回 `data: null` / `texts: []`** — 转录未就绪 / 录音异常 → 跳过该条
 - **page 翻不动 / 重复返回同一页** — 检查 page 是否从 1 开始；`total = 0` 直接结束窗口
 - **fromDate/toDate 报参数错** — 用空格分隔的 `yyyy-MM-dd HH:mm:ss`，不带时区
 - **游标没推进** — 窗口中途报错被跳过 → 查哪个窗口失败、修复后从上次成功窗口的末尾重跑
 - **`error: 'NO_ACTIVE_PROJECT'`** — 还没设过激活项目 → 跑
-  `wangxiaobao-switch-project` skill。注意：plugin active-project 是全局单份，
+  `wangxiaobao-switch-project` skill。注意：CLI active-project 是全局单份，
   跟 cwd 无关；游标 `WB_SYNC_CURSOR` 在 cwd `.env` 里，用户切了 cwd 会丢失游标
   上下文，需要从指定时间继续或重新拉
 - **raw/ 写文件冲突** — 同名 audioId 已存在 → 跳过（raw 幂等）