rabbitmeaw 批量视频 ASR 转写 (bailian-echo)
基于阿里云百炼 CLI bl speech recognize (fun-asr)，将视频文件夹批量转写为结构化 Excel / CSV。
Phase 0：环境自举
Agent 主动在本机终端内完成所有安装和配置，仅在无权限时向用户说明。
0.1 Node.js
node -v # ≥ 22.12.0
未安装或版本不足：Agent 自行安装（macOS: brew install node；Linux: nvm）。
0.2 npm
npm -v
禁止用 pnpm / yarn 安装 bailian-cli。
0.3 百炼 CLI
bl --version || npm install -g bailian-cli
which bl # Windows: where bl
0.4 百炼 Skills
npx skills add modelstudioai/cli --all -g
0.5 鉴权
API Key 读取优先级：--api-key > DASHSCOPE_API_KEY > ~/.bailian/config.json
Step 1 — 检查：
bl auth status --output json
api_key.configured: true → 跳过鉴权。
Step 2 — 浏览器登录（桌面环境，首选）：
bl auth login --console
拉起浏览器 → 登录阿里云 → 自动写入 config。30s 超时 → Step 3。
百炼 --console 一键完成「登录 + 自动创建 API Key」，无需单独去控制台。
Step 3 — API Key（无浏览器 / 超时回退）：
- 引导用户从 百炼控制台 获取 API Key
- Agent 执行：
bl auth login --api-key <Key>（禁止把 Key 写入回复正文）
Step 4 — 校验：
bl auth status --output json # api_key.configured: true
进阶提示（鉴权完成后告知，非强制）：
export DASHSCOPE_API_KEY="<Key>" # 写入 ~/.zshrc，不落盘到 config.json
0.6 Python openpyxl
pip3 install openpyxl
0.7 全量验证
bl auth status --output json | python3 -c "import sys,json; d=json.load(sys.stdin); assert d['authenticated'] and d['api_key']['configured']"
python3 -c "import openpyxl"
echo "ALL CHECKS PASSED"
Phase 1：确定参数 & 执行转写
环境就绪后，从用户输入中提取参数。
批量模式（--folder）
| 参数 | 来源 | 默认值 |
|---|---|---|
--folder |
用户提供的文件夹路径 | 必填 |
--format |
用户说 "csv" → csv | xlsx |
--output |
用户指定 | 源文件夹内自动命名 |
--concurrency |
用户说 "并行"/"加速"/"--concurrency N" | 3 |
python3 <skill_dir>/assets/batch_asr.py \
--folder "<路径>" \
--format <xlsx|csv> \
[--output "<路径>"] \
[--concurrency <N>]
单文件模式（--file）
用户指定单个视频文件时使用。输出纯文本到终端或文件。
| 参数 | 说明 |
|---|---|
--file / -i |
单个视频文件路径 |
--timed / -t |
输出带 [MM:SS.ms→MM:SS.ms] 时间码文本 |
--output / -o |
保存到文件（默认打印到终端） |
# 纯文本（终端输出）
python3 <skill_dir>/assets/batch_asr.py --file video.mp4
# 带时间码（终端输出）
python3 <skill_dir>/assets/batch_asr.py --file video.mp4 --timed
# 带时间码保存到文件
python3 <skill_dir>/assets/batch_asr.py --file video.mp4 --timed -o result.txt
Phase 2：汇报
- 成功/失败计数 + 总耗时 + 输出文件路径
- 不要逐字复制转写文本（可能很长），给出摘要 + 路径即可
输出
| 列名 | 来源 |
|---|---|
| 文件名 | 原始文件名 |
| 文件路径 | 绝对路径 |
| 时长(秒) | ASR JSON original_duration_in_milliseconds |
| 文件大小(MB) | os.stat |
| 完整文本 | fun-asr 转写全文 |
| 带时间码文本 | 句级时间戳 [MM:SS.ms→MM:SS.ms] 文本 |
| 处理状态 | 成功 / 失败 |
| 处理耗时(秒) | 计时 |
| 错误信息 | 失败时 |
Excel 输出：蓝底白字表头、冻结首行、自动筛选。
文件命名：ASR转写结果_{文件夹名}_{时间戳}.xlsx（或 .csv），默认在源文件夹中。
支持格式
.mp4 .mov .mkv .avi .webm .flv .wmv .m4v .ts .mts .m2ts .3gp .ogv .mpg .mpeg .rmvb .asf .vob
仅处理文件夹顶级文件。
脚本路径
assets/batch_asr.py