@puyinkai/xiaobao-cli 0.2.1 → 0.3.0

package/README.md

@@ -55,6 +55,7 @@ xiaobao-cli audio list --from "2026-05-01 00:00:00" --to "2026-05-02 00:00:00" -
 | `kb docs [--title]` | 新增 · 知识库文档列表 |
 | `kb doc <doc-id>` | 新增 · 知识库文档详情 |
 | `kb doc-content <doc-id> [--offset] [--limit]` | 新增 · 知识库文档正文分页 |
+| `quantum <metric> [--view] [--visit-type] …` | 新增 · 量子看板 / KPI 统计（20 指标） |
 | `api <METHOD> <path>` | `xiaobao_api` |
 
 ## 通用 flags
@@ -82,9 +83,10 @@ xiaobao-cli audio list --from "2026-05-01 00:00:00" --to "2026-05-02 00:00:00" -
 ## skill 配套
 
 `skills/` 目录下的 SKILL.md 跟 cli 同包发布，跟 openclaw-xiaobao 那边镜像，
-只是调用从 plugin tool invoke 改为 shell out `xiaobao-cli ...`。本次新增
-`wangxiaobao-visit-summary-query`（来访接待总结）与 `wangxiaobao-knowledge-base`（知识库）
-两个 skill；`wangxiaobao-quick-qa` 的问数底层由 fast-responder 切换为 sql-agent。
+只是调用从 plugin tool invoke 改为 shell out `xiaobao-cli ...`。近期新增
+`wangxiaobao-visit-summary-query`（来访接待总结）、`wangxiaobao-knowledge-base`（知识库）
+与 `wangxiaobao-quantum-stats`（量子看板 / KPI 统计，含 `references/quantum-metrics.md`）；
+`wangxiaobao-quick-qa` 的问数底层由 fast-responder 切换为 sql-agent。
 
 ## License
 

package/dist/cli.mjs

@@ -8,8 +8,8 @@ import { defineCommand, runMain } from "citty";
 * xiaobao-cli entrypoint.
 *
 * Capabilities mapped from the openclaw-xiaobao plugin to CLI subcommands,
