用途：将字幕文件翻译为另一种语言，支持 SRT、VTT、ASS、TTML、JSON 等格式，可生成双语字幕，也可翻译 YouTube 视频转录。需要转录请用 /omnicaptions:transcribe；仅格式转换不做翻译请用 /omnicaptions:convert。
主要能力：默认使用 Claude 原生翻译，无需 API Key，输出后缀为 Claude{lang}。上下文感知翻译按批次处理，每批 30 行，前后各取 5 行作为上下文，有助于保持说话人语气、处理跨行句子、本地化习语与正确解析代词。
Gemini API（可选，仅用户明确要求时）：先安装 pip install omni-captions-skills --extra-index-url https://lattifai.github.io/pypi/simple/。API Key 优先级：GEMINI_API_KEY 环境变量 → .env 文件 → ~/.config/omnicaptions/config.json；未设置时会提示输入，随后用 -k <key> 运行并自动保存。示例：omnicaptions translate input.srt -l zh --bilingual，输出 input_Gemini_zh.srt。
CLI 选项：-k/--api-key、-o/--output、-l/--language（必填）、--bilingual、-m/--model（默认 gemini-3-flash-preview）、-v/--verbose。语言代码如 zh、zh-TW、ja、ko、en、es、fr、de。自定义术语表（即将推出）可用 --glossary terms.json；也可通过自定义 prompt 适配医疗等专业内容。
工作流建议：可与 LaiCut 对齐、convert 转换配合；大 JSON 文件先转为 SRT 再翻译。翻译方式与后缀：Claude 为 _Claude_zh，Gemini 为 _Gemini_zh。
限制：未设置 API Key 时 Gemini 不可用；ASS 样式可保留，SRT 仅支持基本格式；术语不一致可借助术语表。其余未在资料中说明的功能暂未提供。