Agent Skills
返回列表
旺小美录音上传

旺小美录音上传

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9aa92135/wxm-record-upload。

技能介绍

要解决什么问题

工牌设备产生的录音往往还在本机路径里,业务侧需要的是 OSS 可访问 URL,以及工牌 IoT 侧能识别的 WORKCARDAUDIO 注册记录。手工操作要先调上传接口、再拼 Kafka 消息体,还容易搞错 group、fileType 或设备 sn。

技能如何工作

技能按固定两步串联完整上报:

  1. 上传到 OSS:POST https://alioss.wangxiaobao.com/minio/upload,multipart/form-data 携带 file、group(固定 /martech/wangke/audio)、name(建议 原文件名_时间戳.mp3)。
  2. 注册到工牌系统:用上一步返回的 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 消息体