ra-video-wash-pipeline

视频洗稿工作流

目标

将源视频链接或本地视频文件转化为可投入生产的洗稿脚本：提取忠实的逐字稿，通过既定的 ra-洗稿流程重写，然后将获批脚本放入 01-内容生产/视频工作台/待制作/，作为具有约束力的制作依据。视频制作属于独立阶段，由队列中的任务触发（通常由制作主机通过 ra-video-production-director 执行）；只有用户明确提出要求时，才在同一会话中继续制作。

此技能是一个编排器。不要重复 ra-逐字稿提取skill、ra-洗稿、ra-人话、dbs-* 或 ra-video-production-director 中的详细规则；在各步骤由相应技能负责时，加载并遵循这些技能。

源内容隐私边界

使用此技能进行视频洗稿时，源逐字稿是内部工作材料，不是交付内容。

硬性规则：

• 不要在对话中打印、引用、总结或返回源视频的逐字稿。
• 除非用户明确要求提取逐字稿，否则不要在最终答复或交接文件中包含源视频标题、源 URL、源逐字稿路径或源文本片段。
• 如果逐字稿工具通常会打印完整逐字稿，请改用其内部／私密模式，或在不展示输出的情况下捕获结果。
• 如需重写，只能将源逐字稿存放在临时／内部位置。生成重写脚本和检查结果后，删除源逐字稿，除非用户明确要求保留。
• 只交付新脚本、重写后的开场钩子、质量检查、制作简报，以及不含源内容的事实更正。

路由

当输入是视频 URL 或本地视频文件，且用户想要重写或制作新视频时，使用此技能。

以下范围较窄的任务不要使用此技能：

• 仅提取逐字稿 -> 使用 ra-逐字稿提取skill
• 仅提供逐字稿或粗略文本 -> 使用 ra-洗稿
• 仅提供已完成的脚本或分镜 -> 使用 ra-video-production-director
• 不涉及视频制作的事实研究 -> 使用相关研究或写作工作流

如果请求中提到 视频洗稿、二创成新视频、洗稿并制作视频 或类似说法，则默认执行提取 -> 重写 -> 放入交接队列。只有用户明确说 直接制作、直接出片 或 一条龙 时，才在同一会话中继续制作。如果用户明确要求 只要逐字稿、只要脚本、先不要生成视频 或 只分析，则缩小任务范围。

工作流

1. 需求收集

记录最少必要信息：

• 源链接或本地文件
• 目标平台和画面比例；如果未指定，默认使用抖音横屏 16:9 视频
• 预期范围：仅脚本、10 秒样片或完整视频
• 视觉方向；默认采用 ra-video-production-director 中以白色为主的小黑体系
• 如果用户提到小黑配图、Ian 小黑或某个特定插画技能， 请将其保留为制作要求，而不是宽泛的风格 偏好
• 旁白；如果需要完整的 AI 旁白且不应复用源音频，默认使用用户的克隆声音

只有当答案会改变执行路径时才提问。否则选择保守的默认设置并继续。

查重硬门：拿到源链接后、提取逐字稿前，先运行 python3 automation/scripts/wash_ledger.py check "<url>"。退出码 3 = 已洗过：停下，把台账记录（时间、选题卡、产出去向）报给用户，用户明确确认重洗才继续；退出码 4 = 曾标记不做或标题疑似：提示一句后继续。查重结果只在会话里说，不写进任何产物。

2. 提取逐字稿

先调用 ra-逐字稿提取skill，但将其用作内部依赖。

对于抖音／小红书 URL，优先使用：

python3 "$ZT_HOME/scripts/transcript.py" "<url>" --internal --output-dir "<temporary_internal_dir>"

所需结果：

• 探测后提供平台、时长、分段数和预计等待时间
• 为 Agent 提供完整逐字稿文本，以便重写
• 不向用户暴露源逐字稿、源标题、源 URL、源文本片段或源逐字稿路径

如果提取因平台阻止访问或链接为私密而失败，请停止并向用户索取本地文件、公开链接或导出的字幕。不要根据猜测的逐字稿继续。

3. 改写脚本

将完整的转录稿和用户目标传入 ra-洗稿。

要求 ra-洗稿 运行默认流程：

1. ra-人话 改写
2. dbs-ai-check 诊断
3. dbs-hook 前 5 秒检查
4. dbs-resonate 共鸣检查
5. ra-video-title 候选标题：生成 8-12 个候选标题，并将 Top 3 推荐放入交接稿的标题候选部分（不选定最终标题——用户在发布时手动选择）
6. 仅当小红书图文/笔记标题属于本次范围时，使用 dbs-xhs-title

预期的改写输出：

• 新的口播脚本或逐字稿
• 最终钩子和第二句
• 发布标题候选及 Top 3 推荐（ra-video-title）
• AI 味道、开场、共鸣和小红书标题（如相关）的流程检查
• 交接约定内容：frontmatter 字段，以及每个分段的小黑插图意图、页面信息组件、字幕/动态说明和归档 slug

