📦 旺小美数据助手

旺小美数据助手 让 AI 查询旺小美系统数据的技能。扫码授权后，可查询录音、客户、接访等数据。

首次使用 – 授权流程

• 发起：说出想查的数据（如“查看录音列表”）
• 扫码：用旺小美 App 扫我生成的二维码
• 自动：App 获取当前登录 token 并返回
• 开始：授权完成，即可查询

授权信息存于 ~/.wangke-auth-token，下次免授权。

可查询数据 录音

• 录音列表：按日期、状态、用户筛选（日期格式：YYYY-MM-DD HH:mm:ss）
• 录音详情：含转写文本
• 录音分析：NLP 结果
• 录音搜索：关键词搜索

示例： “显示最近10条录音” “查看录音 ID 12345 的详情” “查看今天的录音”

接访/接诊

• 接访列表：按时间筛选
• 来访详情
• 虚拟接访

示例： “显示今天的接访” “查看最近10条接访”

用户与项目

• 当前用户：姓名、手机号、角色等
• 租户项目列表
• 切换项目

示例： “查看当前登录用户” “列出我有权限的租户和项目” “切换到项目 ID xxx”

客户

• 客户列表：多维度筛选（时间、类型、成交状态、来源、级别、意向、有无录音）
• 客户详情
• 客户搜索：姓名或手机号

示例： “显示意向客户列表” “查看客户张三详情” “搜索手机 138xxxx” “查看本周新增客户”

技术实现

• 授权管理 (scripts/auth-manager.js)：本地 HTTP 服务、二维码、token 存取
• API 客户端 (scripts/api-client.js)：封装旺小美 API、自动认证、统一错误处理
• 授权页 (references/auth.html)：二维码、轮询、成功提示

API 端点 用户信息 GET /saas/v2/user/info 租户项目 GET /saas/v2/estate/tenant-and-estate/by-user-id 切换项目 POST /session/switch-project 录音列表 POST /beautx-ai-voice/app/audio/page 录音详情 GET /beautx-ai-voice/audio/detail/{audioId} 录音 NLP GET /beautx-ai-voice/app/audio/nlp-result/{audioId} 接访列表 GET /beautx-ai-voice/visit 来访详情 GET /app/visit/{visitId} 客户列表 POST /beautx-ai-voice/app/customer/pageV2 客户详情 GET /beautx-ai-voice/app/customer/detailV2

注意事项

• token 持久保存，手动清除失效
• token 文件仅用户可读写
• 需访问 wangkeapp.wangxiaobao.com
• 需旺小美 App 支持扫码授权

清除授权 rm ~/.wangke-auth-token 或对我说“清除授权”

常见问题 Q：授权失败？ A：确认 App 已登录、网络正常，重扫二维码。 Q：token 过期？ A：删文件重授权。 Q：多账号？ A：暂不支持，新授权会覆盖旧 token。