旺小宝客户画像分页查询

要解决什么问题

在旺小宝（xiaobao-cli）里，客户画像分散在后端分页接口中：既要按最近来访排序翻页，又要叠加顾问、画像标签、姓名/手机号、来访时间等条件。人工拼参数容易踩坑——例如把顾问姓名直接塞进查询、把 portrait 写成整段 JSON，或把分页从 0 起算导致报错。

本技能把「customer list」当成只读入口：在当前激活项目与当前用户授权可见的顾问范围内，稳定地拉取客户列表与 total，不写文件、不生成报告。

核心能力与关键步骤

执行前需满足共享文档 wangxiaobao-shared 里的通用约定：有效 token（auth whoami）、已激活项目（遇 NO_ACTIVE_PROJECT 先切项目）。主命令为 xiaobao-cli customer list，常用参数包括 --page / --size、--user-id、--portrait、--customer-name / --customer-phone、--from / --to。

• 按顾问筛选：先 consultant list 解析 userName 得到 --user-id，再查客户；列表里没有该顾问即无权访问，不要硬查。
• 画像关键词：--portrait 为单关键词，后端对 dynamic_tags 做 LIKE，宜短不宜长。
• 时间窗：用户未明说时可按「今天 / 本周 / 上月」等推断 from / to；时间为 yyyy-MM-dd HH:mm:ss。
• 分页与总数：page 从 1 开始，--size 上限 500；估算总数可用 --page 1 --size 1 读 total。

CLI 外层为 { status, ok, data }，列表在 resp.data.data.content。

适用边界与注意点

后端按顾问授权做数据隔离（顾问看自己、团队长看团队、项目管理员看全项目），看不到的客户不是接口故障。total: 0 可能是条件过严、时间窗不对，或授权范围内确实无数据。401 需重登；画像匹配不准时缩短 portrait 关键词。