| name | translate-redstone |
| description | 用于Minecraft红石技术视频字幕的精细翻译。每次处理一个视频，先扫描术语并补齐知识，翻译后进入人工审核循环。 |
红石技术字幕翻译官
定位：Minecraft 红石技术视频字幕的精细翻译——先扫描术语补齐知识，翻译后进入人工审核循环。
适用范围
- 一次一个视频，精细翻译，不批量处理
- 纯文本翻译，不依赖视频画面或音频（成本/渠道限制）
- 输入以 SRT 为主，YouTube transcript（无时间码纯文本）为次
输入 / 输出
工作目录
| 目录 | 角色 | 读写 |
|---|
_input/ | 待翻译字幕入口 | 只读输入 |
_output/ | 最终交付输出 | 写正式稿 |
_work/<视频名>/ | 中间产物 + 断点恢复 + 临时脚本 | 只读写当前视频子目录 |
工作区隔离（临时脚本禁写 scripts/、禁止参考其它视频等）见 redstone-conventions#工作区隔离。
输入
用户将待翻译文件放入 _input/。Agent 自动检测：
| 格式 | 特征 | 处理方式 |
|---|
| SRT | 有时间码，逐句分段 | 首选格式，保留时间码输出到 _output/ |
| YouTube transcript | 无时间码，纯文本段落 | 先按句分割，输出到 _output/ 不保留时间码 |
输出
翻译结果写入 _output/，文件名同输入。默认输出双语对照（原文 + 中文翻译），输出变体见 redstone-conventions#语言顺序与输出变体（bilingual 默认 / zh-only / annotated）。
语言顺序固定 en-zh、脚本 --order 约定见 redstone-conventions#语言顺序与输出变体。
中间产物与断点恢复
全流程各阶段（子 skill）的输入与产物：
- 阶段〇 领域预判与准备（
redstone-preprocess）——加载领域知识/预判，无落盘产物
- 阶段一 术语扫描与知识补齐（
redstone-preprocess）
- 输入：
_input/ 原始字幕
- 产物：
- §1.1 术语扫描 →
<工作目录>/01_subtitle_asr_fixed.srt
- §1.3 术语确认 →
<工作目录>/02_terms.md
- 阶段门禁：
01/02 交用户确认，确认后才进阶段二（阶段间确认是本工作流的流程控制，Agent 不得擅自跨阶段）
- 阶段二 正式翻译（本工作流）
- 输入：
01_subtitle_asr_fixed.srt + 02_terms.md
- 执行一律 subagent（块数由骨架决定，无需报告用/不用），块级产物 + 合并稿：
- 分块 →
<工作目录>/chunks/（01 text_chunk.py --type srt 分块骨架）
- 合并断句 →
<工作目录>/_merge_results/chunk_<k>.txt → text_merge.py 合并 → <工作目录>/s03_plan.md
- 逐段翻译 →
<工作目录>/_trans_results/chunk_<k>.txt → text_merge.py 合并 → <工作目录>/s04_draft.srt（标准 SRT 双语）
- 校验（机械，硬闸门）：断句措辞一致性（
srt_check_plan_words.py）/ 术语全量核对（srt_check_terms.py）/ 行宽（srt_check_width.py >26 打回）
- 阶段二+ 去翻译腔（
humanizer-zh，可选）
- 输入：
s04_draft.srt 全稿
- 产物：修订稿（回写
s04）
- 阶段二½ 人工审核（
redstone-review）
- 输入：待审方案 + 翻译结果（
s03 / s04）
- 产物：用户确认（无新落盘）
- 阶段三 数据源总结（
redstone-finalize）
- 输入：确认后的完整成果
- 产物：
.github/experience/ 追加（coverage_log / source_experience）
中断恢复路由：检查 _work/<视频名>/ 最完整产物，从产出该产物的阶段开头继续（假设该阶段异常中断、产物可能不完整）：
- 无任何产物 → 从头开始（阶段〇）
- 仅
01_subtitle_asr_fixed.srt → 阶段一 §1.1 开头（重新第一次遍历，确保 01 完整；有 _en_chunks/ + 部分 _en_results/ → 步骤 2 补派缺失块后 srt_join_parts.py 合并）
- 有
02_terms.md → 阶段一 §1.3 开头（重新术语确认；§1.4 入库照做）
- 有
chunks/（01 分块骨架，无 _merge_results/）→ 阶段二 合并断句派发开头（逐块派发 task-merge）
- 有
_merge_results/ 部分 → 补派缺失断句块后 text_merge.py 合并 → s03_plan.md（断句措辞/时间校验通过后进翻译）
- 有
s03_plan.md（无 _trans_results/）→ 阶段二 翻译派发开头（逐块派发 task-translate）
- 有
_trans_results/ 部分 → 断点续译（补派缺失翻译块后 text_merge.py 合并 → s04_draft.srt）
- 有
s04_draft.srt → 阶段二½ 人工审核（或阶段二+ 去翻译腔）
各阶段结束立即落盘（conventions「断点恢复」）；中间产物是工作底稿，禁止自动删除（AGENTS.md #6），清理提示用户手动执行。
依赖（扩展 Skill 地图）
| 话题 | 权威 Skill |
|---|
| 通用规则（环境/工作区/分块/门禁等） | redstone-conventions |
| 翻译前置（阶段〇/一） | redstone-preprocess |
| 人工审核（阶段二½）+ 输出门禁 | redstone-review |
| 数据源总结（阶段三） | redstone-finalize |
| 断句/合并/行宽 | segment-subtitles |
| subagent 派发 | subagent-dispatch |
| 术语表加载/四级查找 | use-glossary |
| 术语扫描机制（ASR 解码/scan 覆盖网） | term-scan |
| 术语登记 | term-registration |
| CSV 读写/表头 | csv-rules |
| Wiki 抓取/兜底 | wiki-tools |
| 去翻译腔 | humanizer-zh |
| 知识/索引维护 | maintain-knowledge |
注意事项
通用规则
见 redstone-conventions（环境 / 工作区隔离 / 断点恢复 / en-zh / 时间纪律 / 长视频分块 / 输出门禁 / 禁删）+ AGENTS.md（项目原则）。
特有规则
时间戳
- 输出 SRT 的所有时间边界必须 ⊆ 原字幕边界集合（不允许新造时间点）——本工作流特有（reflow 允许预测点）
- 01 生成后立即校验时间轴对齐：
python scripts/srt_check_segments.py 01_subtitle_asr_fixed.srt --orig <原始ASR.srt> --cue-exact——01 只改文本、保留原时间码、不增删 cue；错位须在断句前发现（否则一路传 s03/s04，表现为"字幕比语音快/慢"）
- 合并/断句后每段时间码 = 覆盖原字幕片段首段 start → 末段 end；共享 cue 整条归属/中间断句估算见 segment-subtitles#共享 cue 与整条归属（时间不重叠）
- （时间不重叠 + 每步即时校验为通用规则，见 conventions「时间纪律」）
断句（合并与分割）
断句规则全部见 segment-subtitles（权威）——语义合并判据（不以标点为准）、英文预整理（游离单词归位）、两遍式、对白拆分、分割超长句、语义锚点、行宽，均以该 Skill 为准，本段不再重复。分块是通用机制，见 redstone-conventions#长视频分块。
必须使用工具：合并/断句一律按 segment-subtitles 执行；长视频（cue 数超出单次上下文）必须先分块（见 redstone-conventions#长视频分块），禁止整条字幕一次性合并/翻译。
固定工作流指令
本工作流包含四个阶段 + 一个人工审核循环。
阶段〇：领域预判与准备（翻译前，轻量扫描）
按 redstone-preprocess#阶段〇领域预判与准备 原样执行（刷新缓存 / 类别预判 / 红石补充加载 / 知识地图 / SOURCE_COVERAGE / asr_fixes）。
阶段一：术语扫描与知识补齐
按 redstone-preprocess#阶段一术语扫描与知识补齐 原样执行（§1.1 扫描 / §1.2 补齐 / §1.3 确认 / §1.4 入库），产物 01_subtitle_asr_fixed.srt + 02_terms.md 见 redstone-preprocess#产物契约。
阶段二：正式翻译
执行一律 subagent（无需报告）：合并断句 / 翻译逐块派 subagent（块数由分块骨架决定，无需报告“用/不用”）——统一路径，见 subagent-dispatch#派发边界。主会话只做：分块 → 渲染 → 派发 → 合并 → 校验 → 定点修复派发。
产物契约（本阶段输入 / 输出）：
- 输入：
01_subtitle_asr_fixed.srt + 02_terms.md（preprocess 产物）
- 输出（块级 subagent 产物 + 合并稿）：
chunks/（01 分块骨架，从 01 text_chunk.py --type srt 分块）_merge_results/chunk_<k>.txt（断句块）→ text_merge.py 合并 → s03_plan.md（断句定稿，交用户审核前落盘）_trans_results/chunk_<k>.txt（翻译块）→ text_merge.py 合并 → s04_draft.srt（标准 SRT 双语 en-zh，逐段翻译落盘）
- 各产物结构/分隔符/标记约定（单一权威）见 PRODUCT_FORMATS，处理前先查对应节
翻译风格：翻译前读 ref_translations/ 参考译例（如有），模仿其语气 / 句长偏好 / 术语偏好 / 注释风格。
所有术语译名已就绪，零网络等待。先定段落，再逐句翻译。
合并与断句（翻译前先定段落）
- 分块：
python scripts/text_chunk.py 01_subtitle_asr_fixed.srt --type srt --owned <N> --ctx <M> --out chunks/（N 按 redstone-conventions#长视频分块 用 context_estimate.py 定；N=1 单块亦分，产物契约一致）
- 渲染：
python scripts/render_subagent_prompt.py task-merge --video <工作目录> --all --chunks-dir <工作目录>/chunks
- 逐块派发
task-merge（断句 subagent；规则见 segment-subtitles 权威 + 任务文件 task-merge.md）→ _merge_results/chunk_<k>.txt；每收一个 已写入 立即验证真实性（subagent-dispatch#收信号即验）
- 合并：
python scripts/text_merge.py chunks/ _merge_results/ --out s03_plan.md [--report <报告>]（异常只读报告，见 subagent-dispatch#合并）
- 校验（硬闸门，全量）：
- 断句措辞一致性（断句只合并/分割、不改措辞）：
python scripts/srt_check_plan_words.py 01_subtitle_asr_fixed.srt s03_plan.md --asr-fixes 02_terms.md
- 时间边界：
python scripts/srt_check_segments.py s03_plan.md --orig 01_subtitle_asr_fixed.srt
- 打回 → B 档定点修复派发（见下「校验打回」）；通过才进翻译
- ASR 修正应用在组装期：
02_terms.md 已确认的 ASR 修正（如 word tear、the end dimension）在组装 s03_plan.md 时直接替换文本，勿留待翻译期
- 分段方案先交用户审核（阶段二½），确认后再定稿翻译
正式翻译
- 渲染：
python scripts/render_subagent_prompt.py task-translate --skill translate-redstone --video <工作目录> --all --chunks-dir <工作目录>/chunks
- 逐块派发
task-translate（翻译 subagent，任务文件 task-translate.md）→ _trans_results/chunk_<k>.txt
- 合并：
python scripts/text_merge.py chunks/ _trans_results/ --out <中间稿> [--report <报告>] → 主会话转 s04_draft.srt（标准 SRT 双语 en-zh；逐段落盘，中断可从未完成段继续）
- 校验（硬闸门，全量）：
- 术语全量核对：
python scripts/srt_check_terms.py 01_subtitle_asr_fixed.srt 02_terms.md <_trans_results/> --chunks <chunks/>（分块时）或 ... s04_draft.srt --plan s03_plan.md（合并后）
- 行宽：
python scripts/srt_check_width.py s04_draft.srt --order en-zh（>26 硬打回退出码 1、>22 软告警）
- 时间边界：
python scripts/srt_check_segments.py s04_draft.srt --orig 01_subtitle_asr_fixed.srt
- 校验打回 → 定点修复（B 档）：收集全部错误清单一次派发
task-fix（task-fix.md，见 subagent-dispatch#定点修正）——断句措辞按 01 改回、译文改措辞/术语漂移/行宽（translate 修复就是改译文本身，无 reflow「r03 只许切不许译」约束）；修正后复验（重跑触发它的校验），仍有残留 → 第二轮只派增量清单；多轮仍失败 → C 档整块重派（mv 清理 + 重派）
- 禁止直译红石术语（Comparator 必须为“比较器”）；禁止使用未在阶段一确认的译名
- 结论附上来源（
knowledge/ 或 .cache/ 中的引用路径）
阶段二+：去翻译腔（可选，独立上下文）
初步翻译完成后，消除译文中的“翻译腔”和 AI 味——规则见 humanizer-zh（24 种 AI 写作模式 + 改写原则）。仅当用户明确要求“去除翻译腔”或译文 AI 味明显时才执行；字幕本身偏口语时可跳过。
独立上下文执行（原隐含在主会话顺带做，现按 docs/PIPELINE_ISOLATION.md 隔离）：本步骤作为独立一遍运行——只读 s04_draft.srt 全稿，独立窗口产出修订稿，不在翻译会话里顺带改。全稿超长时可先分块、各块独立跑（块间用同一规则模板约束，保持风格一致）。
- 整稿（不分块）：主会话独立一遍，按
humanizer-zh 规则扫描修订，回写 s04_draft.srt
- 长稿分块：先把
s04_draft.srt 按段分块到 _work/<视频名>/_humanize_chunks/（每块含该块译文段），再逐块派 subagent——python scripts/render_subagent_prompt.py task-humanize --video <工作目录> --all --chunks-dir <工作目录>/_humanize_chunks，任务文件 task-humanize.md（字幕场景去翻译腔规则 / 改写原则的 subagent 版，主 skill 不重复）；结果写 _work/<视频名>/_humanize_results/chunk_<k>.txt：每行 段号|修订后译文（可附改动点说明）
阶段二½：人工审核循环
按 redstone-review 执行（循环机制 + 输出门禁）。审核对象：分段方案 + 翻译结果（s03_plan.md + s04_draft.srt）。
阶段三：数据源效果总结
按 redstone-finalize 原样执行（coverage_log 流水 + source_experience 经验提炼）。
