Subtitle Extractslator 是一个以技能包为主要交付物的字幕处理工具,运行时受 Loom SO 治理。根据资料,其主要目标包括:保持时间轴与字幕结构稳定、优先使用已有字幕资源再抽取、使用分组滚动上下文提升语义一致性,以及在智能体(MCP)与脚本(CLI)两种执行路径下保持行为一致。
用途与触发场景 当用户需要以下操作时可使用该技能:检查媒体文件是否已具备特定语言字幕;在本地抽取前先在线搜索字幕候选;在保留 SRT 时间轴和分句节奏的前提下翻译字幕;从媒体文件或已有字幕文件生成最终 SRT 文件。
主要能力与流程 高层流程为:规范化输入(媒体或 SRT、目标语言、输出路径);路由执行模式(MCP 或 CLI);探测内嵌轨道,然后检查本地文件,再进行 OpenSubtitles 搜索与下载;通过分组上下文感知处理进行翻译;合并并输出最终 SRT;如适用则更新批处理队列状态。对外接口包括 AskUser(MCP 设置、FFmpeg 路径、候选选择、显式策略)、McpCall(探测、抽取、搜索、下载、翻译工具)、WaitResume(批处理冷却、外部异步触发)以及 SubagentCall(worker 批处理委派)。
使用方式与命令 运行时需先通过包索引页解决对应通道的最新原生运行时,bootstrap 会打印可执行文件绝对路径。官方技能执行入口为: so.exe run --workflow-file <runtime-workflow-copy>.json so.exe resume --workflow-file <runtime-workflow-copy>.json --result-file <external-result>.json 在 Unix 上对应 so run 与 so resume。编译校验使用: so.exe compile --workflow-file assets/so-workflow/so-template.json [--audit-output <external-audit-root>] 运行时恢复引导使用: python3 assets/bootstrap/restore_runtime.py --channel beta Windows 上若 python3 不在 PATH 中则使用 py -3。
约束与规则 资料列出的护栏包括:保留时间戳与字幕顺序;非用户明确要求不合并或拆分字幕;结构校验失败即停止,绝不输出损坏的 SRT;保持确定性的源选择顺序;内嵌轨道缺失时先尝试本地字幕发现再走 OpenSubtitles;OpenSubtitles 搜索到下载保持严格串行;搜索需同时提供 searchQueryPrimary 与 searchQueryNormalized;OpenSubtitles 回退顺序保留在 C# 运行时而非技能侧并行扇出;认证走 login/aquire/status/clear cache 流程;出现限流信号后切换到延迟串行模式;队列状态存放于集中式临时存储而非媒体文件旁;中文内嵌字幕发现时将 zh 与 chi 视为等价回退偏好;媒体文件请求时额外把最终字幕复制到源视频旁并命名为 <original_video_basename>.<lang>.srt,除非用户明确要求更改;MCP 编排由智能体驱动而非脚本驱动工具循环;技能保持无二进制(binary-free),运行时从仓库的 packages.*.md 绝对 URL 获取;禁止用等价于运行多步计划的工作流节点步骤;不得将直接编辑 assets/so-workflow/so-template.json 当作常规维护方式,仅在受治理路径完全阻塞且用户明确允许时做最小变通,随后立即回到 so.exe compile 与受治理执行路径。
适用场景 适合需要对单个媒体文件或字幕文件做字幕探测、候选搜索、抽取与保时序翻译并生成 SRT 的任务,以及多文件的长时批处理队列(配合 batching、supervisor、worker 参考文档)。本地翻译或位图 OCR 的 HTTP 端点必须先通过真实健康检查,仅有 READY 之类的启动日志不足以证明端点可监听和使用。
限制与暂未提供的信息 该技能受 SO 治理,仅 so.exe run/resume(Unix 为 so run/so resume)计为官方技能运行与官方执行历史,直接 CLI 与直接 MCP 只是组件操作的运行时原语。模板已在 0.3.328 运行时上编译,但端到端运行仍需真实外部结果与输入。资料未提供具体收费、价格、支持的翻译语言对数量、翻译质量评测或性能指标,这些信息暂未提供。