kingselyjoe/video-shotcraft-dsh

video-shotcraft

DeepSeek Harness
Checks
License: Apache--2.0

GitHub stars

一个用于打造电影级产品视频的 agent 技能：152 张镜头配方卡 · 209 种风格 · 可复用的 Remotion 演示 · 一个可直接用于生产的模板

video-shotcraft 是一个 DeepSeek Harness agent 技能，可将你的工作区变成一个
动态设计工作室：只需将它指向你的产品，它就会用
Remotion 为电影级宣传、营销、发布或演示视频进行分镜设计、动画制作和
声音设计——包含真实页面捕捉、2.5D 镜头运动、
节拍同步剪辑和电影级音效。

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

✨ 新内容

[!IMPORTANT]
🆕 2026-08 · 48 张新镜头配方卡
库从 104 张增长到 152 张卡片 / 209 种风格。这些内容从
209 个候选动态中提炼而来，经过八轮针对
参考素材的逐帧审查，然后归入常规 Gallery 分类，并配有完整的
配方卡、原生 Remotion 组件
（demos///.tsx，确定性的，并由
归一化进度 t 驱动——接线片段见 demos/README.md），以及
实现配方。全部去品牌化：中性占位文案和一个可替换的 ACCENT 颜色变量。

- 2026-08 · 剪映（CapCut 中国版）项目导出 — 最终交付后，
影片可以导出为可编辑的剪映草稿：底片按
镜头剪切（重定时/重排序/调色），字幕重建为原生文本轨道
（内容/大小/颜色可编辑），SFX/BGM 落在单独的音频轨道上。
已在 macOS 的剪映专业版 11.2 上验证；见
references/jianying-export.md。
- 2026-07 · 音频库重构 — bgm/ + sfx//，包含 149 个
SFX，覆盖 16 个场景/材质类别，经 md5 去重并恢复了许可证 URL。
- 2026-07 · Gallery 升级 — 多分类卡片标签和一个扁平、
按字母排序的本地索引，用于搜索和复制配方名称。

🎬 展示
下面这个 38 秒的 Gallery 介绍本身就是用这套技能制作的——
分镜、镜头实现和声音设计全部由遵循该工具包方法论的 agent 完成：

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 环境

最直接的方式：把仓库链接交给你的 agent。
在 DeepSeek Harness / Claude Code / Codex 或类似的 agent 中，只需说：

帮我安装这个技能：https://github.com/kingselyjoe/video-shotcraft-dsh

agent 会克隆仓库并将其链接到你的 skills 目录中。或者使用
skills CLI / 手动安装：

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

然后像这样提出请求：

使用 video-shotcraft 为我的桌面产品制作一个宣传片。
使用 deck-deal-flyin 和 row-embed 镜头卡来展示这个功能。
设计一个受 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 上观看高清版

要使用它，只需告诉你的 agent：

使用 video-shotcraft 和 Ink Press 模板为我的产品制作一个宣传片。

agent 会替换为你产品的截图、文案和品牌元素，以复现
同样的质量——这是完成一部影片最快、最可靠的路径。

更多模板即将推出。

无头 / CI 注意事项

在无头 Linux 机器上渲染（已测试：2 核，Node 22）会遇到三个
值得了解的障碍：
1. 并发上限 — 在低核心数机器上，remotion still/render 会失败并提示“Maximum for
--concurrency is 2”。修复方法：传入 --concurrency=1。
2. 旧版无头模式移除 — 近期的 Chrome/Chromium 已移除旧版无头模式；
将 Remotion 指向系统 chromium 会导致启动失败。修复方法：使用
chrome-headless-shell 二进制文件，而不是完整的 Chrome。
3. CDN 被屏蔽 — 如果 remotion.media 无法访问，自动下载
headless-shell 会被拒绝。修复方法：
--browser-executable=。

使用这三个标志后，捆绑模板的帧渲染即可正常工作。

📦 包含内容

| 内容 | 描述 |
| --- | --- |
| 152 张镜头配方卡 | 用途、能量、建议时长、参数、实现说明和已知陷阱 |
| 209 种已索引样式 | 可在本地 Gallery 中搜索和筛选；每种都映射到一个配方和演示源 |
| Remotion 实现 | 经过调优的 TSX 演示，包含每张卡片的实际缓动和时序参数 |
| 完整视频模板 | 一个经过验证的 36.2 秒、1920×1080、30fps 产品宣传片，包含 10 个镜头 |
| 组件和资源 | 2.5D 页面相机、字幕、闪切、数字滚动、SFX 和捕获脚本 |
| 制作方法论 | 捕获、视觉方向、故事板、声音设计、节拍同步和最终 QA |
| 剪映项目导出 | 将影片加载到剪映（CapCut CN）中进一步编辑 — 每个镜头的速度、字幕和音频均可编辑（已在 macOS 11.2 上验证） |

该工具包主要面向网页和桌面产品宣传片，而单个
镜头卡片也可用于功能演示、品牌影片、发布视频和
其他动态项目。

🗂 仓库结构

video-shotcraft/
├── SKILL.md                 # Agent 入口点和核心制作规则
├── references/
│   ├── pipeline.md          # 端到端制作工作流
│   ├── shots/               # 152 张镜头配方卡，分为 10 个功能类别
│   ├── sequences/           # 可复用的完整视频结构和序列模式
│   ├── aesthetic-rules.md   # 视觉 QA 标准
│   ├── music-beat-sync.md   # BGM 分析和节拍同步方法论
│   ├── sound-design.md      # 声音设计指导和示例
│   └── jianying-export.md   # 剪映（CapCut CN）项目导出指南
├── demos/                   # Remotion 参考实现（相同类别）
├── gallery/                 # 静态动态预览 Gallery
├── template/                # 可运行的完整视频模板
├── jianying-export/         # 剪映草稿安装器（mac 已测试 / win 未测试）
└── assets/
├── lib/                 # 可复用的 Remotion 组件
├── scripts/             # 页面资源捕获脚本
└── audio/               # 音频资源
├── bgm/             # 5 个 BGM 选项
└── sfx//  # 149 个 SFX，涵盖 16 个场景类别

有关完整工作流和实现要求，请参阅 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 的屏幕震动演讲、经典动画时序）为多张卡片提供了参考。