Video Script Pro｜视频转拍摄脚本

一个面向短视频创作的 AI 技能：根据抖音视频或本地视频，整理出编导、摄影、演员和剪辑人员便于阅读和执行的图文分镜脚本。

脚本以完整台词和连贯的剧情段落为核心，配合参考画面、人物动作和必要的拍摄提示，避免逐秒拆解和冗长说明。

安装包已包含 douyin-parse 的解析代码，无需另外下载该技能。 安装后，AI 可以调用它解析抖音分享链接、下载视频，再进行内容分析和脚本整理。

安装：把这段话发给 AI

请帮我将 https://github.com/SJ3199/video-script-pro 中的 video-script-pro 技能安装到当前 AI 软件使用的技能目录，保留随包提供的 douyin-parse，并完成运行环境检查；如果 GitHub 下载失败，请尝试 README 中的备用下载地址，仍无法下载时再提示我提供 ZIP 安装包，Python 依赖优先通过清华镜像安装。

这段提示词适用于支持技能加载、文件操作和终端命令的 AI 软件。以 Trae 项目为例，安装后的入口文件应位于 项目目录/.trae/skills/video-script-pro/SKILL.md；其他软件应使用各自的技能目录。

如果只使用不具备本地执行能力的网页聊天界面，AI 无法直接完成安装和视频下载。

GitHub 下载较慢或无法访问时

可以选择以下方式，无需安装 Git：

1. 下载完整安装包。 在 最新版本页面 下载 video-script-pro-v1.0.3.zip，也可以使用 仓库中的安装包。
2. 使用备用下载地址。 下载 安装脚本，保存为 install.py，然后执行下面的安装命令。脚本会下载指定版本的文件并校验完整性；某条线路失败时，会尝试另一条线路。
3. 通过文件传输获取安装包。 如果上述地址都无法访问，可以请已下载的用户通过网盘、U 盘等方式提供同一版本的 ZIP 文件。解压后安装技能本身无需连接 GitHub；尚未安装的 Python 依赖仍需联网获取，或提前准备离线依赖包。

备用地址是否可用取决于当地网络。Python 依赖支持使用清华 PyPI 镜像下载；备用文件分发使用 jsDelivr。

使用安装脚本

将下方的 项目目录 替换为实际路径，再在终端执行：

python install.py --skills-dir "项目目录/.trae/skills" --cn
python "项目目录/.trae/skills/video-script-pro/scripts/bootstrap.py" --install --cn

第一条命令安装技能文件；第二条命令创建独立的 Python 虚拟环境并安装依赖。--cn 会使用面向国内网络的下载选项，不会修改系统代理或全局 pip 配置。

手动安装 ZIP 包

解压后，将其中的 video-script-pro 文件夹放入当前软件的技能目录，再执行上面的第二条命令。升级时请先备份旧版本；安装脚本不会自动覆盖已有目录。

运行环境要求：Python 3.10 或更高版本，以及可从终端调用的 ffmpeg 和 ffprobe。具体检查与安装方法见抖音视频下载指南。

使用：把视频整理成拍摄脚本

安装完成后，将下面的提示词发给 AI，并把最后一行替换为实际分享链接：

请使用 video-script-pro 分析下面的视频，整理成简洁清晰、可用于拍摄的分镜脚本。保留原片的完整台词并标明说话人，按连贯的剧情段落组织镜头，每组配上参考画面、人物动作和必要的拍摄提示，输出可在浏览器中打开的 HTML 文件。不要逐秒拆解，也不要用剧情概述代替台词；听不清的内容请标注待确认。

视频链接：【在这里粘贴抖音分享链接】

如果使用本地视频，把最后一行换成视频文件路径即可。如果希望改编剧情或重写台词，请在提示词中明确说明。

手动调用下载工具

通常由 AI 按技能说明执行，无需用户逐条输入。需要单独下载时，可使用：

"虚拟环境中的Python路径" "技能目录/dependencies/douyin-parse/scripts/parse_and_download.py" "抖音分享链接" --output "work/source.mp4"

将命令中的路径替换为实际路径；bootstrap.py 的检查结果会给出可用的 Python 路径。Windows PowerShell 用户需在带引号的 Python 路径前加 &。

下载工具会检查文件是否包含有效视频，并进行完整解码验证。视频内容理解、台词转写和分镜整理仍需由具备相应能力或工具的 AI 完成。

抖音视频可能因登录状态、访问限制或平台风控而无法下载。遇到这类情况，技能会提示改用已能正常播放视频的浏览器，或使用本地视频文件，不会把下载失败的网页当作视频继续处理。

脚本包含什么

• 连贯的镜头安排： 三分钟剧情视频通常整理为约 10–16 个拍摄段落，具体数量根据内容调整，不机械地按每次切镜拆分。
• 完整台词： 每段列出说话人及其台词，无对白的段落明确标注；原片台词与改编台词分开说明。
• 准确的说话人标注： 画面切到听者的反应时，仍根据声音判断谁在说话，不能直接把台词归给画面中的人物。
• 简明的拍摄提示： 参考画面、人物动作和必要的拍法放在一起，便于现场查看。
• 便于查看的页面： 支持演员、摄影和剪辑视图切换，也可以打印；生成的 HTML 可离线打开。

技能会复用已有的视频、抽帧和转写结果，只对不确定的片段补充检查，并使用固定模板生成页面，以减少重复处理和不必要的 token 消耗。

文件说明

文件或目录	用途
SKILL.md	AI 读取的技能入口和工作规则
references/	下载、说话人判断及脚本输出规范
scripts/	环境检查、素材处理和页面生成工具
assets/	HTML 页面模板
dependencies/douyin-parse/	随包提供的抖音视频解析工具

安装包不含 Cookie、账号凭据、用户视频或业务脚本。第三方代码的来源、修改记录及许可说明见 THIRD_PARTY_NOTICES.md。