旺小宝录音列表查询

要解决的具体问题

旺小宝录音数据通常按租户、项目、销售和时间分散在业务系统里。工程师在做数据核对、质量抽检或排查某个销售的通话表现时，常见困难不是“能不能调接口”，而是如何稳定拿到元数据列表、正确估算总量、按销售筛选，并在需要时只预览一条转录，而不是把整批录音全部拉下来。

这个技能面向这类只读查询场景。它不写 wiki、不推游标、不落地文件，适合作为安全探查录音数据的第一步。用户可以说“看今天的录音”“估算上周末打了几个电话”“找张三本周的录音”“看某一条录音的转录预览”，技能会把这些意图映射到 xiaobao-cli 的只读命令上。

技能如何工作

核心能力围绕三类查询展开：

• 列录音元数据：通过 xiaobao-cli audio list 按 --from / --to 拉取指定时间窗内的录音列表，结果包含 page、size、total、content[] 等分页结构。
• 按销售筛选：如果只有销售姓名，先调用 xiaobao-cli consultant list 反查当前账号有权限看到的顾问，拿到 --user-id 后再传给 xiaobao-cli audio list。
• 估算总量与预览单条：只关心数量时可以取第 1 页的 total；用户指定某条录音后，再调用 xiaobao-cli audio text 查看转录预览。

关键步骤通常是：确认 auth whoami 有效、确认已激活项目、根据用户说法解析时间窗口、判断是否需要分页、需要销售筛选时先反查 user-id、最后把列表按 startTime 倒序展示，并保留 audioId 用于后续单条查询。

适用边界与注意点

这个技能强调只读承诺：即使用户说“顺便存一下”或“批量转文本看看”，也不应把它当同步工具使用；批量写文件、推游标属于 wangxiaobao-audio-wiki 的职责。

使用时需要特别注意：

• 时间格式必须是 yyyy-MM-dd HH:mm:ss，用空格分隔，不带时区。
• 分页从 --page 1 开始，不能传 0。
• --size 上限是 500，预览展示通常 20 条左右即可。
• 如果返回 NO_ACTIVE_PROJECT，需要先完成项目激活。
• 如果按姓名反查不到销售，通常说明当前账号没有该销售的查看权限，不应硬调列表接口假装搜索。