视频逐字稿提取 + 对标归档
从视频链接提取逐字稿,AI 校对后归档到对标博主目录。
工作流程
Step 0:首次使用前的环境准备(仅第一次需要)
如果是从开源仓库刚装好的 skill,需要先准备运行环境:
# 1. 系统依赖(macOS)
brew install yt-dlp ffmpeg
# 2. Python 虚拟环境 + 腾讯云 ASR SDK
python3 -m venv .claude/skills/li-transcript/scripts/.venv
.claude/skills/li-transcript/scripts/.venv/bin/pip install tencentcloud-sdk-python-asr
# 3. 在项目根目录创建 .env 文件,填入腾讯云密钥(控制台 https://console.cloud.tencent.com/cam/capi 申请)
# 格式:
# TENCENT_SECRET_ID=你的_id
# TENCENT_SECRET_KEY=你的_key
环境准备好之后,跳到 Step 1。
Step 1:转录视频
运行转录脚本(脚本和 venv 都在 skill 目录下,自包含):
.claude/skills/li-transcript/scripts/.venv/bin/python3 .claude/skills/li-transcript/scripts/video2text.py "视频链接"
脚本会输出:
- stderr:进度信息 +
[标题] xxx(视频原标题) - stdout:去除时间戳的纯文本逐字稿
脚本报错时的排查顺序:
- 项目根目录的
.env是否包含TENCENT_SECRET_ID和TENCENT_SECRET_KEY(脚本会从当前目录向上查找最多 6 层) .claude/skills/li-transcript/scripts/.venv/是否正常(重建:python3 -m venv .claude/skills/li-transcript/scripts/.venv && .claude/skills/li-transcript/scripts/.venv/bin/pip install tencentcloud-sdk-python-asr)- 视频链接是否被 yt-dlp 支持
Step 2:AI 校对
对原始逐字稿做文字校对,只改错字不改内容:
- 同音/近音字纠错:根据上下文推断(如「艺人公司」→「一人公司」、「四动会」→「私董会」、「体校」→「提效」)
- 专有名词修正:技术术语、产品名、人名、英文词汇
- 明显的 ASR 乱码:替换为合理推断
保留口语表达(「啊」「嗯」「就是说」),不改写句子结构,不美化风格。
校对直接执行,不逐条列出差异——用户想核对可以自己对比原文。
Step 3:识别作者 & 归档
识别作者——按优先级:
- 用户已告知 → 直接使用
- 逐字稿中有自我介绍(「大家好我是XXX」「我是XXX」)→ 提取
- 都没有 → 问用户
匹配对标——读取 05-选题研究/对标博主/短视频/ 目录列表:
- 匹配到已有博主 → 归档到该目录
- 没匹配到 → 问用户「[名字]还不在对标列表里,创建吗?」,同意则创建目录
作者和是否创建对标可以合并为一次提问,减少来回。
确定标题——优先用 yt-dlp 获取的原标题(stderr 中 [标题] 行),获取不到则从逐字稿内容概括一个。
Step 4:保存文件
路径:05-选题研究/对标博主/短视频/[博主名]/[YYYY年M月]/[视频标题].md
时间目录不存在则创建。
格式——根据视频来源平台调整 YAML 字段名:
---
[平台]数据:
点赞数:
收藏数:
评论数:
分享数:
观看数:
tags:
---
# 标题
[视频标题]
# 封面花字
# 视频脚本
[校对后的完整逐字稿]
平台判断规则:
- URL 含
xiaohongshu.com→小红书数据 - URL 含
bilibili.com→B站数据 - URL 含
douyin.com→抖音数据 - URL 含
youtube.com或youtu.be→YouTube数据 - 其他 →
平台数据
保存后一句话告知路径。