旺小宝量子统计（量子看板 / 预聚合 KPI）
> CRITICAL —— 跑命令前 MUST 先用 Read tool 读取 ../wangxiaobao-shared/SKILL.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）
核心约束（跨指标坑，务必遵守）
- 特殊到访组数/排名 用
quantum visit --visit-type special，不是quantum special-visit（后者是「有效/无效标签卡」，语义不同）。 - 团队均值类（某团队平均接待时长 / 服务分 / 挖需率 / 成交率…）MUST 用
--view team，禁止取user视图自己手算平均。 - 团队最高挖需率 →
quantum demand-card --view team。 - 首访/复访/三访+ →
--visit-type first|second|third_more（不传 ≠ 已选某 Tab，可能混合或未过滤）。 - 客户数维度 →
--stat-dimension customer_num（来访默认visit_times、跟进默认follow_times；别一看到「客户数」就误用）。 - 意向口径默认 review（复核后数据）：日常汇报/统计用
--intent-dimension review；用户明确说「AI 智能评级」才传ai。 - visit-timer 的 team/date 下钻 → 必填
--interval-start/--interval-end（分桶：0/30/60/120 → 30/60/120/1000 分钟）。 - 顾问维度指标：销讲执行率(
pin-talk)、挖需执行率(demand-card)、工作表现(job-performance)、工作质量(work-quality)、接访时长(visit-timer)等统计的都是接待顾问（置业顾问）的表现——rank/user视图按顾问、team视图按顾问团队聚合，不是客户维度。 - 路由：群体画像分布（业态/面积/区域…饼图）优先
portrait get；单客户标签优先visit summary；customer list的 dynamic_tags 最低优先，禁止拿它手算分布。
响应
统一 Result<Object>，data 结构随 metric/view 变化（列表 / 嵌套 / 汇总都可能）。CLI 再包一层 → 读 resp.data.data。按实际返回展示，不要假设固定结构、不要硬解析。默认 --format toon 省 token；要严格 JSON 加 --format json。
使用场景示例
# 今天各顾问来访排名（首访）
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
