批量处理与自动化

Subwright 支持批量队列、监控文件夹和自动化接口，把重复的音视频转写交给应用自己跑。

批量队列

添加文件

1. 在媒体库选中素材，点「加入转写队列」（或从侧栏打开「队列」）
2. 拖拽多个文件到队列，或点击「添加文件」
3. （可选）设置输出格式、保存路径与译文模式
4. 点击「开始批量转写」

队列管理

• 文件按添加顺序依次处理
• 可查看每个文件的进度和状态
• 支持暂停、继续、跳过、移除
• 每个文件可输出原文、双语或仅译文；半译不落盘
• 已完成文件可单独导出

监控文件夹

设置一个文件夹，放入新的音视频文件即自动转写：

1. 在设置中开启「监控文件夹」
2. 选择要监控的文件夹路径
3. 设置自动转写选项（语言、引擎、输出格式、译文模式）
4. 将文件放入该文件夹，转写自动开始
5. 结果自动保存到指定输出目录；可同时导出 SRT/VTT 到源文件旁

使用建议

• 配合下载文件夹使用：浏览器下载的视频自动转写
• 团队共享文件夹：多人协作时自动处理新文件
• 播客工作流：新一期音频放入即自动生成字幕

自动化与集成

• CLI：subwright transcribe <file> 支持 SRT / VTT / TXT / JSON、目录批处理与 --stream 进度；应用未运行时自动拉起（SUBWRIGHT_NO_LAUNCH=1 可关）。
• MCP：subwright mcp 提供 transcribe / status / list_transcripts / read_transcript / list_models，AI 客户端可直连。
• Webhook：转写完成或失败可按文件推送，支持 HMAC-SHA256 签名与自定义请求头。

批量分析

对多个转写结果进行聚合分析：

• 跨文件关键词搜索
• 统计概览（总时长、总字数、发言人分布）
• 生成对比报告

适合整理系列访谈、多期播客、季度会议记录等场景。