旺小美数据助手
这是一个让AI能够查询旺小美系统数据的技能。通过扫码授权后，你可以让AI帮你查询录音、客户和接访等各类数据。
首次使用 - 授权流程
在使用此技能查询数据之前，需要先完成授权：
- 发起授权：告诉我你想查询的数据（如"查看录音列表"）
- 扫码授权：我会生成一个二维码，你用旺小美 App 扫描它
- 自动完成：App 会自动获取当前登录的 token 并返回
- 开始使用：授权完成后，我就可以帮你查询数据了
授权信息会保存在 ~/.wangke-auth-token 文件中，下次使用时无需重新授权。
可以查询的数据
录音相关
- 录音列表 - 查看录音文件列表，支持按日期范围、状态、用户等筛选。日期格式：
YYYY-MM-DD HH:mm:ss - 录音详情 - 查看指定录音的详细信息，包括转写文本
- 录音分析 - 获取 AI 对录音的分析结果（NLP）
- 录音搜索 - 按关键词搜索录音内容
使用示例：
- "显示最近10条录音记录"
- "查看录音 ID 为 12345 的详情"
- "查看今天的录音"
- "查看2026-04-01到2026-04-30的录音"
接访/接诊相关
- 接访列表 - 查看接访/接诊记录列表，支持按时间范围筛选
- 来访详情 - 查看指定来访的详细信息
- 虚拟接访 - 查看虚拟接访记录
使用示例：
- "显示今天的接访记录"
- "查看最近10条接访"
- "查看2026-04-01到2026-04-30的接访记录"
用户与项目
- 当前用户 - 查看当前登录用户的详细信息（姓名、手机号、角色等）
- 租户项目列表 - 查看当前用户有权限的所有租户和项目
- 切换项目 - 切换到指定的项目
使用示例：
- "查看当前登录的用户信息"
- "列出我有权限的所有租户和项目"
- "切换到项目 ID 为 xxx"
客户相关
- 客户列表 - 查看客户列表，支持按时间范围、客户类型、成交状态、客户来源、客户级别、意向程度、是否有录音等多维度筛选
- 客户详情 - 查看指定客户的详细信息
- 客户搜索 - 按姓名或手机号搜索客户
使用示例：
- "显示意向客户列表"
- "查看客户张三的详细信息"
- "搜索手机号为 138xxxx 的客户"
- "查看本周新增客户"
- "查看已成交客户列表"
技术实现
此技能使用以下技术实现：
-
授权管理 (
scripts/auth-manager.js)
- 启动本地 HTTP 服务器接收授权回调
- 生成授权二维码
- 管理 token 的存储和验证 -
API 客户端 (
scripts/api-client.js)
- 封装所有旺小美后端 API 调用
- 自动处理认证头（X-Auth-Token,X-Platform-Client）
- 统一的错误处理 -
授权页面 (
references/auth.html)
- 显示授权二维码
- 轮询授权状态
- 展示授权成功消息
API 端点
技能使用以下旺小美后端 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 版本：需要旺小美 App 支持扫码授权功能
清除授权
如果需要重新授权或更换账号，可以删除授权文件：
rm ~/.wangke-auth-token
或告诉我"清除授权"，我会帮你处理。
常见问题
Q: 授权失败怎么办？
A: 确保 App 已登录，网络连接正常，重新扫描二维码即可。
Q: Token 过期了怎么办？
A: 删除 ~/.wangke-auth-token 文件，重新进行授权即可。
Q: 可以同时使用多个账号吗？
A: 目前不支持，每次授权会覆盖之前的 token。
