旺小美录音上传
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9aa92135/wxm-record-upload。
技能介绍
要解决什么问题
工牌设备产生的录音往往还在本机路径里,业务侧需要的是 OSS 可访问 URL,以及工牌 IoT 侧能识别的 WORKCARDAUDIO 注册记录。手工操作要先调上传接口、再拼 Kafka 消息体,还容易搞错 group、fileType 或设备 sn。
技能如何工作
技能按固定两步串联完整上报:
- 上传到 OSS:
POSThttps://alioss.wangxiaobao.com/minio/upload,multipart/form-data携带file、group(固定/martech/wangke/audio)、name(建议原文件名_时间戳.mp3)。 - 注册到工牌系统:用上一步返回的
recordUrl与本地解析的fileSize、recordTime,向 Kafka 主题消息接口提交,type为WORK_CARD_AUDIO,file.fileType为AUDIO_COMPLETE。
用户用自然语言给出本地路径和设备 SN 即可;未说明环境时走 生产 URL,明确提到测试/test 时切换到测试集群地址。
适用边界与注意点
- 路径需真实存在,支持相对路径与绝对路径;OSS 或注册失败时应查看响应体里的具体错误。
sn格式需与工牌系统一致;recordUrl必须是 OSS 返回的有效地址。- 响应对应技能版本 wxm-record-upload v2.0.0,便于后续升级对照。
使用场景
- 现场拿到工牌导出的本地 mp3,需按规范路径上传到 OSS 并带上设备 SN 完成注册
- 联调工牌音频链路时,需把指定录音推到测试环境 Kafka 主题验证 `WORK_CARD_AUDIO`
- 生产环境 OSS 已上传成功但工牌侧未入库,需用同一文件信息重新走注册接口排查
- 用户口述「上传某路径录音、设备编号为某 SN」,需自动解析文件大小与时间戳并串联两步接口
适合人员
- 维护旺客/工牌音频链路的后端,需按固定字段对接 MinIO 上传与 Kafka 注册
- 负责 IoT 工牌设备的运维,经常要把本机录音补报到 `iot_device_file` 相关主题
- 测试同学需在测试集群复现 `AUDIO_COMPLETE` 上报,对比生产与 test 环境 URL 行为
- 对接旺小美业务的前端或脚本作者,不想手写 multipart 与 JSON 消息体