메뉴
当用户粘贴YouTube/B站等视频链接并要求将视频整理为文章、整理成文章、把视频内容写成文章、或类似请求时，立即使用此技能。自动下载字幕、翻译（如需要）、并生成精美的HTML文章。支持简体中文和英文两种输出语言。轻量高效，只保留必要的文件。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | video-to-article |
| description | 当用户粘贴YouTube/B站等视频链接并要求将视频整理为文章、整理成文章、把视频内容写成文章、或类似请求时，立即使用此技能。自动下载字幕、翻译（如需要）、并生成精美的HTML文章。支持简体中文和英文两种输出语言。轻量高效，只保留必要的文件。 |
将视频的字幕内容转换为一篇结构清晰、排版精美的中文HTML文章。快速高效，只保留必要的输出文件。
本 skill 依赖 yt-dlp 来下载视频字幕。已内置于 skill 目录，开箱即用：
video-to-article/
└── component/
└── yt-dlp.exe # Windows 版，已包含
如果内置版本无法使用，skill 会自动回退到系统 PATH 中的 yt-dlp。
如需手动安装：
# 方法一：使用 Homebrew（推荐）
brew install yt-dlp
# 方法二：使用 pip
pip3 install yt-dlp
如需手动安装：
# 方法一：使用 pip（推荐）
pip install yt-dlp
# 方法二：使用 pipx
pipx install yt-dlp
# 方法三：下载独立可执行文件
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp
将本 skill 文件夹复制到 Claude Code 的 skills 目录：
# 克隆仓库
git clone https://github.com/YOUR_USERNAME/video-to-article.git
# 复制到 Claude Code skills 目录
# Windows
cp -r video-to-article "$HOME/.claude/skills/"
# macOS / Linux
cp -r video-to-article ~/.claude/skills/
# 检查 yt-dlp 是否安装成功
yt-dlp --version
# 检查 skill 是否加载成功
# 在 Claude Code 中输入 /video-to-article 应该能看到 skill 说明
skill 会按以下顺序检测 yt-dlp：
| 优先级 | 平台 | 路径 |
|---|---|---|
| 1（内置） | Windows | {skill目录}/component/yt-dlp.exe |
| 2 | Windows | C:/Program Files/yt-dlp/yt-dlp.exe |
| 3 | macOS | /usr/local/bin/yt-dlp |
| 4 | macOS | /opt/homebrew/bin/yt-dlp |
| 5 | Linux | /usr/local/bin/yt-dlp |
| 6 | Linux | /usr/bin/yt-dlp |
默认输出目录：当前工作目录
可在 skill 调用时指定其他目录。
如果用户选择 HTML文章，必须使用 AskUserQuestion 询问用户希望使用哪种风格。
| 序号 | 风格名称 | Style Name | 描述 | 设计特点 |
|---|---|---|---|---|
| 1 | 蓝白商务 | Blue & White Business | 默认风格，专业简洁 | 蓝色渐变Hero、白色卡片、衬线标题、柔和阴影 |
| 2 | Notion深色 | Notion Dark Mode | Notion深色模式 | 深色背景、衬线标题、紧凑排版、彩色标注系统 |
| 3 | Claude风格 | Claude Style | Claude经典设计系统 | 赭石红+米白背景、衬线字体、噪点纹理 |
| 4 | 暗黑科技 | Cyber Tech | 赛博朋克/黑客帝国风格 | 深黑背景、霓虹光效、故障艺术、网格动画 |
| 5 | 极简现代 | Minimal Modern | 简约留白、优雅衬线 | 极致留白、衬线字体、深绿强调 |
注意：
AskUserQuestion工具最多支持4个选项。
询问内容：请问您希望使用哪种文章风格？
选项：
1. 蓝白商务（推荐）- 专业简洁，蓝色渐变Hero
2. Notion深色 - 深色背景，彩色标注系统
3. Claude风格 - 赭石红+米白，噪点纹理
4. 极简现代 - 简约留白，深绿强调，中文数字
询问内容：您选择了「XXX」风格。顺带一提，还有「暗黑科技」风格可选——赛博朋克风格，霓虹光效，要不要换？
选项：
1. 不用了，就用「XXX」
2. 换成暗黑科技
SKILL.md 内置规范 + references/blue-white-business-style.mdSKILL.md 内置「Notion深色风格设计规范」章节references/claude-style.mdreferences/cyber-tech-style.mdreferences/minimal-modern-style.md在使用本技能生成的内容时，必须遵守以下来源标注要求：
本技能基于视频字幕整理内容，生成的文章、口播稿等属于二次加工而非原创内容。为了：
在正文开头或结尾添加：
📺 内容来源：视频标题
🔗 原视频链接：https://www.youtube.com/watch?v=xxx
📢 整理自 @频道名称
在文章开头（标题下方）添加：
---
来源说明：
本文整理自 YouTube 视频《视频标题》
原视频链接：https://www.youtube.com/watch?v=xxx
原频道：@频道名称
---
在口播稿开头添加来源说明，并在视频描述中注明：
【内容来源】
本视频内容整理自：《视频标题》
原视频：https://www.youtube.com/watch?v=xxx
原频道：@频道名称
| 平台 | 要求 | 建议 |
|---|---|---|
| 小红书 | 建议标注来源 | 发布时在正文或评论区注明 |
| 公众号 | 建议标注来源 | 文章开头添加来源说明 |
| 口播稿/短视频 | 必须标注 | 视频描述区+口播稿开头都要有 |
| 微信公众号 | 尊重原创 | 如需商用，建议联系原作者获得授权 |
在生成内容后，必须向用户提示：
「⚠️ 重要提示：生成的内容基于视频字幕整理，发布前请务必添加原始视频来源信息。建议注明「内容整理自@频道名」或附上原视频链接，尊重原创，合理使用。」
在用户输入视频链接后，必须首先询问用户希望将内容输出到哪个平台。
| 平台 | 主格式 | 说明 |
|---|---|---|
| HTML文章 | .html | 网页阅读，保留原有功能 |
| 小红书文案 | .txt | 纯文本，复制即用 |
| 公众号文章 | .md | Markdown格式，支持排版工具 |
| 口播稿 | .txt | 短视频配音稿，可直接使用 |
用户输入视频链接
↓
【步骤1】询问输出平台：
1. HTML文章
2. 小红书文案
3. 公众号文章
4. 口播稿
↓
【步骤2】根据平台询问具体选项：
├─ 选择HTML文章时 → 询问文章风格
│ └─ 风格选择：蓝白商务/Notion深色/Claude风格/极简现代 → (是否换暗黑科技)
├─ 选择小红书文案时 → 询问文体类型
│ └─ 文体：种草文/干货文/情感文/清单文
├─ 选择公众号文章时 → 询问文体类型
│ └─ 文体：热点解读/深度长文/金句提炼/故事叙述
└─ 选择口播稿时 → 询问文体类型
└─ 文体：爆款开场/故事叙述/清单列表/情绪共鸣 → (是否选对话挑战)
↓
【步骤3】询问输出语言：
1. 简体中文
2. English
↓
生成对应格式的内容
| 文体类型 | 适用场景 | 模板文件 |
|---|---|---|
| 种草安利文 | 产品推荐、好物分享 | references/xiaohongshu/zhongcao.md |
| 干货教程文 | 技能分享、方法教程 | references/xiaohongshu/ganhuo.md |
| 情感共鸣文 | 情感故事、人生感悟 | references/xiaohongshu/qinggan.md |
| 清单盘点文 | 资源整理、清单合集 | references/xiaohongshu/qingdan.md |
| 文体类型 | 适用场景 | 模板文件 |
|---|---|---|
| 热点解读文 | 社会热点、行业趋势 | references/wechat/redian.md |
| 深度长文 | 知识科普、深度分析 | references/wechat/shendu.md |
| 金句提炼文 | 内容精华、语录整理 | references/wechat/jinju.md |
| 故事叙述文 | 案例分享、经历讲述 | references/wechat/gushi.md |
| 文体类型 | 适用场景 | 模板文件 |
|---|---|---|
| 爆款开场型 | 知识干货、认知颠覆 | references/koupogao/baokuan.md |
| 故事叙述型 | 个人经历、经验分享 | references/koupogao/gushi.md |
| 清单列表型 | 技巧盘点、方法汇总 | references/koupogao/qingdan.md |
| 对话挑战型 | 观点表达、争议话题 | references/koupogao/duihua.md |
| 情绪共鸣型 | 情感话题、人生感悟 | references/koupogao/qingxu.md |
| 平台 | 主格式 | 辅助格式 | 用途 |
|---|---|---|---|
| 小红书 | .txt | .html 预览 | 直接复制发布 / 本地预览 |
| 公众号 | .md | .html 预览 | 粘贴到编辑器 / 本地预览 |
| 口播稿 | .txt | .html 预览 | 直接配音使用 / 本地预览 |
| HTML文章 | .html | - | 网页阅读 |
{平台}-{文体类型}-{视频标题简称}.{扩展名}
示例：
├── HTML-蓝白商务-6个吸引力法则.html
├── 小红书-种草文-6个吸引力法则.txt
├── 小红书-种草文-6个吸引力法则-预览.html
├── 公众号-热点解读-6个吸引力法则.md
├── 公众号-热点解读-6个吸引力法则-预览.html
├── 口播稿-爆款开场-起床后工作1分钟.txt
└── 口播稿-爆款开场-起床后工作1分钟-预览.html
版本 1.0 · 基于Notion 2024深色模式实际观测值
| 层级 | 用途 | HEX | CSS 变量 |
|---|---|---|---|
| 底层背景 | 页面最外层 | #191919 | --bg-base |
| 内容背景 | 文章主体卡片 | #202020 | --bg-surface |
| 悬浮/弹出 | Tooltip、菜单 | #2f2f2f | --bg-elevated |
| 边框 | 分割线、表格线 | #2e2e2e | --border |
| 悬停高亮 | hover 状态 | #ffffff0f | --hover |
| 层级 | 用途 | HEX | CSS 变量 |
|---|---|---|---|
| 主文字 | 正文、标题 | #e3e3e3 | --text-primary |
| 次级文字 | 描述、副标题 | #9b9b9b | --text-secondary |
| 占位/禁用 | placeholder | #555555 | --text-muted |
| 颜色 | 文字色 | 背景色 |
|---|---|---|
| 蓝 | #4a7ab5 | #0e1f3b |
| 绿 | #518c5a | #122215 |
| 橙 | #c07a3d | #2e1e0f |
| 黄 | #b8a030 | #292306 |
| 粉 | #b05c83 | #2e1020 |
/* 标题：衬线体 */
--font-serif: 'Noto Serif SC', Georgia, 'Times New Roman', serif;
/* 正文：无衬线体 */
--font-sans: ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
/* 代码 */
--font-mono: "SFMono-Regular", Menlo, Consolas, "Liberation Mono", Courier, monospace;
| 元素 | 字号 | 行高 | 字重 |
|---|---|---|---|
| H1 | 2em (约40px) | 1.2 | 700 |
| H2 | 1.5em (约30px) | 1.3 | 600 |
| H3 | 1.25em (约25px) | 1.3 | 600 |
| 正文（Body） | 16px | 1.75 | 400 |
| 小字注释 | 14px | 1.6 | 400 |
:root {
--space-xs: 2px;
--space-sm: 4px;
--space-md: 8px;
--space-lg: 16px;
--space-xl: 24px;
--space-2xl: 40px;
}
:root {
--radius-sm: 3px; /* 内联元素 */
--radius-md: 4px; /* 按钮、输入框 */
--radius-lg: 8px; /* 卡片、容器 */
}
.page-content {
max-width: 708px; /* Notion标准宽度 */
margin: 0 auto;
padding: 0 96px; /* 两侧留白 */
}
@media (max-width: 768px) {
.page-content { padding: 0 24px; }
}
| 原则 | 说明 |
|---|---|
| 极简留白 | 内容即主角，装饰趋近于零 |
| 紧凑节奏 | 段落间距极小（1–4px），块与块之间呼吸感来自内容结构而非空白 |
| 中性色调 | 全站灰色系，彩色只服务于内容语义标注 |
| 无品牌强调 | 无蓝色链接、无彩色按钮，界面退场让文字前进 |
| 字重即层级 | 用字重（400/600/700）而非字色来区分标题层级 |
| 交互极克制 | hover仅加轻微背景，无阴影、无缩放、无弹跳 |
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>文章标题</title>
<link href="https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@400;600;700&display=swap" rel="stylesheet">
<style>
:root {
/* 背景 */
--bg-base: #191919;
--bg-surface: #202020;
--bg-elevated: #2f2f2f;
--border: #2e2e2e;
--hover: rgba(255, 255, 255, 0.055);
/* 文字 */
--text-primary: #e3e3e3;
--text-secondary: #9b9b9b;
--text-muted: #555555;
/* 强调色 - Notion 标注系统 */
--accent-blue-text: #4a7ab5;
--accent-blue-bg: #0e1f3b;
--accent-green-text: #518c5a;
--accent-green-bg: #122215;
--accent-orange-text: #c07a3d;
--accent-orange-bg: #2e1e0f;
--accent-yellow-text: #b8a030;
--accent-yellow-bg: #292306;
/* 字体 */
--font-serif: 'Noto Serif SC', Georgia, serif;
--font-sans: ui-sans-serif, -apple-system, system-ui, sans-serif;
/* 间距 */
--space-xs: 2px;
--space-sm: 4px;
--space-md: 8px;
--space-lg: 16px;
--space-xl: 24px;
--space-2xl: 40px;
/* 圆角 */
--radius-sm: 3px;
--radius-md: 4px;
--radius-lg: 8px;
}
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
font-family: var(--font-sans);
background: var(--bg-base);
color: var(--text-primary);
line-height: 1.75;
font-size: 16px;
}
.page {
max-width: 708px;
margin: 0 auto;
padding: 0 96px;
}
@media (max-width: 768px) {
.page { padding: 0 24px; }
}
h1 {
font-family: var(--font-serif);
font-size: 2em;
font-weight: 700;
line-height: 1.2;
color: var(--text-primary);
margin-top: 80px;
margin-bottom: var(--space-sm);
}
h2 {
font-family: var(--font-serif);
font-size: 1.5em;
font-weight: 600;
line-height: 1.3;
color: var(--text-primary);
margin-top: 1.6em;
margin-bottom: var(--space-sm);
}
p {
font-size: 16px;
line-height: 1.75;
color: var(--text-primary);
margin: 1px 0;
}
a {
color: inherit;
text-decoration: underline;
text-decoration-color: var(--text-secondary);
text-underline-offset: 2px;
}
a:hover {
text-decoration-color: var(--text-primary);
}
blockquote {
border-left: 3px solid var(--text-primary);
margin: var(--space-md) 0;
padding: var(--space-sm) var(--space-lg);
font-style: normal;
}
/* 标注块 (Callout) */
.callout {
display: flex;
align-items: flex-start;
gap: var(--space-md);
border-radius: var(--radius-md);
padding: var(--space-lg);
margin: var(--space-md) 0;
}
.callout-blue {
background: var(--accent-blue-bg);
}
.callout-green {
background: var(--accent-green-bg);
}
.callout-orange {
background: var(--accent-orange-bg);
}
.callout-yellow {
background: var(--accent-yellow-bg);
}
.callout-icon {
font-size: 18px;
line-height: 1;
flex-shrink: 0;
}
.callout-content {
flex: 1;
}
</style>
</head>
<body>
<div class="page">
<span class="tag">分类标签</span>
<h1>文章标题</h1>
<p>正文内容...</p>
<blockquote>
<p>引用内容</p>
</blockquote>
<hr>
<h2>章节标题</h2>
<p>章节内容...</p>
<div class="callout callout-blue">
<span class="callout-icon">💡</span>
<div class="callout-content">
<p>重点提示内容</p>
</div>
</div>
</div>
</body>
</html>
flex-shrink: 0;
}
hr {
border: none;
border-top: 1px solid var(--border);
margin: var(--space-lg) 0;
}
/* 标签 */
.tag {
display: inline-block;
background: var(--accent-blue-bg);
color: var(--accent-blue-text);
padding: 2px 8px;
border-radius: var(--radius-sm);
font-size: 12px;
font-weight: 500;
margin-bottom: var(--space-md);
}
</style>
</head>
<body>
<div class="page">
<span class="tag">分类标签</span>
<h1>文章标题</h1>
<p>正文内容...</p>
<blockquote>
<p>引用内容</p>
</blockquote>
<hr>
<h2>章节标题</h2>
<p>章节内容...</p>
<div class="callout callout-blue">
<span class="callout-icon">💡</span>
<div class="callout-content">
<p>重点提示内容</p>
</div>
</div>
</div>
</body>
</html>
在生成文章之前，必须使用 AskUserQuestion 工具依次让用户选择以下选项：
使用 AskUserQuestion 询问用户：
询问内容：请问您希望将内容输出到哪个平台？
选项：
1. HTML文章 - 网页阅读，保留原有功能
2. 小红书文案 - 纯文本，复制即用
3. 公众号文章 - Markdown格式，支持排版工具
4. 口播稿 - 短视频配音稿，可直接使用
根据平台选择，使用 AskUserQuestion 询问对应的具体文体：
HTML文章：
询问内容：请问您希望使用哪种文章风格？
选项：
1. 蓝白商务（推荐）- 专业简洁，蓝色渐变Hero
2. Notion深色 - 深色背景，彩色标注系统
3. Claude风格 - 赭石红+米白，噪点纹理
4. 暗黑科技 - 赛博朋克风格，霓虹光效
5. 极简现代 - 简约留白，深绿强调
小红书文案：
询问内容：请问您希望使用哪种小红书文体？
选项：
1. 种草安利文 - 产品推荐、好物分享
2. 干货教程文 - 技能分享、方法教程
3. 情感共鸣文 - 情感故事、人生感悟
4. 清单盘点文 - 资源整理、清单合集
公众号文章：
询问内容：请问您希望使用哪种公众号文体？
选项：
1. 热点解读文 - 社会热点、行业趋势
2. 深度长文 - 知识科普、深度分析
3. 金句提炼文 - 内容精华、语录整理
4. 故事叙述文 - 案例分享、经历讲述
口播稿：
注意：
AskUserQuestion工具最多支持4个选项，口播稿共5种文体，分两步进行。
第一步（4个选项）：
询问内容：请问您希望使用哪种口播稿文体？
选项：
1. 爆款开场型 - 知识干货、认知颠覆
2. 故事叙述型 - 个人经历、经验分享
3. 清单列表型 - 技巧盘点、方法汇总
4. 情绪共鸣型 - 情感话题、人生感悟
第二步（如果用户需要第5种可选风格）：
询问内容：还有一种「对话挑战型」风格——适合观点表达、争议话题，要不要看看？
选项：
1. 不用了，就用前面的风格
2. 对话挑战型 - 观点表达、争议话题
使用 AskUserQuestion 询问输出语言：
询问内容：请问您希望文章使用哪种语言输出？
选项：
1. 简体中文（推荐）- 翻译字幕后整理，适合中文读者
2. English - 保留英文内容，适合国际读者
直接使用 yt-dlp 获取基本信息，不保存到文件：
# 获取视频信息（输出到终端）
yt-dlp --print "%(title)s" --print "%(uploader)s" --print "%(upload_date)s" --print "%(duration)s" --print "%(thumbnail)s" --print "%(webpage_url)s" --skip-download "视频链接"
从链接识别平台：
| 平台 | 链接特征 | 图标 |
|---|---|---|
| YouTube | youtube.com / youtu.be | 📺 |
| Bilibili | bilibili.com / b23.tv | 📱 |
| Twitter/X | twitter.com / x.com | 🐦 |
| Vimeo | vimeo.com | 🎬 |
使用 yt-dlp 下载字幕，只保留必要的 cookie 文件：
Cookie 处理（保留 cookies.txt）：
如果用户提供了 SESSDATA（对于 Bilibili），我们会自动创建标准格式的 cookies.txt 文件（这个文件会保留）：
# 如果用户提供了 SESSDATA，自动创建 cookie 文件
if [ -n "$USER_SESSDATA" ]; then
# 自动生成标准格式的 cookie 文件（保留）
cat > cookies.txt << EOF
# Netscape HTTP Cookie File
# This file was generated by video-to-article skill
# Cookie for Bilibili AI subtitle access
.bilibili.com TRUE / TRUE 1791183873 SESSDATA ${USER_SESSDATA}
EOF
COOKIE_OPTION="--cookies cookies.txt"
echo "✅ Cookie 文件已创建: cookies.txt（已保留）"
else
COOKIE_OPTION=""
fi
下载字幕（优先使用手动字幕，没有则用自动字幕）：
# 下载字幕 - 只下载需要的字幕文件
yt-dlp --write-subs --write-auto-subs --sub-lang "zh-Hans,zh,en" --skip-download $COOKIE_OPTION -o "%(title)s.%(ext)s" "视频链接"
找到字幕文件：
# 找到下载的字幕文件（优先顺序：.zh-Hans.srt → .ai-zh.srt → .srt → .vtt）
SUBTITLE_FILE=""
if ls *.zh-Hans.srt 2>/dev/null; then
SUBTITLE_FILE=$(ls -1t *.zh-Hans.srt | head -1)
elif ls *.ai-zh.srt 2>/dev/null; then
SUBTITLE_FILE=$(ls -1t *.ai-zh.srt | head -1)
elif ls *.srt 2>/dev/null; then
SUBTITLE_FILE=$(ls -1t *.srt | head -1)
elif ls *.vtt 2>/dev/null; then
SUBTITLE_FILE=$(ls -1t *.vtt | head -1)
fi
关键改进说明：
| 平台 | 字幕支持 | 备注 |
|---|---|---|
| YouTube | ✅ 手动+自动 | 最佳支持 |
| Bilibili | ✅ CC字幕 + AI字幕 | 有CC字幕直接下载；无字幕需提供SESSDATA获取AI字幕 |
| Twitter/X | ✅ 内嵌字幕 | 部分 video 支持 |
| Vimeo | ✅ 手动字幕 | 依赖上传者添加 |
| 其他 | ⚠️ 有限支持 | 取决于平台 |
直接在内存中读取和处理字幕：
# 直接读取字幕内容到变量，不保存中间文件
FULL_SUBTITLE_CONTENT=$(cat "$SUBTITLE_FILE")
CONTENT_LENGTH=$(echo "$FULL_SUBTITLE_CONTENT" | wc -c)
LINE_COUNT=$(echo "$FULL_SUBTITLE_CONTENT" | wc -l)
echo "📊 字幕文件统计:"
echo " - 文件大小: ${CONTENT_LENGTH} 字节"
echo " - 总行数: ${LINE_COUNT} 行"
# 简单的字幕清洗 - 去除时间戳标签但保留所有文本内容
CLEAN_CONTENT=$(echo "$FULL_SUBTITLE_CONTENT" | \
sed '/^[0-9]\+$/d' | \
sed '/-->.*$/d' | \
sed '/^$/d' | \
sed 's/<[^>]*>//g')
# 内容预览（前100行和后50行）
echo "📝 字幕内容预览（前100行）:"
echo "═══════════════════════════════════════════════════"
echo "$CLEAN_CONTENT" | head -100
echo "═══════════════════════════════════════════════════"
echo "📝 字幕内容预览（后50行）:"
echo "═══════════════════════════════════════════════════"
echo "$CLEAN_CONTENT" | tail -50
echo "═══════════════════════════════════════════════════"
基于内置HTML模板直接生成文章：
我们使用内置的蓝白商务风格HTML模板，直接替换内容。不使用Python脚本，直接使用bash字符串操作：
# 获取视频标题（从文件名中提取）
VIDEO_TITLE=$(yt-dlp --print "%(title)s" --skip-download "视频链接")
# 生成HTML文件名
OUTPUT_FILE="${VIDEO_TITLE}_蓝白商务.html"
# 使用内置模板直接生成HTML
cat > "$OUTPUT_FILE" << 'EOF'
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>文章标题</title>
<link href="https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@400;500;600;700&family=Noto+Sans+SC:wght@300;400;500;600&display=swap" rel="stylesheet">
<style>
/* 内置蓝白商务风格CSS */
:root {
--primary: #0369A1;
--primary-light: #0EA5E9;
--primary-dark: #0C4A6E;
--accent: #22C55E;
--accent-gold: #FCD34D;
--background: #F8FAFC;
--surface: #FFFFFF;
--surface-alt: #F1F5F9;
--text-primary: #0F172A;
--text-secondary: #475569;
--text-muted: #94A3B8;
--border: #E2E8F0;
}
/* 简化版样式... */
</style>
</head>
<body>
<header class="hero">
<div class="container">
<span class="hero-tag">分类标签</span>
<h1>文章标题</h1>
<p class="hero-subtitle">副标题</p>
</div>
</header>
<article class="container">
<!-- 内容区域 -->
<div class="content-card">
<p>这里将填充字幕内容...</p>
</div>
</article>
<footer class="footer">
<p>内容基于视频字幕翻译整理 · 观看原视频</p>
<p>© 2026 视频转文章技能</p>
</footer>
<script>
// 简化版动画...
</script>
</body>
</html>
EOF
# 替换标题和内容
sed -i "s/文章标题/$VIDEO_TITLE/g" "$OUTPUT_FILE"
sed -i "s/这里将填充字幕内容.../$CLEAN_CONTENT/g" "$OUTPUT_FILE"
echo "✅ HTML文章已生成: $OUTPUT_FILE"
# 清理临时文件（除了cookies.txt）
rm -f "$SUBTITLE_FILE"
rm -f "subtitle_analysis.json"
rm -f "metadata.json"
rm -f "subtitle_original_*.srt"
echo "🧹 临时文件已清理"
内容完整性要求（重要）：
使用内置HTML模板生成：
我们将直接使用内置的蓝白商务风格HTML模板，通过 Claude 的自然语言处理能力来组织内容：
重要：只保留必要文件！
清理临时文件：
# 清理临时文件（除了cookies.txt）
rm -f *.srt
rm -f *.vtt
rm -f metadata.json
rm -f subtitle_*.txt
rm -f subtitle_*.json
echo "🧹 临时文件已清理，只保留 cookies.txt"
用户提示话术：
「✅ 视频内容已完整转换为HTML文章！
📄 已保存文件：
- [视频标题]_蓝白商务.html
- cookies.txt（已保留，下次可直接使用）
⚠️ 发布前请务必添加原始视频来源信息。建议注明「内容整理自@频道名」或附上原视频链接，尊重原创，合理使用。」
在文章开头展示视频来源信息，增强文章的可信度和来源可追溯性：
<!-- 视频来源卡片 -->
<div class="video-source-card">
<div class="source-thumbnail-wrapper">
<img class="source-thumbnail" src="视频封面URL" alt="视频封面">
<span class="source-duration">45:32</span>
</div>
<div class="source-info">
<div class="source-meta-row">
<span class="source-platform">📺 YouTube</span>
<span class="source-author">作者名称</span>
</div>
<div class="source-meta-row">
<span class="source-date">📅 2024年1月15日</span>
</div>
</div>
<a class="source-link" href="原始链接" target="_blank" rel="noopener">
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
<path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path>
<polyline points="15 3 21 3 21 9"></polyline>
<line x1="10" y1="14" x2="21" y2="3"></line>
</svg>
观看原视频
</a>
</div>
CSS 样式（蓝白商务风格）：
.video-source-card {
display: flex;
align-items: center;
gap: 1rem;
background: linear-gradient(135deg, #f8fafc, #ffffff);
border: 1px solid #e2e8f0;
border-radius: 12px;
padding: 1rem 1.25rem;
margin-bottom: 2rem;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.04);
}
.source-thumbnail-wrapper {
position: relative;
flex-shrink: 0;
}
.source-thumbnail {
width: 120px;
height: 68px;
object-fit: cover;
border-radius: 8px;
}
.source-duration {
position: absolute;
bottom: 4px;
right: 4px;
background: rgba(0, 0, 0, 0.8);
color: white;
font-size: 11px;
padding: 2px 6px;
border-radius: 4px;
font-weight: 500;
}
.source-info {
flex: 1;
display: flex;
flex-direction: column;
gap: 0.5rem;
}
.source-meta-row {
display: flex;
align-items: center;
gap: 1rem;
font-size: 14px;
}
.source-platform {
display: inline-flex;
align-items: center;
gap: 0.25rem;
background: #e0f2fe;
color: #0369a1;
padding: 2px 8px;
border-radius: 4px;
font-weight: 500;
font-size: 12px;
}
.source-author {
color: #475569;
}
.source-date {
color: #64748b;
font-size: 13px;
}
.source-link {
display: inline-flex;
align-items: center;
gap: 0.5rem;
background: #0369a1;
color: white;
text-decoration: none;
padding: 0.5rem 1rem;
border-radius: 8px;
font-size: 14px;
font-weight: 500;
transition: all 0.2s ease;
}
.source-link:hover {
background: #0284c7;
transform: translateY(-1px);
}
@media (max-width: 640px) {
.video-source-card {
flex-direction: column;
text-align: center;
}
.source-thumbnail {
width: 100%;
height: auto;
aspect-ratio: 16/9;
}
}
暗黑科技风格适配：
/* 暗黑科技风格下的视频来源卡片 */
.video-source-card {
background: linear-gradient(135deg, var(--neural-gray), var(--cyber-dark));
border: 1px solid rgba(0, 240, 255, 0.2);
border-radius: 0;
clip-path: polygon(0 0, calc(100% - 12px) 0, 100% 12px, 100% 100%, 12px 100%, 0 calc(100% - 12px));
}
.source-platform {
background: rgba(0, 240, 255, 0.1);
color: var(--neon-cyan);
}
.source-link {
background: linear-gradient(135deg, var(--plasma-purple), var(--neon-cyan));
}
Noto Serif SC（Google Fonts）Noto Sans SC<link href="https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@400;500;600;700&family=Noto+Sans+SC:wght@300;400;500;600&display=swap" rel="stylesheet">
:root {
/* 主色调 */
--primary: #0369A1; /* 专业蓝 */
--primary-light: #0EA5E9; /* 天蓝 */
--primary-dark: #0C4A6E; /* 深蓝 */
/* 强调色 */
--accent: #22C55E; /* 成功绿 */
/* 背景 */
--background: #F8FAFC; /* 页面背景 */
--surface: #FFFFFF; /* 卡片背景 */
--surface-alt: #F1F5F9; /* 交替背景 */
/* 文字 */
--text-primary: #0F172A; /* 主文字 */
--text-secondary: #475569; /* 次要文字 */
--text-muted: #94A3B8; /* 辅助文字 */
/* 边框 */
--border: #E2E8F0;
--border-light: #F1F5F9;
}
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>文章标题</title>
<link href="Google Fonts链接" rel="stylesheet">
<style>
:root {
--primary: #0369A1;
--primary-light: #0EA5E9;
--primary-dark: #0C4A6E;
--accent: #22C55E;
--background: #F8FAFC;
--surface: #FFFFFF;
--text-primary: #0F172A;
--text-secondary: #475569;
}
/* 基础样式... */
</style>
</head>
<body>
<header class="hero">
<span class="hero-tag">分类标签</span>
<h1>文章标题</h1>
<p class="hero-subtitle">副标题</p>
</header>
<article class="container">
<!-- 引言 -->
<section class="intro">
<p>首段内容...</p>
</section>
<!-- 引用块 -->
<div class="quote-block">
<blockquote>核心引述</blockquote>
<cite>— 来源</cite>
</div>
<!-- 章节内容 -->
<section>
<div class="section-header">
<span class="section-number">1</span>
<span class="section-title">章节标题</span>
</div>
<div class="content-card">
<p>正文内容...</p>
<div class="highlight-box">
<p>重点强调</p>
</div>
<div class="practice-tips">
<strong>实践方法：</strong>行动建议...
</div>
</div>
</section>
</article>
<!-- 总结 -->
<section class="summary">
<h2>总结标题</h2>
<div class="summary-item">
<span class="summary-item-number">1</span>
<div class="summary-item-content">
<div class="summary-item-title">要点标题</div>
<div class="summary-item-desc">要点描述</div>
</div>
</div>
</section>
<footer class="footer">
<p>内容基于视频字幕翻译整理</p>
</footer>
</body>
</html>
根据用户选择的平台，生成对应的文件，并保留所有处理过程文件：
| 平台 | 主格式 | 文件扩展名 | 辅助文件 | 说明 |
|---|---|---|---|---|
| HTML文章 | HTML | .html | metadata.json, *.srt, *.vtt | 网页阅读 |
| 小红书 | 纯文本 | .txt | subtitle_clean.txt, subtitle_analysis.json | 复制即用 / 本地预览 |
| 公众号 | Markdown | .md | subtitle_analysis.json, subtitle_clean.txt | 粘贴到编辑器 / 本地预览 |
| 口播稿 | 纯文本 | .txt | subtitle_clean.txt, metadata.json | 直接配音 / 本地预览 |
{平台}-{文体类型}-{视频标题简称}.{扩展名}
示例（完整文件集合）：
├── 【十字路口】探秘ClaudeCode_蓝白商务.html # 最终HTML文件
├── 【十字路口】探秘ClaudeCode_蓝白商务-预览.html
├── metadata.json # 视频元数据
├── subtitle_clean.txt # 清洗后的字幕内容
├── subtitle_analysis.json # 内容分析报告
├── cookies.txt # 会话cookie
├── 【十字路口】探秘 Claude Code，搞懂 Agent Harness｜对谈来新璐【视频播客】.ai-zh.srt # 原始字幕
├── file_inventory.txt # 文件清单
└── subtitle_list.txt # 字幕文件列表
内容完整性标准（严格要求）：
内容缺失的识别和处理：
# 内容完整性检查脚本
CONTENT_COVERAGE_THRESHOLD=0.8 # 80% 覆盖率要求
# 计算内容使用比例
total_lines=$(cat subtitle_clean.txt | wc -l)
article_lines=$(grep -o "获取视频" 【十字路口】探秘ClaudeCode_蓝白商务.html 2>/dev/null || echo 0)
# 如果无法直接获取行数，进行估算
if [ "$article_lines" -lt 10 ]; then
echo "⚠️ 无法准确计算内容使用比例，请人工检查"
# 显示文章和字幕的字符统计
article_chars=$(cat 【十字路口】探秘ClaudeCode_蓝白商务.html | grep -o "<p>" | wc -l)
subtitle_chars=$(cat subtitle_clean.txt | wc -c)
echo "文章段落数: $article_chars"
echo "字幕字符数: $subtitle_chars"
if [ "$subtitle_chars" -lt 5000 ]; then
echo "⚠️ 字幕内容过短，可能需要检查下载是否完整"
fi
else
usage_ratio=$(awk "BEGIN {print $article_lines / $total_lines}")
echo "内容使用比例: $(awk "BEGIN {printf \"%.1f\", $usage_ratio * 100}")%"
if (( $(awk "BEGIN {if ($usage_ratio < $CONTENT_COVERAGE_THRESHOLD) print 1; else print 0}") )); then
echo "❌ 内容使用比例不足 80%，建议重新生成"
echo "建议：检查是否有截断或重要内容缺失"
else
echo "✅ 内容使用比例符合要求"
fi
fi
def read_and_analyze_full_content(full_text):
"""
完整阅读和分析所有字幕内容
"""
paragraphs = []
current_paragraph = []
for line in full_text.split('\n'):
if line.strip():
current_paragraph.append(line.strip())
else:
if current_paragraph:
paragraphs.append(' '.join(current_paragraph))
current_paragraph = []
if current_paragraph:
paragraphs.append(' '.join(current_paragraph))
print(f"识别到段落数: {len(paragraphs)}")
print(f"平均段落长度: {sum(len(p) for p in paragraphs)/len(paragraphs)} 字符")
return paragraphs
def validate_content_completeness(article_content, original_content):
"""
验证文章内容的完整性
"""
# 1. 主题一致性检查
key_topics = identify_key_topics(original_content)
article_topics = identify_key_topics(article_content)
missing_topics = [t for t in key_topics if t not in article_topics and len(t) > 3]
if missing_topics:
print("⚠️ 重要主题可能缺失:")
for topic in missing_topics:
print(f" - {topic}")
# 2. 关键词覆盖率检查
key_words = extract_keywords(original_content)
article_words = extract_keywords(article_content)
coverage_rate = sum(1 for word in key_words if word in article_words) / len(key_words)
print(f"关键词覆盖率: {coverage_rate:.1%}")
# 3. 关键信息检查
critical_info = identify_critical_info(original_content)
article_critical = identify_critical_info(article_content)
print("\n🎯 关键信息对比:")
for info in critical_info:
if info in article_critical:
print(f"✅ 包含: {info}")
else:
print(f"❌ 可能缺失: {info}")
def regenerate_with_full_content(original_subtitles, current_article):
"""
基于完整字幕内容重新调整文章
"""
# 1. 首先识别当前文章的内容结构
article_structure = analyze_article_structure(current_article)
# 2. 识别未使用的重要内容
unused_content = identify_unused_content(original_subtitles, current_article)
# 3. 重组文章，纳入缺失内容
new_article = integrate_unused_content(current_article, unused_content)
return new_article
生成文章前必须完成的检查：
✅ 完整读取所有字幕内容
✅ 分析内容结构和主题分布
✅ 确保使用 80% 以上的内容
✅ 检查重要主题是否完整
✅ 验证关键词覆盖率
✅ 确认所有关键信息点
✅ 检查是否有截断或过度删除
✅ 验证文章的逻辑连贯性
✅ 进行可读性测试
✅ 检查引用和来源信息
# 检查工具是否安装正确
yt-dlp --version
which yt-dlp # macOS/Linux
where yt-dlp # Windows
# 如果已安装但找不到，检查 PATH
echo $PATH # macOS/Linux
echo %PATH% # Windows
# 更新到最新版本
yt-dlp -U
# 详细错误排查（获取调试信息）
yt-dlp --verbose --list-subs "视频链接" > yt-dlp-verbose.log 2>&1
# 检查网络连接和代理
curl -I "https://www.youtube.com" # 测试网络
B站视频的字幕支持需要特殊处理：
直接下载即可：
yt-dlp --write-subs --sub-lang zh-Hans --skip-download -o "%(title)s.%(ext)s" "B站视频链接"
B站需要用户提供 SESSDATA cookie 才能访问 AI 字幕生成功能。
引导用户提供 SESSDATA 的步骤：
F12 打开开发者工具Application 标签页Cookies → 点击 https://www.bilibili.comSESSDATA 这一行Value 列的完整值（一串很长的字符）使用 SESSDATA 下载字幕（自动处理）：
现在系统会自动处理 cookie 文件：
# 输入示例（用户提供）
d73c2b36%2C1791183873%2Cb17c5%2A42CjDZOd7b8EqlwLu7cxUr0GOZAfJpPdBDWrvwYB6znSHYir2GZIth6K_bzJ_Zu6aV1qQSVk50TlFqU0tGa1otdnV6WWJBckw3M0s5VGdLWjhPeVN2Ymh1MnVGSk12dUZPSVJKTXFYSmJJUDRDMTVuMG9xYzB3YXo4MVBjVHV5c0wwQTFpYVByTkhBIIEC
# 系统自动生成 cookie 文件
cat > cookies.txt << EOF
# Netscape HTTP Cookie File
.bilibili.com TRUE / TRUE 1791183873 SESSDATA d73c2b36%2C1791183873%2Cb17c5%2A42CjDZOd7b8EqlwLu7cxUr0GOZAfJpPdBDWrvwYB6znSHYir2GZIth6K_bzJ_Zu6aV1qQSVk50TlFqU0tGa1otdnV6WWJBckw3M0s5VGdLWjhPeVN2Ymh1MnVGSk12dUZPSVJKTXFYSmJJUDRDMTVuMG9xYzB3YXo4MVBjVHV5c0wwQTFpYVByTkhBIIEC
EOF
# 下载 AI 字幕
yt-dlp --write-auto-subs --sub-lang zh-Hans --skip-download --cookies cookies.txt "视频链接"
提示话术（改进版）：
「这个 B站视频似乎没有 CC 字幕。如果您登录了 B站账号，可以提供 SESSDATA cookie 来获取 AI 生成的字幕。
获取方法：
- 在浏览器登录 B站
- 按 F12 → Application → Cookies → bilibili.com
- 找到 SESSDATA，复制它的 Value 值给我
请问您能提供 SESSDATA 吗？」
常见问题排查：
# 检查 cookie 文件是否正确生成
ls -la cookies.txt
cat cookies.txt # 检查格式是否正确
# 测试 cookie 文件是否工作
yt-dlp --cookies cookies.txt --list-subs "视频链接"
# 如果还有问题，尝试使用 --no-check-certificate
yt-dlp --no-check-certificate --cookies cookies.txt --list-subs "视频链接"
# 检查当前目录内容
ls -la
# 检查字幕下载位置
ls -la *.srt *.vtt 2>/dev/null
# 查找所有相关文件
find . -type f -name "*.srt" -o -name "*.vtt" -o -name "*.json"
# 检查字幕文件格式和完整性
for file in *.srt *.vtt; do
if [ -f "$file" ]; then
echo "=== $file ==="
wc -l "$file"
head -20 "$file"
echo "---------------"
fi
done
# 检查 Python 是否可用
python3 --version
# 检查权限问题
ls -ltr
# 检查磁盘空间
df -h
# 启用完整调试信息
yt-dlp --verbose --write-subs --sub-lang zh-Hans --skip-download --cookies cookies.txt \
"视频链接" > yt-dlp-debug.log 2>&1
echo "调试日志已保存到 yt-dlp-debug.log"