电影感视频工坊 kingselyjoe/video-shotcraft-dsh

video-shotcraft

用来打造电影感产品视频的智能体技能：152 张镜头配方卡 · 209 种风格 · 可复用的 Remotion 演示 · 一套可直接上生产的模板

video-shotcraft 是 DeepSeek Harness 的智能体技能，能把你的工作区变成一间动态设计工作室：把它对准你的产品，它就会用 Remotion 做分镜、做动画、做声音设计，产出一支电影感的宣传片、营销片、发布片或演示片——包含真实页面截取、2.5D 运镜、卡点剪辑，还有电影级音效。

🖼️ 在本地 Gallery 索引里浏览全部 152 张卡片和 209 种风格 »

✨ 新变化

[!IMPORTANT]
🆕 2026-08 · 新增 48 张镜头配方卡库从 104 张扩充到 152 张卡片 / 209 种风格。这些卡片从 209 个候选动效里提炼而来，经过八轮逐帧比对参考素材，再并入 Gallery 的常规分类，配齐完整配方卡、原生 Remotion 组件（demos/<category>/<name>/<Component>.tsx，确定性渲染，由归一化进度 t 驱动——接线代码片段见 demos/README.md），以及实现配方。全部去品牌化：中性占位文案，外加一个可替换的 ACCENT 颜色变量。

- 2026-08 · 剪映（CapCut 中国版）工程导出——最终交付之后，成片可以导出为可编辑的剪映草稿：画面按镜头切分（可变速/重排/调色），字幕重建为原生文本轨道（内容/字号/颜色可编辑），音效和 BGM 分别落在独立音频轨道上。已在 macOS 版剪映专业版 11.2 上验证；见 references/jianying-export.md。
- 2026-07 · 音频库重构——bgm/ + sfx/<category>/，16 个场景/材质分类下共 149 个音效，按 md5 去重，并补回授权链接。
- 2026-07 · Gallery 升级——卡片支持多分类标签，新增一份扁平化、按字母排序的本地索引，方便搜索和复制配方名。

🎬 作品展示

下面这段 38 秒的 Gallery 片头，本身就是用这套技能做出来的——分镜、镜头实现、音效设计，全都由智能体按照工具包的方法论完成：

https://github.com/user-attachments/assets/cba2df8a-4b2e-4247-bace-d0b1dea9c2bd

▶️ 在 YouTube 上看高清版

在本地 Gallery 索引 里浏览每一张镜头卡——搜索、筛选、切换变体，还能复制选中的镜头卡名称。

🚀 快速开始

DeepSeek Harness

Windows PowerShell：

git clone https://github.com/kingselyjoe/video-shotcraft-dsh.git
cd video-shotcraft-dsh
.\\install-dsh.ps1

macOS / Linux：

git clone https://github.com/kingselyjoe/video-shotcraft-dsh.git
cd video-shotcraft-dsh
bash install-dsh.sh

安装完成后运行 python scripts/dsh_manager.py doctor。安全、更新、卸载的细节见 DeepSeek Harness 指南。

其他 Agent Skills 环境

最直接的办法：把仓库链接丢给你的智能体。 在 DeepSeek Harness / Claude Code / Codex 或类似智能体里，直接说：

Install this skill for me: https://github.com/kingselyjoe/video-shotcraft-dsh

智能体会克隆仓库，再链接到你的技能目录。也可以用 skills 命令行安装，或者手动装：

npx skills add kingselyjoe/video-shotcraft-dsh

git clone https://github.com/kingselyjoe/video-shotcraft-dsh.git
cd video-shotcraft-dsh
ln -s "$(pwd)" ~/.claude/skills/video-shotcraft # Claude Code
or
ln -s "$(pwd)" ~/.codex/skills/video-shotcraft # Codex

然后这样提需求：

Use video-shotcraft to create a promo for my desktop product.
Use the deck-deal-flyin and row-embed shot cards to present this feature.
Design a product close-up inspired by spotlight-hero-card.

如果没指定镜头卡，技能会先介绍内置的视频模板，再问你要不要用；你也可以在开始前先去 Gallery 里挑镜头。

📼 视频模板：Ink Press

技能自带 Ink Press——一套验证过的完整宣传片模板： 36.2 秒，1920×1080，30fps，10 个镜头，纸墨琥珀风格，带 2.5D 真实翻页运镜、标题卡、转场，还有一整套锁定的电影级音效：

https://github.com/user-attachments/assets/4cf5af51-98f3-4af2-8ab2-7267f470513d

▶️ 在 YouTube 上看高清版

要用它，直接告诉你的智能体：

Use video-shotcraft to make a promo for my product with the Ink Press template.