如果用户要求「只要脚本」，到此为止，只返回改写后的脚本和流程检查。不要返回源转录稿路径。

4. 将交接稿加入队列（默认终点）

要求 ra-洗稿 以默认终点收尾：将交接文件放在 01-内容生产/视频工作台/待制作/YYYY-MM-DD-<主题slug>/交接稿.md，并遵循 01-内容生产/视频工作台/_交接模板.md（先创建项目文件夹；交接稿放在文件夹内）。

结束前，确认：

• 交接文件存在，且 frontmatter 约定完整 （status: 待制作、平台、默认为 16:9 的比例、duration_target_s、 word_count、voice: pluvio-indextts2-calm-v1、 voice_provider: indextts2-local、 captions: asr-word-timestamps、caption_style: anchor-dark、visual、 illustration_skill）
• 标题候选部分包含 ra-video-title 生成的 8-12 个候选标题及 Top 3 推荐；不选定最终标题——用户之后手动选择
• 脚本正文拆分为多个分段，并为每段注明小黑插图意图和页面信息组件
• 文件中任何位置都没有源 URL、源标题、源转录稿或源转录稿路径
• 已添加洗稿台账条目（登记台账才算收尾）

台账登记（硬门）：交接稿与选题卡落地后，登记洗稿台账——优先使用 python3 automation/scripts/wash_ledger.py add --status washed --from-source-json "<.internal/<日期>-<平台>-download/…source.json>" --card "<选题卡相对路径>" --handoff "<交接稿相对路径>"（本流水线下载源视频时一定会有此文件）；未走下载、只有链接时，使用 --url "<源URL>" --title "<源标题>"；来自云端选题推荐时，加上 --work-id <云端作品id>。用户看完源内容后决定不洗稿时，也要执行 add --status skipped --url "<源URL>" --note "<原因>"，避免之后重复推荐。

然后停止，并返回交接文件路径，以及脚本和流程检查结果。 制作环节会作为单独阶段，从队列中领取任务。

5. 制作视频（仅在用户明确要求时）

仅当用户明确说「直接制作」「直接出片」或「一条龙」时： 调用 ra-video-production-director，将交接文件作为绑定的 制作约定，并附上：

• 不含来源信息的视频元数据和私有转录稿上下文
• ra-洗稿 流程检查结果
• 默认采用抖音横屏 16:9 画布和白底优先的小黑视觉系统，除非用户指定了其他风格
• 所需插图技能：只要用户要求小黑配图，或选择了白底优先的小黑默认方案，就使用 ian-xiaohei-illustrations

首次运行、风格有变更或动态方向不明确时，先渲染一个 10 秒样片。除非用户明确要求跳过样片确认环节，否则只有在样片获批后才继续制作完整视频。

6. 质检与归档（仅限明确要求制作）

让 ra-video-production-director 按照其常规质检和归档规则执行。

最低限度的最终检查：

• 最终 MP4 文件存在于 01-内容生产/视频工作台/已制作/<月上旬|月下旬>/<日期-主题>/成片/
• automation/scripts/check_delivery.py 已针对交接文件、项目目录和最终 MP4 文件通过检查
• 交接文件中的制作端回执已填写，status: 已完成，且 01-内容生产/视频工作台/已制作/<月上旬|月下旬>/<日期-主题>/ 已整理好，其中包含交接文件、成片/ 下的最终 MP4 副本，以及 质检/ 下的关键质检帧
• 已记录改写后的脚本路径；源转录稿路径保持私密或已删除
• 字幕使用安全区域，且不含意外的 UI 帧
• 通过 ra-audio-to-subtitles，使用与最终音频完全一致的音频生成制作字幕；caption-qc.json 检查通过；skill-captions 应用了交接文件中的 caption_style（默认值为 anchor-dark），并生成了检查通过的 caption-render-qc.json；未使用字符数计时
• 页面基础布局保持稳定；动画在组件上实现
• Xiaohei 插画通过 ian-xiaohei-illustrations 生成，保存为项目资源，由渲染流程直接加载，并用于说明当前要点，而非仅作装饰
• 代表性帧确认内容逐步呈现，且没有文字重叠

输出

对于默认的交接完成情形，返回：

交接文件：
[01-内容生产/视频工作台/待制作/YYYY-MM-DD-<slug>/交接稿.md]

标题候选：
[Top 3 推荐；完整候选见交接文件]

新逐字稿/脚本：
[script]

流程检查：
- AI 味：
- 开头：
- 共鸣：
- 小红书标题（如适用）：

对于仅完成脚本（只要脚本）的情形，返回相同代码块，但不包含交接文件这一行，并且不要创建队列文件。

对于明确要求在会话中完成制作的情形，返回：

成片：
[final MP4 path]

质检：
[key QC path]

过程资产：
- 新脚本：

规格：
[ratio, resolution, duration, codecs]

限制：
[only if something remains]