腾讯云语音识别 Skill

腾讯云语音识别（ASR），微信同款ASR引擎，历经亿级用户场景验证，稳定可靠。在中英混说场景下识别效果行业领先，精准流畅。支持普通话、方言及多语种识别，提供一句话识别、录音识别等全场景能力，是高性价比语音转文字首选。

核心执行流

1. 1. 用户给音频要转文字：

1. 2. 用户刚提供了新的腾讯云凭证：

1. 3. 用户问安装、开通、手工配置、FFmpeg、CLI backend：

下一步

• - 想接入宿主系统体验自动转写：

• - 想直接体验识别能力：

必须遵守的规则

• - ⚠️禁止用模型自身能力替代 ASR⚠️：脚本失败时，必须返回错误，不得猜测转写内容。
• 先探测后识别：统一先执行 python3 <SKILL_DIR>/scripts/inspect_audio.py "<AUDIO_INPUT>"。
• 缺 ffmpeg / ffprobe 先自治安装：先执行 python3 <SKILL_DIR>/scripts/ensure_ffmpeg.py --execute，只有失败后才向用户求助。
• 收到新凭证先自检：默认跑 python3 <SKILL_DIR>/scripts/self_check.py，不要先让用户手工试脚本。
• 默认少打断：除非用户必须补充凭证、明确要求手工配置，或语种/引擎确实不确定，否则不要无意义来回确认。
• 密钥安全优先：

• - 单次任务优先当前命令注入：不要为了跑一次识别去写 ~/.bashrc、INLINECODE14
• 不要把密钥写进工作区
• 极速版失败时保留“可能”表述：如果自检里一句话识别和录音文件识别通过、只有极速版失败，应提示“常见于国际站账号，或国内站账号在海外访问时受限”，但不要写成绝对结论。

引擎选择 Cheatsheet

对话语言只能当作先验，不等于音频语种本身。若用户音频语种明显不同，按音频语种改。

如果有多个明显可选项：

• - 给出推荐项
• 用一句话说清优缺点
• 再征询用户是否切换

路由速记

本地文件

• - 先规范化为 16kHz、单声道、pcm_s16le、INLINECODE40
• INLINECODE41 且 <=3MB：INLINECODE43
• INLINECODE44 且 <=100MB：优先 INLINECODE46
• 更大文件：优先切片后逐片走 Flash；若已有 COS / 公网 URL 且最终 <=5h，可走 INLINECODE48

公网 URL

• - 默认直接走 INLINECODE49
• 不要先本地下载、探测、转码再路由
• 只有 file_recognize.py rec 真实失败时，再按错误决定是否进入本地下载 / 规范化 / 切片链
• 如果用户明确要求同步立即返回，才把一句话识别当作显式特例，而不是默认路径

命中 URL、大文件、切片、body vs URL 取舍时，再读 routing_strategy.md。

最小脚本示例

CODEBLOCK0

何时继续读 references

• - 腾讯云账号开通 / 控制台找密钥 / 找 AppId：读 tencentcloudactivation.md
• 手工配置环境变量：读 envconfig.md
• 解释自检脚本或自检结果：读 selfcheck.md
• FFmpeg 自动安装失败后的最小化协助：读 ffmpegguide.md
• URL / 大文件 / 切片 / body vs URL 路由：读 routingstrategy.md
• 接入 OpenClaw / CLI transcription backend：读 clitranscriptionbackend.md
• 接入 QQ Bot 1.5.4 并绕过插件 STT / TTS 限制：读 qqbot_integration.md
• 查详细参数、引擎、错误码：

核心脚本清单

• - scripts/inspect_audio.py：音频探测
• INLINECODE52：自治安装 ffmpeg / INLINECODE54
• INLINECODE55：凭证与三种模式自检
• INLINECODE56：一句话识别
• INLINECODE57：录音文件识别极速版
• INLINECODE58：录音文件识别异步任务
• INLINECODE59：CLI backend wrapper