旺小宝客户来访分页查询

要解决什么问题

销售与运营同学经常要核对「某段时间谁来了」「某位客户最近几次到访」「某次接待有没有录音可听」。旺小宝后台数据在 CLI 里，若不经约定直接拼参数，容易踩 NOACTIVEPROJECT、token 过期，或在 customerName 模糊匹配时把重名客户混在一起。

本技能把查询收敛到 xiaobao-cli visit list：在已登录且已激活项目的前提下，按时间窗、客户 ID 或姓名做分页拉取，并说明结果里 接待顾问（userId）与 归属顾问（belongUserId）可能不一致的常见原因。

技能如何工作

执行前需对照共享文档 wangxiaobao-shared 完成登录与选项目；可用 xiaobao-cli auth whoami 确认 token。核心映射如下：

• 时间窗内全量来访：visit list + --from / --to（LocalDateTime 格式 yyyy-MM-dd HH:mm:ss）
• 某客户历史：优先 customer list 反查 wang_id，再 --customer-id；比直接 --customer-name 更准、更快
• 估算总数：--page 1 --size 1，只读 total
• 录音元数据：列表项内 audios[] 含 fileUrl；转录文本需另调 audio text，本命令不写文件、不出报告

分页从 1 起，size 上限 500；响应路径为 resp.data.data.content。requireSpeechHitDetail / salesSpeechHitDetail 为 JSON 文本，默认不向用户展开，除非明确问话术命中细节。

边界与注意点

• 数据按当前用户授权可见的顾问范围过滤，与 customer 接口一致；total: 0 可能是时间窗内无数据，也可能是权限范围内无匹配接待人。
• 用户说「最近 3 次」时可不传时间窗，取 content[] 前几条；「今天」「本周」「5 月」等口语需推断为具体 from/to。
• 当前命令不支持按 belongUserId 过滤；问「张三名下客户来访」需先用 customers 反查再按 customerId 过滤。
• 常见错误：NO_ACTIVE_PROJECT 需切换项目；401 需重登；客户名拼写差异时改用 customer list 拿精确 ID。