超级峰的视频设计方法论

提供音乐，Agent 根据实际唱词、旋律与情绪选择视觉主线和风格，组织场景、镜头、动作与字幕。你可以指定主题和形式，也可以把这些创作选择交给 Agent。

用 $chaojifeng-video-design 把【音乐文件或链接】做成音乐视频。
保留原曲，按音乐组织具体场景、运镜、切换和动作峰值。
主题和风格由你根据歌曲选择，直接完成成片和可编辑工程。

慢歌同样安排声画落点。音乐营造氛围并带动画面，场景发展、主体动作、运镜和转场共同建立沉浸感。有演唱时先建立歌词时间线；字幕默认中文为主、英文为辅，明确要求英文时采用纯英文，也可以指定其他语言或无字幕。

需要三维世界时，可以进一步指定：

用 $chaojifeng-video-design 做一支音乐驱动的三维视频。
音乐：【音乐文件或链接】
主题：【要表现的对象或讲清的关系】
风格：【水墨、烟雨、诗词意象、理论概念或自己的风格描述】
直接完成成片和可编辑工程。

三维分支未指定规格时默认约60秒、1080p、30fps，按音源实际长度与完整乐句选择，已有项目或明确要求优先。水墨用墨滴、山体与河道表现力度；烟雨用器物、笔触、雾层组织尺度；诗词让琴弦、水波、笔触与诗字接力；理论概念让对象、投影与公式表达关系。音乐先分析，再编排预备、触发、峰值、落定和停留。

内置音乐分析与事件校验工具，以及 Blender＋Remotion、Three.js＋Remotion 两条起步工程。Agent 会按新主题完善对象与关系，复用时间、镜头和外观层。查看 完整制作流程 或 在线作品与风格图册。

从真实声音出发，把每个关键段落变成能看见变化、能听见联系的事件，再通过短段预演检查是否兑现。

可编辑流程定义 · 矢量图

音乐视频默认以代码构建可动主体与场景，让前后景、镜头、动作、转场和字幕由同一音乐排程组织。图片可作为背景、纹理或局部素材；明确要求静态图片作品或其他形式时按你的要求制作。

短段预演覆盖前三秒与关键音乐落点，检查动作、运镜、转场和字幕是否实际发生；未兑现先返修。预演和返修由 Agent 内部完成；选择直接成片时连续推进，只有你要求分阶段审阅，才在约定节点等待。六层判断详见 声画事件模型，具体执行见 音乐镜头与运动编排。

同一个长镜头可以跨越多个拍点，在内部改变焦点、距离和关系。慢歌可以借长音推进、换气衔接、重音落定；具体选择取决于真实音乐。每拍闪光、全程匀速推镜或单纯增加雨量，都不能代替这种编排。

以“越过门框，发现空椅子”为例，镜头可以这样展开。每个关键事件都沿用七项判断，具体人物、空间和表现方式由 Agent 自主设计。

事件卡与项目已有时间轴共用数据，不要求每个拍点填一张，也不新增必填执行格式。使用 音乐导演编排模板 可以把构思、实现与复验记在一起。

关键转场在制作前定义出镜与入镜状态：接住哪个主体或视线落点，位置、尺度、方向和动作阶段如何延续，以及下一镜带来什么新信息。Agent 再用代码实现相机、对象、遮挡和字幕的交接，让峰值、剪切与落定分别对应选定的声音。

可编辑流程定义 · 完整方法与返修判断

中文词组与紧贴下方的英文成组参与视线交接，转场前后留出阅读时间。关键切口检查前后连续画面与真实音轨，叠图只辅助发现位置、尺度和轮廓问题。方法借鉴 Sac-Y/match-cut，适配到本库的代码动态场景与歌曲编排；不固定 BPM、镜头数量或每拍切换。

风格库提供起点，可以选择电影感影像、水墨、纸艺、绘画动画、拼贴、二维动画、三维材质或抽象动态图形，也可以为当前歌曲组合与定制。选择依据是歌曲语境、情绪、素材和镜头目的；歌词中的名词可以延伸为视觉关系，无须逐字配图。查看 歌曲视觉方向索引。

