| name | youtube-bilingual-transcript |
| description | Turn a YouTube link into a polished single-file bilingual (Chinese + original) transcript reading page.
Use when the user gives a YouTube URL and asks to "转录" "做转录稿" "生成转录页面" "中英对照"
"bilingual transcript" "transcribe this video", or wants a readable HTML transcript with clickable
timestamps, chapter navigation, highlighted key points, and proper-noun annotations.
Fetches captions + chapters via yt-dlp, the agent translates and curates, then a script renders the HTML.
|
YouTube 中英对照转录页生成
把一个 YouTube 链接变成一份单文件 HTML 阅读页：中文为主、英文原文为下方小字，带时间戳跳转、带序号的章节目录、每章中文要点、重点金句高亮、以及专有名词「正文内联点击展开」注释。
三步流程
1. 抓取字幕与章节 → work.json 骨架
python3 ${SKILL_PATH}/scripts/fetch_transcript.py "<youtube-url>" work.json
脚本用 uvx yt-dlp（无需全局安装）抓取原语言自动字幕（json3）与 info.json（标题、时长、章节），把逐词字幕合并成可读段落、按章节分组，产出待翻译骨架。每个 segment 已填好 en，zh 留空。
环境注意（脚本已内置重试，但需了解）：
- 依赖浏览器登录态绕过 YouTube 机器人校验——脚本用
--cookies-from-browser chrome。Chrome 需已登录 YouTube。
- cookie 提取偶发只取到极少 cookie 而触发 bot 校验，脚本会重试多次；若始终失败，提示用户在 Chrome 里打开一次 YouTube 再重试。
- 解 n-challenge 需要 JS runtime，建议系统装有
deno（brew install deno）。
2. 翻译与策展：把 work.json 补全为 spec.json
这是本 skill 的核心智力环节，由 agent 完成。读取 work.json，只填充、不改动 ts/en，逐项补齐：
meta.title_zh、meta.subtitle、meta.guest：中文标题、副标题（如播客期号）、嘉宾一句话身份。meta.has_speakers：自动字幕没有说话人信息 → 保持 false、各 segment 的 speaker 留空。只有当来源确实区分说话人（见下方「更高质量」）才设 true 并填 speaker。- 每个 segment 的
zh：忠实、自然的中文翻译。保留口语节奏；专有名词首次出现用「中文（English）」形式，便于内联注释命中。长视频分批翻译，务必逐段覆盖、不漏段、不串行错位（完成后校验每段 zh 非空且与 en 对应——本类任务最易出的就是漏一句短句导致整体错位一格）。
- 每章
title_zh 与 summary：中文章节名；summary 为 2–4 条中文要点，提炼该章核心论点（用于章节顶部卡片）。
- 每章挑 1–3 句
key: true：最值得高亮、可直接引用的金句，作为「重点」与「只看重点」的依据。宁缺毋滥。
glossary：本视频出现的专有名词，{term, zh, desc}。只收有辨识度的名词（公司、人物、产品/架构、技术概念、模型/事件），不要收 the/power 这类常见词，否则正文会被误标。desc 用一句中文解释。注释在正文中文里命中（优先匹配 zh，无中文名则匹配 term），每词仅标注首次出现。
3. 渲染 HTML
python3 ${SKILL_PATH}/scripts/build_html.py spec.json output.html
默认输出放用户易取处（如 $HOME/Desktop/<slug>.html），生成后用系统命令打开预览（macOS：open）。
spec.json 结构
{
"meta": {"title","title_zh","subtitle","channel","guest","duration",
"upload_date","video_id","url","has_speakers"},
"chapters": [
{"title","title_zh","start","summary":["中文要点","..."],
"segments": [{"ts","sec","speaker","en","zh","key"}]}
],
"glossary": [{"term","zh","desc"}]
}
fetch_transcript.py 已产出除翻译/要点/术语外的全部字段，agent 在其基础上补全即可。
成页功能（已内置于 build_html.py，无需另写）
- 中文主体 + 英文小字淡色；左上「隐藏英文」一键切换纯中文。
- 带序号的章节目录（sticky 侧栏），点击跳转；每章标题旁「跳转视频」按钮。
- 时间戳点击直达 YouTube 对应秒数。
key 段落金色高亮 + 「只看重点」筛选。- 专有名词在正文中文里以虚线 + ⓘ 标注，点击展开注释气泡；完整术语表折叠在页面底部（不占据开头）。
更高质量（可选）
自动字幕无说话人、偶有断句瑕疵。若该创作者在自有网站发布了官方逐字稿（常含说话人标注与时间戳，如某些访谈/播客），优先抓取并解析官方稿填入 segments（设 has_speakers: true、填 speaker），质量显著更好。其余流程（翻译、要点、术语、渲染）不变。
