Content Breakdown

爆款拆解技能 Content Breakdown

架构：优先使用 curl / yt-dlp / HTTP API 直接获取数据（无需浏览器），仅在 curl 失败时降级到 Agent（browser_use）获取页面数据。Python 脚本（scripts/cli.py）负责下载/转录/OCR。脚本不含任何浏览器操作。

平台路由

⛔ 强制规则：收到 URL 后，识别平台，必须先 read_file 读取对应 reference 文件再执行。 禁止凭记忆执行任何平台的提取流程。每次提取都必须重新读取文档，无论之前是否执行过同平台的提取。 未读取 reference 文件就开始操作视为严重错误。

不支持的平台：单条时提示不支持并列出支持列表；批量时跳过（⏭️ 跳过：{链接} — 暂不支持），不中断整体流程。

各平台关键注意事项

提取流程

⛔ 以下 6 步必须严格按顺序逐步执行，禁止跳过任何一步，禁止合并步骤，禁止在未完成前一步时开始下一步。

1. ⛔ 读取文档：read_file 读取对应平台的 references/*.md。此步骤不可跳过，未读取就开始操作视为严重错误。
2. 获取数据：按文档 Step 1 的方式零（curl/yt-dlp/API）优先获取数据。优先方式失败时才降级到 browser_use，browser_use 失败再降级到 CDP。必须严格按照 reference 文件中的步骤顺序执行，包括滚动防反爬等所有前置操作。
3. 脚本处理：按文档 Step 2 调用 python3 scripts/cli.py extract-{平台} 处理
4. 格式化输出：读取 references/output-format.md，按三部分格式输出：
   • 📋 内容元数据：标题、作者、平台、时长、互动数据等
   • 📄 提取内容原文：转录文本 / 正文 / OCR 文本
   • ⛔ 📊 内容分析：此部分必须包含且不可省略，需输出核心主题、主要观点、适用场景、内容结构分析。缺少此部分视为报告不完整。
5. 保存报告：⛔ 报告文件中三部分必须全部写入（📋 + 📄 + 📊），缺少任何一部分禁止保存。写入路径：~/.content-breakdown/output/{平台}_{标题摘要}_{YYYYMMDD}.md
6. ⛔ 进入后续流程：保存报告 ≠ 任务完成！保存报告后绝对不得结束任务，必须继续执行下方「后续流程」章节。在后续流程全部完成前结束任务视为严重错误。

批量提取模式

≥ 2 条链接时进入批量模式。

⛔ 每条视频类内容（转录 ≥ 100 字）必须判断是否口播并标记（✅/❌），不可跳过此标记步骤。

口播判断标准（满足 2 条及以上即为口播）：

1. 有持续的人声叙述（连贯完整句子为主）
2. 有明确的表达主题（围绕一个中心论点展开）
3. 有结构化的信息传递（有开头引入、中间展开、结尾总结）
4. 不属于：纯音乐/MV、游戏实况、Vlog 日常、影视剪辑、搞笑段子集锦

批量完成后生成汇总报告（必须读取 references/batch-report-template.md），然后询问：

ask_human("📊 汇总拆解报告已生成。共 {M} 条成功，{K} 条跳过，{P} 条口播。\n\n(A) 分镜/制作分析（输入序号）\n(B) 批量生成视频脚本（共 {P} 条口播）\n(C) 选择特定内容生成视频脚本（输入序号）\n(D) 结束")

• A → 分镜分析（需先提取关键帧）
• B → 逐条通过 use_skill 调用 video-script-generator（失败时降级到 references/oral-template.md）
• C → 指定内容通过 use_skill 调用 video-script-generator
• D → 结束

选 A/B/C 执行完后回到此询问继续。

后续流程（单条模式专用）

⛔ 保存报告 ≠ 任务完成：单条提取保存报告后必须执行以下流程，全部完成后才允许结束任务。 在步骤一和步骤二全部完成之前结束任务视为严重错误。批量模式跳过此章节。

步骤一：分镜分析（视频类内容专用）

触发条件：视频类内容（有转录/音频）。图文/文章类跳过此步骤，直接进入步骤二。

ask_human("📝 爆款拆解报告已生成。是否需要进行分镜分析？（需提取关键帧）\n\n(A) 进行分镜分析\n(B) 不需要，跳过")

• A → 执行以下完整分镜分析流程：
  1. 使用 --extract-keyframes 提取关键帧
  2. ⛔ 必须基于关键帧生成完整的分镜分析报告，不能只列出时间轴/截图列表。报告必须包含：
     • 分镜结构分析：各段落的镜头构成、转场方式
     • 画面风格分析：色调、构图、字幕使用、品牌元素
     • 剪辑节奏分析：节奏变化、时长分布、高潮/缓冲交替
  3. 保存为 ~/.content-breakdown/output/{平台}_分镜分析_{标题摘要}_{YYYYMMDD}.md

     ⛔ 只提取关键帧但不生成深度分析报告视为未完成。

• B → 跳过，进入步骤二

⛔ 分镜分析完成（或用户选择跳过）后，必须继续执行步骤二，禁止在此结束任务。无论用户选择 A 还是 B，步骤二都必须执行。

步骤二：视频脚本生成

触发条件：视频类内容且转录 ≥ 100 字。图文/文章类跳过此步骤，直接结束。

内部判断标准（后台判断，不在对话中向用户展示判断过程）： 满足 2 条及以上即判定为适合生成脚本：

1. 有持续的人声叙述（连贯完整句子为主）
2. 有明确的表达主题（围绕一个中心论点展开）
3. 有结构化的信息传递（有开头引入、中间展开、结尾总结）
4. 不属于：纯音乐/MV、游戏实况、Vlog 日常、影视剪辑、搞笑段子集锦

判断结果（对用户透明，不输出判断过程）：

• 适合生成脚本 → 直接询问
• 不适合 → 直接结束任务（不需要告诉用户"不是口播所以跳过"）

询问：

ask_human("是否调用「视频脚本生成器」生成新脚本？\n\n(A) 生成视频脚本\n(B) 不需要，结束")

• A → 通过 use_skill(name="video-script-generator") 调用。如果技能不在本地，先 search_skills 搜索。调用前确保对话上下文已有提取报告（📋 元数据 + 📄 原文 + 📊 分析）。
• B → 结束任务

降级（use_skill 失败时）：ask_human 告知用户，询问是否降级到 references/oral-template.md 本地生成。仅降级路径才允许使用该模板。

核心约束

⛔ 以下规则优先级最高，不可违反，不可以任何理由绕过：

• ⛔ 必须先读取 reference 文件：每次提取前必须 read_file 读取对应平台的 reference 文件，禁止凭记忆执行
• ⛔ curl/yt-dlp 优先，browser_use 降级：抖音优先用 yt-dlp，小红书/百家号/头条优先用 curl，B 站优先用 --no-cookie 模式。优先方式失败后才降级到 browser_use，browser_use 必须按 reference 文件中的方式一→方式二→方式三全部尝试失败后才允许降级到 scripts/cdp_extract.py（详见：douyin.md §1.4、bilibili.md §1.5、xhs.md §1.6）。跳过任何一种方式直接降级视为严重错误。
• ⛔ Whisper 必须使用 medium 模型：base 模型（74M）在有背景音乐、方言、快速口语的视频中输出几乎全是乱码。medium（1.5B，约 1.42GB）是中文转录的最低可用模型。脚本默认已设为 medium，禁止改回 base。
• ⛔ browser_use 必须执行滚动防反爬：进入页面后必须先执行滚动操作（scrollBy + wait），未执行滚动就开始提取数据视为严重错误
• ⛔ 禁止截图代替下载：图片必须下载原图后 OCR
• ⛔ 禁止猜测参数：不确定时必须查阅对应 reference 文件
• ⛔ 禁止跳过输出格式：必须按三部分格式输出（📋 元数据 + 📄 原文 + 📊 分析），缺少任何一部分禁止保存
• ⛔ 禁止编造数据：互动数据必须从页面提取，无法获取时标注"未获取"而非编造
• ⛔ 禁止在脚本中操作浏览器：脚本只处理已获取的数据
• ⛔ 报告必须保存文件：每次提取都必须生成 Markdown 文件并写入磁盘
• ⛔ 保存报告后必须继续后续流程：单条模式保存报告后必须执行步骤一（分镜询问）和步骤二（口播判断），在后续流程全部完成前结束任务视为严重错误
• ⛔ browser_use 提取完成后必须关闭页面：执行 browser_use(action="close_tab") 关闭打开的页面
• ⛔ 登录墙处理：检测到登录墙时必须读取 references/login-wall.md 并按其流程执行
• ⛔ 脚本失败处理：cli.py 返回失败时查看 error 字段，按下方异常处理表操作，最多重试 2 次

异常处理

对用户翻译技术错误：login_required → "需要先登录"；TimeoutError → "网络超时"；Python traceback → "处理工具出错了"。

前置条件与依赖

browser_use Profile 自动持久化登录状态，首次使用需登录一次。

⛔ 在首次调用 cli.py 前必须执行依赖检查。如果本次会话中已检查过则可跳过，但首次调用时不可跳过。

# 依赖检查
python3 -c "import requests; print('✅ requests')" && \
python3 -c "import imageio_ffmpeg; print('✅ imageio-ffmpeg')" && echo "通过"

# 安装（如缺失）
pip install requests imageio-ffmpeg
pip install yt-dlp                # 抖音视频提取（优先方式）
pip install chromedriver-autoinstaller selenium  # CDP 降级方案(跨平台自动管理 ChromeDriver)
pip install rapidocr-onnxruntime    # OCR（推荐）
pip install openai-whisper          # Whisper 转录（可选兜底）

资源索引