AI生成剪映草稿

技能文档

---
name: jianying-editor-skill-ai
title: AI生成剪映草稿
category: 内容创作
description: 自动化剪映专业版视频剪辑与草稿生成，主打解说评论视频工作流。当需要将长视频、文字稿、SRT字幕、解说脚本或分镜转为剪映草稿、选择排列素材片段、生成TTS配音与对齐字幕、添加背景音乐和特效、检查或修复草稿、导出完整项目时使用。触发词：剪映、视频剪辑、解说视频、草稿生成、字幕对齐
---

# 剪映编辑器

在用户的项目目录中创建业务脚本，不要在已安装的技能目录内操作。将源素材和已有草稿视为不可变，除非用户明确要求替换。

## 技能工作流

### 步骤1：环境检查

当环境尚未配置时，阅读 [references/installation.md](references/installation.md)，然后运行环境检测：

```bash
python <SKILL_ROOT>/scripts/api_validator.py --json
```

### 步骤2：确定任务类型

- 解说评论或长视频总结：按照 [references/narrated-editing-workflow.md](references/narrated-editing-workflow.md) 执行。
- 已有分镜转草稿：先验证分镜，再试运行，最后正式构建。
- 通用草稿编辑：仅阅读 `rules/` 下的相关文件。

### 步骤3：路径与命名

- 使用绝对输入/输出路径。从已安装的技能目录解析 `<SKILL_ROOT>`；不要假设用户名或盘符。
- 默认生成唯一草稿名。仅在用户明确批准后才使用 `--overwrite`。

### 步骤4：生成草稿后检查

```bash
python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "<DRAFT_NAME>" --json
```

报告草稿名称、草稿路径、已创建的轨道、警告信息，以及仍需手动完成的步骤。

## 解说评论快速路径

准备与 [references/storyboard.example.json](references/storyboard.example.json) 匹配的分镜 JSON，然后依次执行：

```bash
python <SKILL_ROOT>/scripts/storyboard_validator.py storyboard.json --video input.mp4
python <SKILL_ROOT>/scripts/movie_commentary_builder.py \
  --video input.mp4 \
  --json storyboard.json \
  --name "Commentary_Project" \
  --tts \
  --speaker zh_male_huoli \
  --dry-run
python <SKILL_ROOT>/scripts/movie_commentary_builder.py \
  --video input.mp4 \
  --json storyboard.json \
  --name "Commentary_Project" \
  --tts \
  --speaker zh_male_huoli
```

对话、反应、揭晓或其他需要保留源音频的片段使用 `mode: "original"` 并将 `text` 留空。解说部分使用 `mode: "narration"`。

## 硬性规则

- 不得凭空编造源素材时间戳。必须从提供的文字稿/场景分析中推导，或向用户确认。
- 保持时间顺序，除非用户要求倒叙、悬念前置或蒙太奇结构。
- 每个选中的片段必须传递故事信息、情感、证据或有意的节奏节点。
- 当原始对话比解说更有力时，保留原始对话。
- 解说要足够简洁以适配所选片段。如果生成的TTS超出计划时长，应警告并延长/改写，而不是静默地重叠场景。
- 不得打包、复制或发布用户的剪映缓存、会员资源、本地草稿、签名媒体URL、账户数据或设备特定路径。
- 未经用户明确批准，不得下载云端资源。除非设置 `JY_ALLOW_CLOUD_RESOLVE=1`，否则禁用动态云端解析。
- 不得在未检查导出文件/草稿的情况下声称视频已导出或视觉正确。

## 相关资源

- `scripts/movie_commentary_builder.py`：从分镜JSON构建解说/原声混合草稿。
- `scripts/storyboard_validator.py`：验证时间戳、重叠、时长和格式。
- `scripts/jy_wrapper.py`：通用草稿API。
- `scripts/draft_inspector.py`：检查生成的草稿。
- `scripts/auto_exporter.py`：在支持的Windows环境下自动化剪映导出。
- `scripts/asset_search.py`：搜索特效和转场元数据。
- `rules/setup.md`：路径与导入引导。
- `rules/core.md`：保存、草稿安全与导出。
- `rules/media.md`：媒体放置与时间控制。
- `rules/text.md`：字幕与文本。
- `rules/audio-voice.md`：TTS与音频行为。
- `rules/effects.md`：滤镜、特效与转场。
- `rules/cli.md`：机器可读的命令行为。

使用说明

# AI生成剪映草稿

自动化剪映专业版视频剪辑，将文字稿、分镜或长视频一键转为可编辑的剪映草稿。

## 使用

准备分镜 JSON 和视频文件，执行：

```bash
# 环境检测
python <SKILL_ROOT>/scripts/api_validator.py --json

# 验证分镜
python <SKILL_ROOT>/scripts/storyboard_validator.py storyboard.json --video input.mp4

# 生成解说草稿（含TTS配音）
python <SKILL_ROOT>/scripts/movie_commentary_builder.py \
  --video input.mp4 \
  --json storyboard.json \
  --name "我的解说视频" \
  --tts \
  --speaker zh_male_huoli

# 检查草稿
python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "我的解说视频" --json
```

## 工作原理

技能基于 pyJianYingDraft 库，将分镜脚本解析为剪映草稿格式。支持解说与原声混合模式，自动生成TTS配音并对齐字幕，处理片段排列、转场和特效。支持 Windows 全功能和 macOS 实验性路径。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。