技能介绍

解决什么问题

旺小宝量子看板把来访、成交、意向、工效等业务结果预聚合成结构化 KPI。但在实际取数时，这些指标分散在 H5 的不同卡片里，口径多、视图多；团队均值、到访类型、统计维度和意向复核方式稍有选错，就可能拿到不同含义的数字，人工逐个卡片核对既累又容易混。

技能如何工作

xiaobao-cli quantum 用一个命令覆盖量子看板的核心指标，命令本身按指标族区分子视图，再通过 --view / --mode 选择具体卡片。执行前要先读取 ../wangxiaobao-shared/SKILL.md，确认安装、登录、项目激活和错误码；同时对照 references/quantum-metrics.md 选择 metric + view，并补齐必填参数。

核心能力包括：

统一查询来访、成交、意向、录音覆盖、服务分、销讲执行率、挖需执行率、风控和月报等量子看板 KPI；
用 --view summary / time / rank / team / user / status / level 等参数区分看板卡片；
用 --visit-type first|second|third_more|special 过滤首访、复访、三访+和特殊到访；
不传 --user-ids 时，后端按当前用户的管理者或个人数据范围自动解析；
时间默认当天，跨天、周、月通过 --from / --to / --date-type 控制；
输出是统一 Result，data 结构会随 metric / view 变化，实际展示以返回为准。

核心步骤：

确认已有有效 token，并完成项目激活；
根据业务问题选择指标，例如来访趋势用 quantum visit --view time，成交统计用 quantum deal；
对照指标参考确认 view、mode 和必填参数；
执行 xiaobao-cli quantum ...，默认读取 resp.data.data，不要假设固定结构。

适用边界与注意点

特殊到访组数和排名使用 quantum visit --visit-type special；quantum special-visit 是另一套有效/无效标签卡，语义不同，不要混用。
团队平均接待时长、服务分、挖需率、成交率等团队均值，必须使用 --view team，不要从 user 视图自行平均。
首访、复访、三访+是显式过滤；不传 --visit-type 不等于已选中某个 Tab，结果可能是混合或未过滤。
--stat-dimension customer_num 只在客户数口径正确时使用；来访默认 visit_times，跟进默认 follow_times。
意向复核后数据使用 --intent-dimension review，默认口径是 ai。
visit-timer 做 team / date 下钻时，必须提供 --interval-start 和 --interval-end；分桶边界为 0/30/60/120/1000 分钟。
遇到 NO_ACTIVE_PROJECT，先切换项目；遇到 401，重新登录；遇到 400，优先补齐参数；遇到空数据，先检查时间窗和当前账号数据权限。
量子查询适合结构化看板 KPI；开放式问数，例如“客户主要疑虑是啥”，应走 wangxiaobao-quick-qa。