字幕在分镜阶段与画面一起设计。先尝试让词组沿场景与视线接力，再按需要选择固定阅读版式。中文可以在意象旁出现，随着镜头或动作把注意力交给下一个词组；英文紧贴对应中文下方；中文拆成词组时，优先将相应英文短语配在词组下方并一起运动。翻译不宜拆分时，英文整句紧贴完整中文语义组。句内拆分保留完整语义，逐词跟唱仍需可信词级时间，句级时间支持逐句同步及明确标注的非精确对齐编排。

选择隐喻时，画面要建立它与情绪之间的关系，并让后续事件发展这种关系。每次交接都留出可读停留；正常速度下读不完或找不到下一处，就调整分组、位置与时序。

配色可以自定义，并在实际动态背景中检查可读性。雨、水、反射、阴影等显著效果也要明确空间归属，例如玻璃水滴与墙上雨影采用不同的附着、遮挡和运动逻辑。完整规则见 字幕导演与配色 和 材质与空间。

代码里的相机参数、动画数量和静帧不能证明连续观看体验。没有实际听审就保留声音未验证状态；观众共鸣与平台留存需要真实反馈。前三秒作为开场检查窗口，不保证传播效果。

有可信歌词和时间稿时直接复用。缺少能力时，Agent 先检查已有环境、模型缓存与硬件资源，再按任务选择入口；无需把三个工具全部安装。

可编辑流程定义 · 矢量图

检测阶段不通过启动服务或加载缺失权重触发下载。发现缺项后说明所需组件与资源，按授权安装并验证；原曲保持不变。逐项检测、安装与失败处理见 音频能力指南。

知识讲解还包含概念知识科普和嘻哈知识科普两种编排。可以由旁白、音乐、歌词、过程或关系领拍，按题材选择。

这些风格沿用本库原有 ID，可以直接作为常用视频的起点，再组合下面的表达与配方。

场景决定要完成的任务，风格决定材质与视觉语言，配方安排整片内容，表达和动效处理局部。它们可以按当前主题重新组合。

配方是本库依据创作研究与实践形成的编排，包含输入、镜头步骤、表达组合、检查问题和调整方法。

表达条目由本库归纳与适配，用来说明局部手法的目的、输入、参数与检查方式。完整说明可在 表达目录 中查看。

出现 · 离场 · 强调 · 路径描绘 · 建立关系 · 数值变化 · 状态替换 · 镜头聚焦 · 遮罩切换 · 逐项呈现 · 层间视差 · 稳定停留

配方、表达和动效提供设计与实现指导，实际画面由当前工程与可用工具完成；它们可以从 目录 查询和继续扩展。

python3 scripts/stylepacks.py resolve 中国水墨
python3 scripts/stylepacks.py init brand-ink --into /project/video/styles --extends opuscar-ink-wash
python3 scripts/stylepacks.py validate --style-root /project/video/styles

flowchart LR
 A[导演与分镜] --> B[统一声画排程]
 B --> C[对象与代码绑定]
 C --> D[渲染状态与关键片段]
 D --> E{采样检查与实际审片}
 E -->|符合要求| F[成片与编辑源]
 E -->|未兑现| G[定位依赖与局部返修]
 G --> C
 classDef keep fill:#E5E7EB,stroke:#6B7280,color:#111827;
 classDef add fill:#DCFCE7,stroke:#16A34A,color:#14532D;
 classDef change fill:#FEF3C7,stroke:#D97706,color:#78350F;
 classDef fix fill:#FEE2E2,stroke:#DC2626,color:#7F1D1D;
 class A,F keep;
 class C,D add;
 class B,E change;
 class G fix;

执行合同与接入方式 提供 compile、audit、impact 工具和轻量时间采样模块。具体引擎仍由项目适配；检查记录、实际画面与听审分别验收。工作流方法参考 Eian 的六步代码视频制作实践，直接出片模式由 Agent 内部连续检查和返修。

