从视频链接提取字幕并交付为 .docx 文件。用户提供链接(如 YouTube、Bilibili 等)时使用此技能。
视频 Transscript STill.
功能概述
视频 Transscript STill.是一项面向实际任务的技能,主要用于Extract 字幕来自视频 URL,并发送干净的.docx 记录文件. 对于非中文视频,制作两个文件:原始语言+中文翻译. .;For Chine.。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
使用与执行
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
视频字幕提取技能
从视频 URL 提取字幕,并生成格式整洁的 .docx 转录文件。
对于非中文视频,输出两个文件:原文 + 中文翻译;
对于中文视频,仅输出一个文件。
工作流程
步骤 0 — 首次设置(仅需执行一次)
检查脚本目录下是否存在 node_modules。若不存在,请运行:
$skillScripts = "$env:USERPROFILE.agentsskillsvideo-transcriptscripts"
if (-not (Test-Path "$skillScriptsnode_modulesdocx")) {
Push-Location $skillScripts
npm install
Pop-Location
}
步骤 1 — 使用 yt-dlp 下载字幕
在临时目录中执行(Windows 下使用 $env:TEMPvt_):
$tmp = "$env:TEMPvt_$(Get-Random)" New-Item -ItemType Directory -Force $tmp | Out-Null
YouTube 视频:
# 优先尝试人工字幕,失败后回退至自动生成字幕 yt-dlp --skip-download --write-subs --write-auto-subs --sub-langs "en,zh-Hans,zh-Hant,zh" --convert-subs srt -o "$tmpsub" ""
Bilibili 视频:
yt-dlp --skip-download --write-subs --sub-langs "zh-Hans,zh,ai-zh" --convert-subs srt -o "$tmpsub" ""
其他平台:可复用上述 YouTube 命令——yt-dlp 可自动适配大多数平台。
下载完成后,列出已获取的字幕文件:
Get-ChildItem $tmp -Filter "*.srt"
步骤 2 — 检测可用字幕文件
选择最优字幕文件:
- 优先选用人工字幕而非自动生成字幕(例如
.en.srt优于.en-orig.srt或.en-auto.srt) - 对于 Bilibili 视频:优先选用
zh-Hans或ai-zh - 若存在多种语言字幕,请全部记录
若未成功下载任何字幕文件:
- 提示用户:“该视频没有可用字幕,yt-dlp 无法提取文字内容。如需转录请使用 Whisper 语音识别(需额外安装)。”
- 立即终止流程。
步骤 3 — 将 SRT 解析为纯文本
读取 .srt 文件,移除所有时间码与序号行,仅保留实际 spoken text 行。
SRT 示例(需剔除部分):
1 00:00:01,000 --> 00:00:03,500 This is the spoken text. 2 00:00:04,000 --> 00:00:06,000 More text here.
输出要求:
- 纯文本格式
- 每个字幕块对应一个段落
- 删除段落间的空行,合并为连贯段落
- 移除 HTML 标签(如 、、 等)
请自行读取文件内容完成该解析过程,无需调用外部工具。
步骤 4 — 如需则执行翻译
检测字幕语言:
- 若为中文(zh / zh-Hans / zh-Hant):跳过翻译,仅生成一个文件
- 若为其他语言:使用你自身的翻译能力,将全部纯文本完整译为中文
翻译规范:
- 产出自然、通顺、符合中文表达习惯的译文,避免逐字直译
- 保留原文段落结构
- 专有名词、技术术语等应音译或根据上下文内嵌说明
- 严禁添加评论、总结或额外解释——仅限纯翻译
步骤 5 — 生成 .docx 文件
使用内置脚本:
脚本路径为:~/.agents/skills/video-transcript/scripts/make_docx.js
视频标题优先从 yt-dlp 输出中提取;若不可得,则对 URL 进行清洗后作为备选标题。
非中文视频(生成两个文件):
# 原文 node "~/.agents/skills/video-transcript/scripts/make_docx.js" "$tmptranscript_original.docx" "- Original" " " # 中文译稿 node "~/.agents/skills/video-transcript/scripts/make_docx.js" "$tmptranscript_zh.docx" " - 中文译稿" " "
中文视频(仅生成一个文件):
node "~/.agents/skills/video-transcript/scripts/make_docx.js" "$tmptranscript_zh.docx" "- 讲稿" " "
对于超长文本,建议先写入临时 .txt 文件再通过管道传入:
$plain | Out-File -Encoding utf8 "$tmpcontent.txt" Get-Content "$tmpcontent.txt" -Raw | node "~/.agents/skills/video-transcript/scripts/make_docx.js" "$tmptranscript_original.docx" ""
步骤 6 — 向用户交付结果
清晰告知用户输出文件路径:
- “原文讲稿:
C:...transcript_original.docx” - “中文译稿:
C:...transcript_zh.docx”
可选:展示提取文本的前 200 字作为简短预览,便于用户验证内容质量。
错误处理
| 情形 | 应对措施 |
|---|---|
| 未找到字幕 | 通知用户,并建议使用 Whisper 作为替代方案 |
| 未安装 yt-dlp | 运行 yt-dlp --version 检查;若缺失,提示用户安装 |
| node/docx 报错 | 显示具体错误信息,并检查全局是否已安装 docx npm 包 |
| 私有视频或地域限制视频 | 告知用户该视频无法访问 |
注意事项
- 交付文件后,请清理
$tmp目录;或保留并明确告知用户临时路径 make_docx.js脚本会自动从全局 npm 解析docx包- 对于极长视频,翻译可能耗时稍久,请提前向用户说明
热门AI工具
相关专题
本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。
0
2026.10.22
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。
0
2026.10.22
PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.4万人学习
共6课时 | 54.7万人学习