智能体会换上你产品的截图、文案和品牌，做出同样水准的片子——这是最快、最稳的成片路径。

更多模板正在路上。

无头 / CI 注意事项

在无头 Linux 机器上渲染（实测：2 核，Node 22）会撞上三堵墙，值得提前知道：
1. 并发上限 —— 在核心数少的机器上，remotion still/render 会报错「Maximum for --concurrency is 2」。修复：传入 --concurrency=1。
2. 旧版 Headless 被移除 —— 最近的 Chrome/Chromium 已去掉旧版 headless 模式；把 Remotion 指向系统 chromium 会启动失败。修复：改用 chrome-headless-shell 二进制，不要用完整版 Chrome。
3. CDN 被墙 —— 如果 remotion.media 无法访问，自动下载 headless-shell 会被拒绝。修复：--browser-executable=<path-to-local chrome-headless-shell>。

加上这三个参数，用内置模板渲染帧就能跑通。

📦 包含内容

| 内容 | 说明 |
| 152 张镜头配方卡 | 用途、能量、建议时长、参数、实现说明、已知坑 |
| 209 个已索引风格 | 可在本地 Gallery 中搜索和筛选；每个都对应一张配方卡和一份演示源码 |
| Remotion 实现 | 调好的 TSX 演示，含每张卡实际的缓动与时间参数 |
| 完整视频模板 | 一条验证过的产品宣传片：36.2 秒、1920×1080、30fps、10 个镜头 |
| 组件与素材 | 2.5D 页面相机、字幕、闪切、数字滚动、SFX、采集脚本 |
| 制作方法论 | 采集、视觉方向、分镜、声音设计、卡点同步、终审 |
| 剪映工程导出 | 把成片导入剪映（CapCut 中国版）继续剪辑 —— 每个镜头的速度、字幕、音频都可编辑（已在 macOS 11.2 验证） |

这套工具主要面向网页和桌面产品宣传片，单张镜头卡也能用在功能演示、品牌片、发布会视频等动态项目里。

🗂 仓库结构

video-shotcraft/
├── SKILL.md # Agent entry point and core production rules
├── references/
│ ├── pipeline.md # End-to-end production workflow
│ ├── shots/ # 152 shot recipe cards in 10 functional categories
│ ├── sequences/ # Reusable full-video structures and sequence patterns
│ ├── aesthetic-rules.md # Visual QA criteria
│ ├── music-beat-sync.md # BGM analysis and beat-sync methodology
│ ├── sound-design.md # Sound-design guidance and examples
│ └── jianying-export.md # JianYing (CapCut CN) project-export guide
├── demos/ # Remotion reference implementations (same categories)
├── gallery/ # Static motion-preview Gallery
├── template/ # Runnable complete video template
├── jianying-export/ # JianYing draft installers (mac tested / win untested)
└── assets/
├── lib/ # Reusable Remotion components
├── scripts/ # Page-asset capture scripts
└── audio/ # Audio assets
├── bgm/ # 5 BGM options
└── sfx/<category>/ # 149 SFX across 16 scene categories

完整工作流和实现要求见 SKILL.md， production pipeline，以及 visual QA criteria。

🔊 音频与素材说明

assets/audio/ 下的音频文件可按各自的许可条款使用。
来源与许可详情见 ATTRIBUTION.md。

SFX 按 16 个场景／材质类别组织（transition impact riser camera ui text paper film light data scifi mech glass fluid crowd counter）——先选类别，再选音色。类别索引与逐文件用法见 sound-design.md。

模板自带的产品截图是演示素材。发布前请替换为目标产品的截图，并确认是否有产品、客户或个人信息需要匿名化处理。

🙏 致谢

本库中的许多镜头配方，都是通过研究优秀官方产品影片的动效语言提炼而来——包括 ClickUp、 Perplexity、Slack、Notion、Figma、Framer、Bear、Raycast、Pitch、Miro、Superhuman 和 Loom 的宣传片。卡片记录的是动效技法（时序、缓动、编排），全部从零重新实现；本仓库不包含这些影片的任何画面、美术素材或品牌资产。所有商标归各自所有者所有，这些公司均与本项目无关联，也未对本项目背书。
2026-08 新增的 48 张卡片，其逐批来源说明见 references/shots/ATTRIBUTION.md。

特别感谢：

- Remotion —— 基于 React 的视频框架，这里每个演示和模板都由它驱动。注意 Remotion 有自己的许可（个人和小团队免费；公司可能需要付费许可）。
- Mixkit —— 随附的 SFX 和音乐素材来源，按其免费商用许可提供。
- 游戏手感与动画社区，他们公开的原则（例如 Vlambeer 的屏幕震动演讲、经典动画时序）为多张卡片提供了参考。