扩展规范见 维护说明 和 风格包合同。导演与技术分层、风格规则与案例分开维护等工程方法参考了 Lemo-Opuscar，本库保留自己的交付方式、合同与工具接口。

在仓库根目录执行。查询与合同检查脚本使用 Python 3.10 或更新版本及标准库；媒体探测和部分测试还需要现有的 FFmpeg、ffprobe。无需安装 Python 第三方包。

python3 scripts/catalog.py --kind scenario list
python3 scripts/catalog.py --kind recipe get product-task-proof
python3 scripts/catalog.py --kind expression get visual.target-callout
python3 scripts/validate_plan.py examples/product-demo.plan.json
python3 -m unittest discover -s scripts -p 'test_*.py'

打开 风格画廊，用代表画面浏览全部 66 种风格，可搜索、按分类或视频任务筛选、并排对比，并复制当前风格的创作指令。59 张代表帧已嵌入 HTML，59 条样片随仓库一起分发，下载完整仓库后可直接离线播放；基础风格按实际参数呈现。需要动作与配方时进入 表达目录。也可以直接阅读 Skill 入口、计划合同 和 执行与交付。图册与计划示例用于理解和检查结构，实际作品仍需渲染、观看与试听。

“概念知识科普”配方支持一个音乐池、多首候选、一首默认。选择顺序为：用户明确指定 → 项目已选 → 配方当前默认。新增候选与更换默认分别处理；单次指定只影响当前作品。换曲后重新分析实际乐段、拍点和映射，不沿用旧曲的节奏结论。

当前 音乐目录 保留“知识分享背景音乐神曲”的元信息，作为该配方的初始默认引用；仓库不附带音源。使用默认曲目前，需将获准的同一文件关联到本机位置表，脚本会核对哈希和实际时长。也可以直接指定自己的音乐文件，无需先修改音乐池：

python3 scripts/music_library.py search --recipe knowledge-music-explainer --limit 5
python3 scripts/music_library.py select --recipe knowledge-music-explainer --source-file /project/music/chosen.wav

其他配方按各自配置与任务选曲。按 音乐导演说明 添加自己获准使用的曲目与片段，记录实际文件哈希、时长、来源和使用范围。音源位置通过项目内的 *.local.json 或 CJF_VIDEO_MUSIC_REGISTRY 关联，不提交到仓库。

python3 scripts/music_library.py validate-catalog
python3 scripts/music_library.py search --scenario product-demo --emotion curious --role establish --limit 5
python3 scripts/build_music_atlas.py

添加曲目后重新生成图册；仅导入音源位置表不会新增曲目。默认音源缺失或哈希变化时，选择工具返回具体缺口，不静默换曲。

概念知识科普编排 说明音乐地图、字幕与旁白分支、阅读窗和声音提示；可选的 声画任务表 通过 explainer_timing_audit.py 检查已声明的阅读窗与时间映射。结构检查不代替测拍、连续观看或听审。

旁白参考由使用者自行提供，按 讲解与声音参考 检查授权、降噪派生、准确读稿和实际听感。仓库附带上述 59 条风格样片；私人声音、单独的付费歌曲和模型权重由使用者自行准备。

本库把创作方法、风格资源和制作工具组织在一起。下面按实际来源说明各部分，便于选择和继续扩展。

本库原创的部分集中在方法归纳、任务编排、配置、计划规范、工具和实践案例。设计与导演方法也参考了社区项目和创作者经验，具体借鉴与独立实现的关系见 方法来源。

除完整集成的 Lemo-Opuscar 风格外，本库还从以下项目与作品研究中吸收方法，并形成自己的编排和检查规则。

这些项目提供方法启发；本库对应的归纳、合同和适配关系记在 来源说明 与条目的来源字段中。感谢创作者开放分享。

检查通过只说明对应结构或测量条件成立。画面、听感、事实与观众理解需要分别验收，未做的检查保留未验证状态。