wjs-localizing-video（编排器）

该能力已被拆分。 原先那个 1300 行、包罗万象的单体能力，现已重构为 4 个专注明确的子能力。**仅当用户在单次请求中明确要求执行完整流水线时**，才调用本编排器；若用户仅需其中某一步骤，请直接路由至对应子能力。

四个子能力

第 3 和第 4 步为可选且相互独立：大多数“仅字幕”任务在第 2 步完成后即终止，并通过 /wjs-burning-subtitles 进行软封装（soft-mux）；大多数“仅配音”任务则在第 3 步后结束。

何时调用本编排器 vs 直接调用子能力

请调用本能力（wjs-localizing-video），当用户一次性提出完整流程需求时：

• “帮我把这个西班牙语视频做成中文字幕和中文配音”
• “translate this Spanish video to English with dubbing”
• “全套：转写、翻译、烧字幕、配音、混音”

请直接调用子能力，当用户仅提出单一环节需求时：

• “转写一下这个音频” → /wjs-transcribing-audio
• “把这个 SRT 翻译成中文” → /wjs-translating-subtitles
• “给这个视频配个中文音” → /wjs-dubbing-video
• “把字幕烧进视频” → /wjs-burning-subtitles

各子能力职责更聚焦，其输入/输出契约也定义得更为严谨。若用户请求本身仅涉及单一步骤，请勿经由本编排器中转——否则你将阅读大量与当前任务无关的文档。

进度检查清单（务必在调用任一子能力前完成）

整条流水线最多含四个步骤，总耗时数分钟。用户期望看到实时进度反馈，而非长时间静默后突然返回成品文件。**在调用首个子能力前，必须预先创建一份 TaskCreate 格式的计划步骤清单。** 每当启动某一步骤时，将其状态更新为 in_progress；完成时立即标记为 completed。Claude Code 将在 UI 中以实时勾选形式渲染该清单。

应创建哪些任务

根据用户请求判断将执行哪几个步骤：

请勿为不执行的步骤创建任务项——末尾未勾选的条目会被理解为“遗漏”，而非“主动跳过”。

任务标题的表述规范

使用与下方“最终响应模板”中完全一致的标签命名方式，确保运行中的清单与最终完成摘要呈现为同一份连贯产物：

• 转写 （例如：转写 西班牙语）
• 翻译 → （例如：翻译 → 中文）
• 配音 （例如：配音 中文 (高冷御姐 -8%)）
• 烧字幕 + 原声底层 （例如：烧字幕 + 原声底层 0.18）

对于 activeForm 字段，请使用进行时变体（转写中…、翻译中…、配音中…、合成中…）。

状态管理规范

• 仅将当前正在执行的任务标记为 in_progress（一次仅一个）。
• 子能力返回输出文件后，立即标记为 completed —— 不要批量更新。
• 若某步骤触发澄清提问或执行失败，保持其状态为 in_progress，以便用户清晰识别流水线中断位置；切勿将未完成步骤标记为 completed。
• 若用户在流水线中途变更指令（如“跳过配音”），请同步更新剩余任务：删除不再适用的条目，保留其余任务；切勿静默丢弃。

标准端到端流水线示例（西班牙语 → 中文，含配音 + 底层音 + 烧录）

此为原始“验证场景”——将西班牙语瑜伽/灵性类内容本地化为简体中文，用于微信视频号 / 小红书平台。完整覆盖全部 4 个子能力。

步骤 1 — 转写西班牙语源内容

调用 /wjs-transcribing-audio，传入视频文件及参数 `--language es`。

该子能力负责：音频分块、词级时间戳、基于标点边界的字幕段组装、循环防护、自动重试。输出：entrevista.srt（西班牙语，源语言）。

步骤 2 — 翻译为简体中文

调用 /wjs-translating-subtitles，传入西班牙语 SRT 及目标语言 `zh-CN`。

该子能力负责：基于标点重新切分字幕段、最小化填充式指示代词、限制单行长度、保留说话人语气风格。输出：entrevista.zh-CN.srt。

步骤 3 — （可选）中文配音

调用 /wjs-dubbing-video，传入视频 + entrevista.zh-CN.srt + 声音 ID。

