旺小美数据助手

这是一个让AI能够查询旺小美系统数据的技能。通过扫码授权后，你可以让AI帮你查询录音、客户和接访等各类数据。

首次使用 - 授权流程

在使用此技能查询数据之前，需要先完成授权：

1. 发起授权：告诉我你想查询的数据（如"查看录音列表"）
2. 扫码授权：我会生成一个二维码，你用旺小美 App 扫描它
3. 自动完成：App 会自动获取当前登录的 token 并返回
4. 开始使用：授权完成后，我就可以帮你查询数据了

授权信息会保存在 ~/.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 的客户"
• "查看本周新增客户"
• "查看已成交客户列表"

技术实现

此技能使用以下技术实现：

1. 授权管理 (scripts/auth-manager.js)
• 启动本地 HTTP 服务器接收授权回调
• 生成授权二维码
• 管理 token 的存储和验证

1. API 客户端 (scripts/api-client.js)
• 封装所有旺小美后端 API 调用
• 自动处理认证头（X-Auth-Token, X-Platform-Client）
• 统一的错误处理

1. 授权页面 (references/auth.html)
• 显示授权二维码
• 轮询授权状态
• 展示授权成功消息

API 端点

技能使用以下旺小美后端 API：

注意事项

1. 授权有效期：授权 token 会持久化保存，直到手动清除
2. 数据安全：token 存储在本地文件中，权限设为仅用户可读写
3. 网络要求：需要能够访问 wangkeapp.wangxiaobao.com
4. App 版本：需要旺小美 App 支持扫码授权功能

清除授权

如果需要重新授权或更换账号，可以删除授权文件：

rm ~/.wangke-auth-token

或告诉我"清除授权"，我会帮你处理。

常见问题

Q: 授权失败怎么办？

A: 确保 App 已登录，网络连接正常，重新扫描二维码即可。

Q: Token 过期了怎么办？

A: 删除 ~/.wangke-auth-token 文件，重新进行授权即可。

Q: 可以同时使用多个账号吗？

A: 目前不支持，每次授权会覆盖之前的 token。