旺小宝数据助手
这是一个让AI能够查询旺小宝系统数据的技能。通过扫码授权后，你可以让AI帮你查询录音、客户、盘客等各类数据。
首次使用 - 授权流程
在使用此技能查询数据之前，需要先完成授权：
- 发起授权：告诉我你想查询的数据（如"查看客户列表"）
- 扫码授权：我会生成一个二维码，你用旺小宝 App 扫描它
- 自动完成：App 会自动获取当前登录的 token 并返回
- 开始使用：授权完成后，我就可以帮你查询数据了
授权信息会保存在 ~/.wxb-auth-token 文件中，下次使用时无需重新授权。
可以查询的数据
录音查询
- 录音详情 - 获取单条录音的基础信息
- 录音文本 - 获取录音的转写文本内容
- 录音摘要 - 获取录音的AI摘要和问答
- 录音扩展 - 获取录音的扩展信息
- 录音评论 - 查看录音的评论列表
- 录音修改 - 修改录音显示名称
- 重新分析 - 重新进行语音识别(ASR)
使用示例：
- "查看录音 xxx 的详情"
- "查看录音 xxx 的文本内容"
- "查看录音 xxx 的摘要"
- "查看录音 xxx 的评论"
客户相关
- 客户列表 - 查看客户列表，支持多维度筛选
- 客户详情 - 查看指定客户的详细信息
- 客户画像 - 查看客户画像预测结果
- 客户旅程 - 查看客户综合来访跟进轨迹
- 关注点/抗性点 - 查看客户的关注点和抗性点
使用示例：
- "显示客户列表"
- "查看客户 xxx 的画像"
- "查看客户 xxx 的关注点"
- "查看客户的来访轨迹"
工牌接访
- 接访列表 - 查看工牌接访记录列表，支持分页和时间筛选
- 接访详情 - 查看指定工牌接访的详细信息
- 客户列表 - 查看工牌客户列表
- 搜索功能 - 搜索来访、客户、录音
- 看板数据 - 查看团队数据统计
- 接待管理 - 开始/结束接待、查询WiFi状态等
使用示例：
- "显示工牌接访列表"
- "查看工牌接访详情"
- "搜索工牌客户"
客户中心
- 客户管理 - 客户列表、详情、搜索
- 客户画像 - 查看画像预测结果、重新预测
- 客户轨迹 - 查看客户综合来访跟进轨迹
- 关注点/抗性点 - 查看客户的关注点和抗性点
- 虚拟接访 - 虚拟接访列表、详情、绑定录音等
使用示例：
- "显示客户中心列表"
- "查看虚拟接访记录"
盘客分析
- 盘客列表 - 分页查询盘客记录，支持筛选
- 盘客详情 - 查看盘客详情（含画像、买点、风控、关注点）
- 收集表 - 查看/提交/编辑盘客收集表
- AI辅助回想 - 获取AI辅助回想内容
- 金句内容 - 根据录音ID查询金句内容
- 金句认可 - 金句内容认可操作
- 分析任务 - 创建金句分析任务
- 销售意向 - 获取/更新销售意向级别
- 事件查询 - 通过客户ID获取事件ID
- 评论 - 查看/新增盘客评论
使用示例：
- "显示盘客列表"
- "查看盘客详情"
- "查看盘客画像"
- "查看盘客金句"
用户与项目
- 当前用户 - 查看当前登录用户的详细信息
- 租户项目列表 - 查看当前用户有权限的所有租户和项目
- 切换项目 - 切换到指定的项目
技术实现
此技能使用以下技术实现：
-
授权管理 (
scripts/auth-manager.js)
- 启动本地 HTTP 服务器接收授权回调
- 生成授权二维码
- 管理 token 的存储和验证 -
API 客户端 (
scripts/api-client.js)
- 主入口文件，提供统一访问接口
- 自动处理认证头（X-Auth-Token,X-Platform-Client）
- 统一的错误处理 -
模块化 API (
scripts/api/)
-visit-api.js- 工牌接访相关接口
-customer-api.js- 客户中心相关接口
-audio-api.js- 录音查询相关接口
-panke-api.js- 盘客相关接口
-other-api.js- 其他功能（今日代办等）
API 端点
技能使用以下旺小宝后端 API：
录音查询
| 功能 | 方法 | 端点 |
|---|---|---|
| 录音列表 | POST | /ai-voice/app/audio/page |
| 录音详情 | GET | /ai-voice/audio/detail/{audioId} |
| 录音视频 | GET | /ai-voice/audio/video/{audioId} |
| 录音分析 | GET | /ai-voice/app/audio/nlp-result/{audioId} |
| 录音文本搜索 | POST | /ai-voice/app/visit/audio-split-text |
| 编辑录音 | POST | /ai-voice/audio/edit/valid |
| 绑定接访 | POST | /ai-voice/audio/bind-visit |
| 解绑录音 | POST | /ai-voice/visit/unbind-audios |
| 基础信息 | GET | /audio/app/v2/audio/base/{id} |
| 录音文本 | GET | /audio/app/v2/audio/base/text/{id} |
| 录音评论 | GET | /audio/app/v2/audio/commentary/{id} |
| 评论文本 | GET | /audio/app/v2/commentary/text/{audioId} |
| 摘要问答 | GET | /audio/app/v2/audio/agi/summary/dialogue/{id} |
| 录音扩展 | GET | /audio/app/v2/audio/expand/{id} |
| 录音卡片 | GET | /audio/app/v2/audio/base/card/{id} |
| 音频分享 | POST | /audio/app/v2/audio/share |
客户中心
| 功能 | 方法 | 端点 |
|---|---|---|
| 客户列表 | POST | /customer/customer/list |
| 单个客户 | GET | /customer/customer/list/one |
| 搜索客户 | GET | /customer/customer/search |
| 客户详情 | GET | /customer/customer/detail/{wangId} |
| 客户轨迹 | GET | /customer/customer/trajectory |
| 关注点 | GET | /customer/customer/focus/wang/list |
| 抗性点 | GET | /customer/customer/point/wang/list |
| 画像预测 | GET | /customer/predict/can-view |
| 重新预测 | POST | /customer/predict/re-predict/{wangId} |
工牌接访
| 功能 | 方法 | 端点 |
|---|---|---|
| 接访列表 | POST | /ai-voice/app/visit/page |
| 客户列表 | POST | /ai-voice/app/customer/page |
| 接访详情 | GET | /ai-voice/app/visit/{id} |
| 搜索来访 | GET | /ai-voice/app/search/visit/page |
| 搜索客户 | GET | /ai-voice/app/search/customer/page |
| 搜索录音 | GET | /ai-voice/app/search/audio/page |
| 看板来访列表 | POST | /ai-voice/board/visit:page |
| 团队用户统计 | POST | /ai-voice/board/user:stat |
| 团队统计 | POST | /ai-voice/board/team:stat |
| WiFi状态 | GET | /ai-voice/app/visit/manager/wifi-status |
| 开始接待 | POST | /ai-voice/app/visit/manager/start |
| 结束接访 | POST | /ai-voice/app/visit/manager/end |
| 开始录音 | GET | /ai-voice/app/visit/manager/start-visit-audio |
| 结束录音 | GET | /ai-voice/app/visit/manager/stop-visit-audio |
盘客
| 功能 | 方法 | 端点 |
|---|---|---|
| 盘客列表 | POST | /panke/app/panke/page |
| 盘客进度率 | POST | /panke/app/panke/page/score |
| 盘客筛选条件 | GET | /panke/common/searchCondition |
| 盘客权限 | GET | /panke/permission |
| 盘客详情 | GET | /panke/app/panke/detail |
| 盘客详情V2 | GET | /panke/app/panke/v2/detail |
| 客户中心盘客详情 | GET | /panke/app/panke/wang/v2/detail |
| 盘客画像 | GET | /panke/app/panke/complete-table |
| 盘客画像V2 | GET | /panke/app/panke/v2/complete-table |
| 盘客买点 | GET | /panke/app/panke/customer/selling-point-reach |
| 盘客风控 | GET | /panke/risk/list |
| 盘客关注点 | GET | /panke/focus/list |
| 客户来访信息 | POST | /panke/app/panke/tableCusVisitInfo |
| 收集表 | GET | /panke/app/panke/table |
| 提交收集表 | POST | /panke/app/panke/table |
| 编辑收集表字段 | POST | /panke/app/panke/table/field |
| 收集表校验 | GET | /panke/app/panke/check-table |
| 标记特殊来访 | POST | /panke/app/panke/mark-special-visits |
| AI辅助回想 | GET | /panke/app/panke/ai-assisted-recall |
| 金句内容 | POST | /panke/panke/new/sop/getGoldenContentByAudioId |
| 金句认可 | POST | /panke/panke/new/sop/goldenContentAccept |
| 创建分析任务 | POST | /panke/panke/sop/createGoldenAnalysisTask |
| 销售意向级别 | GET | /panke/panke/sop/v1/options/salesPitchIntent |
| 更新销售意向 | POST | /panke/panke/sop/v1/options/salesPitchIntent/update |
| SOP2阶段状态 | GET | /panke/panke/new/sop/two/stage/result/status |
| SOP2阶段概览 | GET | /panke/panke/new/sop/two/stage/sketch |
| 评论列表 | GET | /panke/comment/list |
| 新增评论 | POST | /panke/comment/add |
| 获取事件ID | GET | /panke/app/panke/wang/event/detail |
| 获取盘客ID | GET | /panke/app/panke/get-pankeId-by-visitId |
今日代办
| 功能 | 方法 | 端点 |
|---|---|---|
| 待办统计 | GET | /ai-voice/app/virtually/visit/virtually-today-todo:count |
| 待办列表 | GET | /ai-voice/app/virtually/visit/virtually-today-todo:all |
| 待办详情 | GET | /ai-voice/app/virtually/visit/virtually-today-todo/{id} |
用户与项目
| 功能 | 方法 | 端点 |
|---|---|---|
| 用户信息 | GET | /saas/v2/user/info |
| 租户项目列表 | GET | /saas/v2/estate/tenant-and-estate/by-user-id |
| 切换项目 | POST | /session/switch-project |
| 切换租户 | POST | /session/switch-tenant |
注意事项
- 授权有效期：授权 token 会持久化保存，直到手动清除
- 数据安全：token 存储在本地文件中，权限设为仅用户可读写
- 网络要求：需要能够访问
wangkeapp.wangxiaobao.com和www.wangxiaobao.com - App 版本：需要旺小宝 App 支持扫码授权功能
- 模块化调用：支持传统调用方式和模块化调用方式两种
清除授权
如果需要重新授权或更换账号，可以删除授权文件：
rm ~/.wxb-auth-token
或告诉我"清除授权"，我会帮你处理。
常见问题
Q: 授权失败怎么办？
A: 确保 App 已登录，网络连接正常，重新扫描二维码即可。
Q: Token 过期了怎么办？
A: 删除 ~/.wxb-auth-token 文件，重新进行授权即可。
Q: 如何使用模块化 API？
A: 可以直接调用 api-client.js 中对应的模块，如 visit.getVisitPage()、customer.getCustomerPage() 等。
Q: 可以同时使用多个账号吗？
A: 目前不支持，每次授权会覆盖之前的 token。
