用途:这是统一的 ASR 路由层,不是独立引擎,底层仍由 Step ASR 与豆包 ASR 执行。它负责选择、体检、失败收敛与交接,面向本地音频或视频的转写任务。
主要能力与路由:只想要全文、摘要或内容分析时默认走 Step ASR(30 秒切片,失败片段可缩到 10/5 秒重试);需要较细时间戳、SRT 字幕,或口播停顿、填充词分析与自动粗剪时走豆包 ASR。用户明确指定单一服务商时不得跨服务商补齐。自动路由只允许在尚未向任何服务商提交任务时切换;如果已上传、提交或留下 request ID,必须恢复或报告该任务,不得向另一家重提同一媒体,以免重复计费。
用法:离线路由确认:python3 ~/.agents/skills/yichen-asr/scripts/route_asr.py --provider auto --text-only;需要字幕时加 --need-timestamps --need-srt。执行前先做只读体检:python3 ~/.agents/skills/yichen-asr/scripts/asr_doctor.py,它只报告密钥是否存在,不显示内容也不调用付费接口,token_present 仅代表本机有凭证,不代表账户有余额。Step 执行器通过 YICHEN_STEP_ASR_SCRIPT 指定已审计的兼容脚本,公开版不内置。豆包执行器为 python3 ~/.agents/skills/yichen-volc-asr/scripts/transcribe.py "/absolute/path/input.mp4" --transcribe-only,需要 SRT 与粗剪时去掉该参数,只生成分析不执行时加 --no-execute。
限制:余额和欠费状态只能登录火山引擎费用中心核验,ASR Token 无权读取;豆包余额未知时不得断言充足或不足。精确 SRT 需求不能因豆包不可用而悄悄降级为 Step 分块 Markdown。不输出 Cookie、Token 或 API Key,长期凭据只存钥匙串。不自动充值、不覆盖既有产物、不自动删临时文件,清理需用户明确允许。本 Skill 只负责已有本地音视频的 ASR,不负责搜索、下载或归档。