成熟沉思型女性声音默认值：zh_female_gaolengyujie_moon_bigtts（Volcano 高冷御姐，参数 --rate -8% +0Hz）。若无 Volcano 凭据，则回退为：zh-CN-XiaoxiaoNeural --rate -8% --pitch -10Hz。该子能力先采样预览，确认后再正式生成。

输出：entrevista_zh_dub.mp4。

步骤 4 — 烧录字幕 + 将配音与原声底层混合

调用 /wjs-burning-subtitles，参数为 --video entrevista.mp4 --srt entrevista.zh-CN.srt --dub entrevista_zh_dub.mp4

该子能力负责：libass 可用性检测、evermeet 静态构建回退机制、字体大小自适应校准、全量渲染前逐帧校验、底层音频混音音量设为 0.18。

输出：entrevista_zh_final.mp4（可直接交付发布）。

用户已标准化的默认配置

以下规则贯穿整条流水线；各子能力在其职责范围内分别强制执行：

• 中文语音识别优先调用豆包（Volcano），Whisper 作为备用方案。 由 /wjs-transcribing-audio 强制执行。
• 整段配音统一使用单一声音，除非用户明确指出需区分多个说话人。 由 /wjs-dubbing-video 强制执行。
• 任何配音均保留原始音频作为低音量底层（0.15–0.25）。 由 /wjs-burning-subtitles 强制执行。
• 微信视频号 / 抖音平台默认烧录字幕；其余平台默认软封装（soft-mux）。 由 /wjs-burning-subtitles 强制执行。
• 频道 CTA 名称（如添加至视频描述中）统一为：王建硕 —— 绝不使用嘉宾姓名。（该规则源自全局配置 ~/.claude/CLAUDE.md；当本流水线后续衔接 /wjs-uploading-video 时生效）

文件命名规范（继承自原始能力）

输入：                       entrevista.mp4

中文流水线：
  源语言 SRT                 entrevista.srt
  中文 SRT                   entrevista.zh-CN.srt
  中文配音（纯音频）         entrevista_zh_dub.mp4
  中文最终成品（字幕+配音）  entrevista_zh_final.mp4

英文流水线：
  英文 SRT                   entrevista.en.srt
  英文配音                   entrevista_en_dub.mp4
  英文最终成品               entrevista_en_final.mp4

双语字幕：
  西班牙语 + 中文             entrevista.es-zh.srt
  西班牙语 + 英文             entrevista.es-en.srt
  三语字幕                   entrevista.es-zh-en.srt

采用 BCP-47 风格后缀，便于多目标语言输出并存，且一眼即可识别目标语言。

本编排器不承担的职责

• 它不重复实现任何逻辑。所有步骤均委托至对应子能力执行。
• 它不打包脚本文件。dub.py 位于 /wjs-dubbing-video/scripts/，render.py 位于 /wjs-burning-subtitles/scripts/，visual_diarize.py 位于 /wjs-dubbing-video/scripts/。若发现 wjs-localizing-video/scripts/ 下存在陈旧副本，请始终优先采用子能力自身的权威路径。

最终响应模板

当整条流水线成功完成时，请用用户的自然语言作简明回复，并严格匹配用户习惯的“已完成”格式：

已完成：
- 西班牙语转写  (/wjs-transcribing-audio)
- 中文翻译     (/wjs-translating-subtitles)
- 中文配音     (/wjs-dubbing-video, voice: 高冷御姐 -8%)
- 烧入字幕 + 原声底层 0.18  (/wjs-burning-subtitles)

输出：
- entrevista.srt
- entrevista.zh-CN.srt
- entrevista_zh_dub.mp4
- entrevista_zh_final.mp4

不确定片段：
- 00:01:23–00:01:26 背景噪音较大，原文可能不完全准确。

若无不确定片段，请省略最后一项列表。

参阅

• /wjs-segmenting-video — 将长视频切分为独立短视频片段（使用其专属 SRT 切片器；与本流水线正交）。
• /wjs-overlaying-video — 基于 HyperFrames 在视频片段上叠加 HTML/CSS 字幕。 请勿与 /wjs-burning-subtitles 混用 —— 每个输出仅选用一种字幕系统。
• /wjs-uploading-video — 将最终 MP4 推送至 YouTube。
• /lark-minutes — 当本地豆包 ASR 尚未接入时，提供飞书妙记作为纯中文转录路径的替代方案。