wxb-assistant

查询旺小宝系统的录音、接访、客户、盘客等数据。当你需要查看客户画像、盘客分析、录音详情时，使用此技能。适用于销售顾问、经理需要快速查询旺小宝数据的场景。当用户提到"录音"、"接访"、"客户画像"、"盘客"、"旺小宝"、"工牌接访"等相关术语时，或需要查询销售分析、客户数据时，应该触发此技能。

旺小宝数据助手

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

首次使用 - 授权流程

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

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

授权信息会保存在 ~/.wxb-auth-token 文件中，下次使用时无需重新授权。

可以查询的数据

录音查询

• 录音详情 - 获取单条录音的基础信息
• 录音文本 - 获取录音的转写文本内容
• 录音摘要 - 获取录音的AI摘要和问答
• 录音扩展 - 获取录音的扩展信息
• 录音评论 - 查看录音的评论列表
• 录音修改 - 修改录音显示名称
• 重新分析 - 重新进行语音识别(ASR)

使用示例：

• "查看录音 xxx 的详情"
• "查看录音 xxx 的文本内容"
• "查看录音 xxx 的摘要"
• "查看录音 xxx 的评论"

客户相关

• 客户列表 - 查看客户列表，支持多维度筛选
• 客户详情 - 查看指定客户的详细信息
• 客户画像 - 查看客户画像预测结果
• 客户旅程 - 查看客户综合来访跟进轨迹
• 关注点/抗性点 - 查看客户的关注点和抗性点

使用示例：

• "显示客户列表"
• "查看客户 xxx 的画像"
• "查看客户 xxx 的关注点"
• "查看客户的来访轨迹"

工牌接访

• 接访列表 - 查看工牌接访记录列表，支持分页和时间筛选
• 接访详情 - 查看指定工牌接访的详细信息
• 客户列表 - 查看工牌客户列表
• 搜索功能 - 搜索来访、客户、录音
• 看板数据 - 查看团队数据统计
• 接待管理 - 开始/结束接待、查询WiFi状态等

使用示例：

• "显示工牌接访列表"
• "查看工牌接访详情"
• "搜索工牌客户"

客户中心

• 客户管理 - 客户列表、详情、搜索
• 客户画像 - 查看画像预测结果、重新预测
• 客户轨迹 - 查看客户综合来访跟进轨迹
• 关注点/抗性点 - 查看客户的关注点和抗性点
• 虚拟接访 - 虚拟接访列表、详情、绑定录音等

使用示例：

• "显示客户中心列表"
• "查看虚拟接访记录"

盘客分析

• 盘客列表 - 分页查询盘客记录，支持筛选
• 盘客详情 - 查看盘客详情（含画像、买点、风控、关注点）
• 收集表 - 查看/提交/编辑盘客收集表
• AI辅助回想 - 获取AI辅助回想内容
• 金句内容 - 根据录音ID查询金句内容
• 金句认可 - 金句内容认可操作
• 分析任务 - 创建金句分析任务
• 销售意向 - 获取/更新销售意向级别
• 事件查询 - 通过客户ID获取事件ID
• 评论 - 查看/新增盘客评论

使用示例：

• "显示盘客列表"
• "查看盘客详情"
• "查看盘客画像"
• "查看盘客金句"

用户与项目

• 当前用户 - 查看当前登录用户的详细信息
• 租户项目列表 - 查看当前用户有权限的所有租户和项目
• 切换项目 - 切换到指定的项目

技术实现

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

1. 授权管理 (scripts/auth-manager.js)

   • 启动本地 HTTP 服务器接收授权回调
   • 生成授权二维码
   • 管理 token 的存储和验证

2. API 客户端 (scripts/api-client.js)

   • 主入口文件，提供统一访问接口
   • 自动处理认证头（X-Auth-Token, X-Platform-Client）
   • 统一的错误处理

3. 模块化 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

注意事项

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

清除授权

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

bash

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。