-* plus visit-summary and knowledge-base queries — all proxied through
-* ai-open → wang-ai-mcp. See README for the full command map.
+* plus visit-summary, knowledge-base and quantum KPI stats — all proxied
+* through ai-open → wang-ai-mcp. See README for the full command map.
 */
 const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
 runMain(defineCommand({
@@ -24,11 +24,12 @@ runMain(defineCommand({
 		consultant: () => import("./consultant-DvH6ezCT.mjs").then((m) => m.default),
 		audio: () => import("./audio-DhEiStuy.mjs").then((m) => m.default),
 		customer: () => import("./customer-BtAtJyM8.mjs").then((m) => m.default),
-		visit: () => import("./visit-LX3B_OgE.mjs").then((m) => m.default),
+		visit: () => import("./visit-vRqOvBv5.mjs").then((m) => m.default),
 		focus: () => import("./focus-BmLvFWII.mjs").then((m) => m.default),
-		resistance: () => import("./resistance-BxOZNWbb.mjs").then((m) => m.default),
+		resistance: () => import("./resistance-B0gVs7-5.mjs").then((m) => m.default),
 		qa: () => import("./qa-C2TSTS-m.mjs").then((m) => m.default),
 		kb: () => import("./kb-B9IY8-fu.mjs").then((m) => m.default),
+		quantum: () => import("./quantum-4m2WGRWI.mjs").then((m) => m.default),
 		api: () => import("./api-DtFEKH3I.mjs").then((m) => m.default)
 	}
 }));

package/dist/quantum-4m2WGRWI.mjs

@@ -0,0 +1,183 @@
+import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
+import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
+import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
+import { n as writeResult, t as writeError } from "./format-CvKe7-yU.mjs";
+import { r as toLocalDateTime, t as csvToArray } from "./util-CaPQBlNa.mjs";
+import { defineCommand } from "citty";
+//#region src/commands/quantum.ts
+/**
+* `xiaobao-cli quantum <metric>` — 旺小宝量子看板 / 预聚合 KPI 统计.
+*
+* 一个通用命令覆盖全部量子指标（visit / visit-ongoing / visit-realtime / follow /
+* job-performance / work-quality / visit-timer / usage-data / resistance-point /
+* speech-sale / demand-data / hot-words / risk / special-visit / month-report /
+* deal / intent / pin-talk / demand-card / rhetoric）。它们共用同一套入参，靠
+* `--view` / `--mode` 区分子视图。调 POST /ai-open/quantum/<metric>。
+*
+* 各指标支持哪些 view / 需要哪些参数，见 wangxiaobao-quantum-stats skill。
+*/
+const num = (v) => v != null ? Number(v) : void 0;
+const numList = (v) => csvToArray(v)?.map(Number);
+var quantum_default = defineCommand({
+	meta: {
+		name: "quantum",
+		description: "量子看板 / KPI 统计（metric 见 quantum-stats skill；--view/--mode 区分子视图）"
+	},
+	args: {
+		metric: {
+			type: "positional",
+			required: true,
+			description: "指标端点：visit / deal / intent / pin-talk / demand-card / visit-timer 等"
+		},
+		view: {
+			type: "string",
+			description: "视图：summary|rank|team|time|user|... 随 metric 而定"
+		},
+		mode: {
+			type: "string",
+			description: "模式：page|count（visit-ongoing）、query|find（month-report）"
+		},
+		role: {
+			type: "string",
+			description: "角色：consultant|manager（usage-data）"
+		},
+		agg: {
+			type: "string",
+			description: "接访时长 metric：total|avg（visit-timer）"
+		},
+		from: {
+			type: "string",
+			description: "开始时间（默认当天 00:00:00）"
+		},
+		to: {
+			type: "string",
+			description: "结束时间（默认次日 00:00:00）"
+		},
+		"date-type": {
+			type: "string",
+			description: "day|week|month|year|total"
+		},
+		page: { type: "string" },
+		size: { type: "string" },
+		offset: { type: "string" },
+		"team-id": {
+			type: "string",
+			description: "团队 ID（team 视图下钻）"
+		},
+		"time-type": { type: "string" },
+		"visit-type": {
+			type: "string",
+			description: "first|second|third_more|special|all"
+		},
+		"deal-status": {
+			type: "string",
+			description: "CSV: 成交状态列表（deal）"
+		},
+		"model-id": {
+			type: "string",
+			description: "销讲/挖需模型 ID（pin-talk/demand-card）"
+		},
+		"dimension-id": {
+			type: "string",
+			description: "维度 ID（view=dimension|speech 下钻）"
+		},
+		"speech-id": {
+			type: "string",
+			description: "话术 ID（view=speech）"
+		},
+		config: {
+			type: "string",
+			description: "卡片 config JSON（一般不传）"
+		},
+		"stat-dimension": {
+			type: "string",
+			description: "visit_times|customer_num、follow_times|customer_num"
+		},
+		"intent-dimension": {
+			type: "string",
+			description: "review|ai（intent）"
+		},
+		"risk-dimension": {
+			type: "string",
+			description: "all|effective|review|invalid（risk）"
+		},
+		"intent-level": {
+			type: "string",
+			description: "A|B|C|D|E（intent view=user|period）"
+		},
+		direction: {
+			type: "string",
+			description: "left|right（intent view=period 翻页）"
+		},
+		"interval-start": {
+			type: "string",
+			description: "接访时长分桶起点分钟（visit-timer view=team|date 必填）"
+		},
+		"interval-end": {
+			type: "string",
+			description: "接访时长分桶终点分钟（visit-timer view=team|date 必填）"
+		},
+		"usage-data-type": {
+			type: "string",
+			description: "usage-data rank 指标"
+		},
+		"user-ids": {
+			type: "string",
+			description: "CSV: 显式 userIds 数据范围"
+		},
+		"api-base": { type: "string" },
+		"auth-base": { type: "string" },
+		format: {
+			type: "string",
+			default: "toon"
+		}
+	},
+	async run({ args }) {
+		try {
+			const config = resolveConfig({
+				apiBase: args["api-base"],
+				authBase: args["auth-base"]
+			});
+			const active = await requireActiveProject();
+			const metric = String(args.metric);
+			writeResult(await xbApiFetch(config, "POST", `/ai-open/quantum/${encodeURIComponent(metric)}`, {
+				headers: tenantProjectHeaders(active),
+				body: {
+					view: args.view,
+					mode: args.mode,
+					role: args.role,
+					metric: args.agg,
+					startTime: toLocalDateTime(args.from),
+					endTime: toLocalDateTime(args.to),
+					dateType: args["date-type"],
+					page: num(args.page),
+					size: num(args.size),
+					offset: num(args.offset),
+					teamId: num(args["team-id"]),
+					timeType: args["time-type"],
+					visitType: args["visit-type"],
+					dealStatus: numList(args["deal-status"]),
+					modelId: num(args["model-id"]),
+					dimensionId: num(args["dimension-id"]),
+					speechId: num(args["speech-id"]),
+					config: args.config,
+					statDimension: args["stat-dimension"],
+					intentDimension: args["intent-dimension"],
+					riskDimension: args["risk-dimension"],
+					intentLevel: args["intent-level"],
+					direction: args.direction,
+					intervalStart: num(args["interval-start"]),
+					intervalEnd: num(args["interval-end"]),
+					usageDataType: args["usage-data-type"],
+					userIds: numList(args["user-ids"])
+				}
+			}), args.format);
+		} catch (err) {
+			writeError(err, args.format);
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+export { quantum_default as default };

package/dist/{resistance-BxOZNWbb.mjs → resistance-B0gVs7-5.mjs}

@@ -5,7 +5,7 @@ var resistance_default = defineCommand({
 		name: "resistance",
 		description: "客户抗性点标签分页查询"
 	},
-	subCommands: { list: () => import("./list-DmBz_8dR.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-D94oyNpR.mjs").then((m) => m.default) }
 });
 //#endregion
 export { resistance_default as default };

package/dist/{visit-LX3B_OgE.mjs → visit-vRqOvBv5.mjs}

@@ -6,8 +6,8 @@ var visit_default = defineCommand({
 		description: "客户来访分页查询 / 来访接待总结"
 	},
 	subCommands: {
-		list: () => import("./list-DbReQZE2.mjs").then((m) => m.default),
-		summary: () => import("./summary-CAm-WDNF.mjs").then((m) => m.default)
+		list: () => import("./list-D2qM7Ghn.mjs").then((m) => m.default),
+		summary: () => import("./summary-CcLTV5wr.mjs").then((m) => m.default)
 	}
 });
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puyinkai/xiaobao-cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "旺小宝 CLI — host-agnostic 业务数据 / 问数 / 来访总结 / 知识库 能力 (openclaw-xiaobao plugin 的 CLI 等价物)",
   "type": "module",
   "bin": {

package/skills/wangxiaobao-quantum-stats/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: wangxiaobao-quantum-stats
+version: 0.1.0
+description: "旺小宝量子看板 / 预聚合 KPI 统计：来访/跟进/成交/意向/工作表现/接访时长/使用数据/抗性点/话术卖点/挖需/销售热词/风控/特殊来访/月报/销讲执行率/挖需执行率/说辞 等 20 类指标，按 项目/团队/顾问/时间 多视图下钻。只读、无副作用。高频命令: xiaobao-cli quantum <metric> [--view <v>] [--from <d>] [--to <d>] [--team-id <id>] [--visit-type first|second|third_more|special]。何时用：用户问 今天/本周来访多少组、来访排名、各团队来访/成交/意向对比、销冠成交、意向A级分布、录音覆盖率/盘客率、平均接待时长、销讲执行率、挖需率、风控触发次数、销售热词、月报 等 看板/KPI/排名/占比/团队对比 类问题。注：指标多、每个支持的 view 不同，跑前先读 references/quantum-metrics.md；跨指标坑：特殊到访组数用 `quantum visit --visit-type special`（不是 special-visit）、团队均值 MUST `--view team` 禁手算。要问一句话开放式业务问题走 wangxiaobao-quick-qa。"
+metadata:
+  requires:
+    bins: ["xiaobao-cli"]
+  cliHelp: "xiaobao-cli quantum --help"
+---
+
+# 旺小宝量子统计（量子看板 / 预聚合 KPI）
+
+> **CRITICAL** —— 跑命令前 MUST 先用 Read tool 读取 [`../wangxiaobao-shared/SKILL.md`](../wangxiaobao-shared/SKILL.md)（安装 / 登录 / 选项目 / 错误码 / 输出协议）。
+> **强烈建议** 再读 [`references/quantum-metrics.md`](references/quantum-metrics.md) —— 20 个指标各支持哪些 view/mode、需要哪些参数都在那里；跑前对照选对 `metric + view`，避免选错卡片或漏必填参数。
+
+`xiaobao-cli quantum <metric> [--view ...]` 一个命令覆盖全部量子指标（对应 H5 量子看板各卡片）。它们**共用一套入参**，靠 `--view` / `--mode` 区分子视图。
+
+## 执行前必读
+- 有效 token + **激活项目**（见 shared；缺失返回 `NO_ACTIVE_PROJECT`）
+- **数据权限**：不传 `--user-ids` 时后端按当前用户的 管理者/个人 范围自动解析
+- **时间**默认当天 `00:00:00 ~ 次日 00:00:00`；跨天/周/月用 `--from/--to` + `--date-type`
+- 只读、**不要**写文件
+
+## 快速索引：用户意图 → metric + view
+| 用户问法 | 命令 |
+| --- | --- |
+| 今天/本周来访多少组、来访趋势 | `quantum visit`（`--view summary` / `time`） |
+| 来访排名 / 各顾问来访 | `quantum visit --view rank`（或 `team`） |
+| 首访/复访/三访+/特殊到访 组数 | `quantum visit --visit-type first\|second\|third_more\|special` |
+| 各团队 来访/成交/意向 对比 | `quantum <visit\|deal\|intent> --view team` |
+| 成交统计 / 销冠 | `quantum deal`（`--view status/user/team/period`） |
+| 意向级别分布 / A 级客户 | `quantum intent --view level`（或 `user` + `--intent-level A`） |
+| 录音覆盖率 / 盘客率 | `quantum job-performance`（`--view audio_rate/panke_rate/team`） |
+| 平均接待时长 / 服务分 | `quantum work-quality --view team`（团队均值禁手算） |
+| 接访时长分桶下钻 | `quantum visit-timer`（team/date 须 `--interval-start/--interval-end`） |
+| 销讲执行率 | `quantum pin-talk`（`--view summary/team/user/...`） |
+| 挖需执行率 / 团队最高挖需率 | `quantum demand-card`（团队最高用 `--view team`） |
+| 风控触发 | `quantum risk`（`--risk-dimension all/effective`） |
+| 销售热词 | `quantum hot-words` |
+| 月报 | `quantum month-report --mode query` |
+
+（完整 20 指标 + 各 view/参数见 [`references/quantum-metrics.md`](references/quantum-metrics.md)）
+
+## 核心约束（跨指标坑，务必遵守）
+1. **特殊到访组数/排名** 用 `quantum visit --visit-type special`，**不是** `quantum special-visit`（后者是「有效/无效标签卡」，语义不同）。
+2. **团队均值类**（某团队平均接待时长 / 服务分 / 挖需率 / 成交率…）**MUST 用 `--view team`**，禁止取 `user` 视图自己手算平均。
+3. **团队最高挖需率** → `quantum demand-card --view team`。
+4. **首访/复访/三访+** → `--visit-type first|second|third_more`（不传 ≠ 已选某 Tab，可能混合或未过滤）。
+5. **客户数维度** → `--stat-dimension customer_num`（来访默认 `visit_times`、跟进默认 `follow_times`；别一看到「客户数」就误用）。
+6. **意向复核后数据** → `--intent-dimension review`（默认 `ai`）。
+7. **visit-timer 的 team/date 下钻** → 必填 `--interval-start/--interval-end`（分桶：0/30/60/120 → 30/60/120/1000 分钟）。
+
+## 响应
+统一 `Result<Object>`，`data` 结构**随 metric/view 变化**（列表 / 嵌套 / 汇总都可能）。CLI 再包一层 → 读 `resp.data.data`。**按实际返回展示，不要假设固定结构、不要硬解析**。默认 `--format toon` 省 token；要严格 JSON 加 `--format json`。
+
+## 使用场景示例
+```bash
+# 今天各顾问来访排名（首访）
+xiaobao-cli quantum visit --view rank --visit-type first
+# 各团队成交对比
+xiaobao-cli quantum deal --view team
+# 意向 A 级客户按顾问
+xiaobao-cli quantum intent --view user --intent-level A --intent-dimension review
+# 本周录音覆盖率（各团队）
+xiaobao-cli quantum job-performance --view team --from "2026-06-09 00:00:00" --to "2026-06-16 00:00:00" --date-type week
+# 接访时长 30~60 分钟档 各团队
+xiaobao-cli quantum visit-timer --view team --interval-start 30 --interval-end 60
+```
+
+## 常见错误与排查
+- **`NO_ACTIVE_PROJECT`** → 跑 `wangxiaobao-switch-project`
+- **401 / token 过期** → `auth login --no-wait --force` 重登
+- **400 / 缺参数**（如 visit-timer team 缺 interval、intent team 缺 intent-level）→ 对照 references 补齐必填
+- **未知 metric（404）** → 端点名拼错，照 references 的 metric 列表
+- **空数据** → 时间窗内无数据，或当前账号无该范围权限（不是 bug）
+- **该用开放式问数** → 一句话业务问题（「客户主要疑虑是啥」）走 `wangxiaobao-quick-qa`，量子是结构化看板 KPI

package/skills/wangxiaobao-quantum-stats/references/quantum-metrics.md

@@ -0,0 +1,43 @@
+# 量子统计指标清单（quantum-metrics）
+
+`xiaobao-cli quantum <metric> [flags]` → `POST /ai-open/quantum/<metric>`。20 个 metric **共用同一套入参**，靠 `--view` / `--mode` 区分子视图，统一返回 `Result<Object>`（结构随 metric/view 变）。默认时间 = 当天。
+
+## 共享参数
+- `--from` / `--to`：`yyyy-MM-dd HH:mm:ss`，默认当天 `00:00:00 ~ 次日`
+- `--date-type`：`day|week|month|year|total`（默认 day）
+- `--user-ids`：CSV 显式数据范围；不传按 管理者/个人 自动解析
+- `--team-id`：团队 ID（部分 metric 的 scope）
+- `--page` / `--size`：分页（默认 1 / 20）
+- `--visit-type`：`first|second|third_more|special|all`（来访维度 Tab）
+
+## 20 个指标
+| metric | 说明 | view / mode | 关键参数 |
+| --- | --- | --- | --- |
+| `visit` | 来访统计 | view: `summary`(默认)`\|rank\|team\|time` | `--stat-dimension visit_times`(默认)`\|customer_num`；`--visit-type first\|second\|third_more\|special` |
+| `visit-ongoing` | 接待中接访 | mode: `page`(默认)`\|count` | — |
+| `visit-realtime` | 实时看板 | view: `trend`(默认)`\|resistance\|resistance_list\|deal` | — |
+| `follow` | 跟进统计 | view: `summary\|rank\|team\|time` | `--stat-dimension follow_times`(默认)`\|customer_num`；`--visit-type` 同 visit |
+| `job-performance` | 工作表现（录音/盘客率） | view: `summary\|panke_rate\|audio_rate\|rank\|user\|team\|time` | `team`=各团队录音/盘客率 |
+| `work-quality` | 工作质量（接待时长/服务分） | view: `summary\|user\|team\|date` | 团队均值 **MUST** `view=team`（禁 user 手算） |
+| `visit-timer` | 接访时长 | view: `summary\|team\|user\|date` | `--agg total`(默认)`\|avg`；`team/date` 须 `--interval-start/--interval-end`（分桶 0/30/60/120 → 30/60/120/1000）；`summary`=全项目 4 分桶；`user`=逐顾问平均分钟 |
+| `usage-data` | 使用数据 | view: `summary\|rank\|time\|team` | `--role consultant`(默认)`\|manager`（仅影响 summary 展示）；`--usage-data-type daily_time_avg\|review_audio\|learning_times\|customer_comment\|share_audio\|audio_comment`（rank 指标） |
+| `resistance-point` | 抗性点 | view: `distribution`(默认)`\|detail_texts\|detail_total` | — |
+| `speech-sale` | 话术卖点 | view: `summary\|user` | — |
+| `demand-data` | 挖需统计（DataStat） | view: `summary\|user` | — |
+| `hot-words` | 销售热词 | view: `summary\|user\|dimensions` | — |
+| `risk` | 风控 | view: `summary`(风控点列表)`\|user\|total`(触发总次数) | `--risk-dimension all`(默认)`\|effective\|review\|invalid`（仅有效= effective） |
+| `special-visit` | 特殊来访标签卡（有效/无效 visitLabel 分布） | view: `summary\|user` | ⚠️ H5「特殊到访组数/排名」**不用这个**，用 `visit --visit-type special` |
+| `month-report` | 月报 | mode: `query`(默认)`\|find` | — |
+| `deal` | 成交统计 | view: `status`(默认)`\|team\|user\|period` | `team`=各团队 count/total/rate；`--deal-status` 默认 `1,2,3` |
+| `intent` | 意向统计 | view: `level`(默认，全项目级别分布)`\|team\|user\|period` | `team/user/period` 须 `--intent-level A\|B\|C\|D\|E`；`--intent-dimension review\|ai`(默认 ai)；`--direction left\|right`（period 翻页） |
+| `pin-talk` | 销讲执行率 | view: `summary\|visit_status\|team\|user\|dimension\|speech\|models` | `--visit-type first\|second\|third_more`；`--model-id/--dimension-id/--speech-id` 下钻 |
+| `demand-card` | 挖需执行率卡片 | view: `summary\|visit_status\|team\|user\|dimension\|speech` | `--visit-type first\|second\|third_more\|all`；团队最高挖需率用 `--view team` |
+| `rhetoric` | 说辞统计 | 无 view（默认汇总） | — |
+
+## 跨指标坑（重复强调）
+- 特殊到访组数/排名 → `visit --visit-type special`，不是 `special-visit`。
+- 团队均值/占比（接待时长、服务分、挖需率、成交率、意向占比）→ 对应 metric 的 `--view team`，别手算。
+- 团队最高挖需率 → `demand-card --view team`。
+- 首访/复访/三访+ → `--visit-type first|second|third_more`。
+- 「客户数」口径 → `--stat-dimension customer_num`（默认是 visit_times / follow_times）。
+- 意向复核后 → `--intent-dimension review`（默认 ai）。

package/skills/wangxiaobao-shared/SKILL.md

@@ -156,7 +156,7 @@ openclaw 的副本（保留 plugin session 完整性）。`auth logout` 例外
 ## 数据权限隔离
 
 `audio list` / `customer list` / `visit list` / `visit summary` / `focus list` /
-`resistance list` / `consultant list` / `qa` 所有业务命令的后端都按**当前登录用户的授权范围**过滤数据:
+`resistance list` / `consultant list` / `qa` / `quantum` 所有业务命令的后端都按**当前登录用户的授权范围**过滤数据:
 
 - 普通顾问：只看自己名下
 - 团队长：看本团队