zenstory-ai/drama-skills / skills/short-drama-edit
short-drama-edit
Verified将已生成的短剧镜头与配音剪成成片,编写剪辑单并完成渲染验收。用于“剪成成片/套剪”“加字幕/画面文字”“统一响度”“调整成片剪辑节奏、配乐/字幕混音与渲染导出”或导出精修素材;需补素材或改故事时转回上游阶段。
assets/remotion/README.md
View on GitHub# Remotion 图文叠加层(可选)
本模块为 `short-drama-edit` 的**可选**图形渲染扩展,仅用于两类可选场景:渲染剪辑单中的 `画面文字` 图文层(含通用 `字卡`/`卡片`/`角标`,以及可选的系统流题材模板 `系统面板`/`任务面板`),或按需替代默认 `ffmpeg` 路线输出动态字幕排版。
> 常规剪辑、接镜调色、混音与默认字幕烧录(`ffmpeg` + `libass`)**不依赖 Node.js 或 Remotion**(两条字幕路线的字号与边距标准见 [声音字幕与响度](../../references/editing-guide.md#声音字幕与响度))。
## 无 Node / Remotion 时的降级方案
若本机未安装 Node.js/npm,或处于受限无头环境无法启动无头浏览器:
1. **仅走 `ffmpeg` 渲染**:省略剪辑单中的 `画面文字` 行,直接运行默认 `edit_tool.py render`(走 `ffmpeg` 烧录字幕)或传 `--no-subtitles` 输出无字幕成片。
2. **导出给外部 NLE 精修**:保留 `剧集/<EP>/剪辑单.md` 作为剪辑决策表,用 `--no-subtitles` 输出干净母版与分段中间文件,配合 SRT/ASS 字幕交外部剪辑软件(剪映、Premiere、DaVinci Resolve 等)添加标题字卡与动效层。
## 跨平台安装与运行
运行工作区位于项目目录之外,默认为用户主目录下的 `.cache/short-drama-edit/remotion`(也可用 `--remotion-workspace <自定义项目外目录>` 指定其他路径)。`edit_tool.py` 每次渲染会自动同步本目录源码,调整样式只需修改本目录下的 `src/`。
**1. 安装依赖(需 Node.js 与 npm)**
- macOS / Linux:
```bash
mkdir -p ~/.cache/short-drama-edit/remotion && cd ~/.cache/short-drama-edit/remotion && npm install
```
- Windows PowerShell:
```powershell
New-Item -ItemType Directory -Force "$HOME\.cache\short-drama-edit\remotion" | Out-Null
Set-Location "$HOME\.cache\short-drama-edit\remotion"
npm install
```
(首次未同步 `package.json` 时,先运行一次 `edit_tool.py render` 或手动把本目录 `package.json` 复制到工作区后再执行 `npm install`。)
**2. 触发渲染**
剪辑单含有 `画面文字` 时,`render` 会自动调用 Remotion;仅需切换动态字幕路线时显式传入 `--subtitles remotion`(`<SKILL_DIR>` 为本技能目录,需 Python 3.9+;Windows 将 `python3` 换为 `py -3` 或 `python`):
```bash
python3 <SKILL_DIR>/scripts/edit_tool.py render <剧集/EP001> --project-root <project> --subtitles remotion
```
Remotion 先渲染带透明通道的视频层(VP8 + alpha),再由 `ffmpeg` 叠合到成片画面;字幕走默认 `ffmpeg` 路线时,烧录层级位于画面文字之上。
## 字体、性能与许可证
- **内置字体包**:随 `npm install` 安装 `@fontsource/noto-sans-sc`(700/900 字重)与 `@fontsource/jetbrains-mono`(800 字重,SIL OFL 1.1),开渲前对常规汉字、拉丁字母与标点逐一核验内置字重已加载就绪(加载失败立即报错退出),Emoji 与特殊图形符号自然回退系统字体,不中断整片导出。
- **逐帧开销与并发**:无头浏览器按整片总帧数逐帧截屏并编码透明通道。`edit_tool.py` 默认传 `--concurrency=2` 防止撑爆内存;调高并发数前先在工作区运行 `npx remotion benchmark` 实测本机负载。
- **许可证**:正式使用前请对照 [官方许可证](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md) 核对 Remotion 商用与授权条款;本套件的 MIT 许可证不涵盖 Remotion 本身。
## 源码结构
| 文件 | 作用 |
|---|---|
| `src/schema.ts` | 图文层输入参数结构(字幕、画面文字、画幅尺寸、帧率) |
| `src/Overlay.tsx` / `src/Root.tsx` | 字体就绪校验、图层上下关系(画面文字在下、字幕在上)与工程注册 |
| `src/Subtitles.tsx` | 按画面高度比例自适应排版的字幕组件 |
| `src/screen/ScreenText.tsx` / `tokens.ts` / `chrome.tsx` | 画面文字时间段分发、共用配色与动效参数及可选面板外框组件 |
| `src/screen/Caption.tsx` / `Card.tsx` 等 | 通用样式(`字卡`、`卡片`、`角标`)与可选系统流模板(`系统面板`、`任务面板`)组件 |
| `src/rules.mjs` / `src/font.ts` | 字体加载检查、打字机逐字进度、进度条与按帧倒计时纯函数 |
| `remotion.config.ts` | 透明 alpha 通道输出配置 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |