插件安装: 在执行设置或刷新命令之前,当此技能位于 HyperFrames 插件内时,请遵循插件执行规则。独立安装请保留下面的更新说明。
HyperFrames Studio 约定
Studio 在时间线上为每个顶级元素绘制一行。遵循以下规则的项目会以简短、可读的时间线打开;不遵循规则的项目则会显示为一大片无法编辑的未标记行。这些是构建时应遵循的约定。关于如何修改剪辑,请遵循 /hyperframes-core 中的 references/creator-editing-recipes.md,切勿发明相同编辑的不同形式。
0. 先沟通,再构建
在打开文件之前阅读用户消息。判断消息要求什么:
| 用户 | 您 |
|---|---|
| 提出修改请求,无论是否礼貌(如“把标题放大一点”、“你能删掉第三个场景吗?”) | 执行修改。 |
| 对已完成的影片给出感觉上的反馈(如“开头感觉有点突兀”、“时长不够长”) | 找到原因,修改可测量的参数,说明反馈的含义和修改了什么,并根据 /hyperframes-creative 中的 references/storyboard-recipe.md § 4 记录。 |
| 提问且未指明修改(如“为什么标题会跳?”) | 回答问题。不修改任何内容。 |
| 说不要改动任何东西、暂停、只是想想、聊聊 | 不修改任何文件,即使是你注意到的错误也不改。以文字形式提供建议。 |
| 为这部影片提出一个想法但没有具体的修改(如“我希望结局更宏大”) | 提出修改建议并将其添加到计划中(见下文)。不修改任何合成文件。 |
| 要求制作一部新电影 | 进行规划(§ 5)。 |
| 批准计划(如“开始构建”、“执行”) | 按照批准的内容进行构建。 |
既提问又要求修改的消息,需要同时给出答案和修改。只有当你无法判断是否要求任何内容时,才将其视为对话:错误的答案只浪费一条消息;错误的构建则会浪费一次长时间运行和多轮反馈。
对话回复:
- 首先用简单的几句话直接回答问题。
- 只询问那些答案会改变影片的问题,并为每个问题提供推荐答案及其权衡(如“30秒适合信息流;60秒为演示留出空间”)。
- 当需要形成某个想法时:对于新电影,提供方向(参考
/hyperframes中的references/pitch-round.md);对于关于当前影片的想法,针对所指部分提供两到三个选项。推荐其中一个。 - 以下一步行动和启动词结束(如“说‘开始构建’,我就开始”)。
将计划保存在项目内而不仅仅是聊天中:下一条消息可能启动一个看不到本次会话的新会话。按照 /hyperframes-creative 中 references/storyboard-recipe.md § 4 记录轮次的方式将计划添加到 STORYBOARD.md;切勿覆盖已锁定的帧。如果用户要求你什么都不改,则不要写入任何内容:将计划放在回复中并提供保存选项。
1. 每个场景都是一个子合成
根合成仅包含时间轴宿主、媒体和音频。任何具有嵌套结构的场景(包含子元素的 div、带有副标题的标题、图表)都必须是独立的文件,使用 data-composition-src 加载,接线方式参考 /hyperframes-core 中的 references/sub-compositions.md。
留在根元素内的嵌套标记不会成为独立的一行。它会隐藏在一个无法逐段修剪或移动的不透明行内。
编写代码时,应假设有一个结构检查工具会拒绝任何违反此规则的情况。
2. 一条字幕轨道
- 所有字幕位于一条轨道上:一个标记为
data-track-kind="captions"的独立子合成宿主(一个data-track-index),按顺序承载所有字幕组。 - 切勿为每个字幕组使用一行轨道,也切勿将字幕与其他类型的元素混在同一轨道上。
- 单词时间规则不变:请参考
/embedded-captions和caption_*lint 规则。
3. 每种元素类型一条轨道
按类型分组,以便每行都是一个用户可以作为整体选择、静音或拖动的对象。
| 类型 | data-track-kind |
|---|---|
| 基础视频 / A-roll | video(来自标签) |
| 场景、覆盖层、图形 | graphics |
| 字幕 | captions |
| 音频(旁白、音乐、音效) | audio(来自标签) |
在子合成宿主上放置 data-track-kind。视频和音频类型来自标签,因此 <video> 和 <audio> 不需要额外属性。为每种类型指定独立的 data-track-index;该数字仅用于显示,不会改变元素的渲染层级。使用 CSS 控制图层叠加。
4. 安全区域
任何标尺或安全框覆盖层都应在预览窗格内,绝不在合成内部,因此不要在 HTML 中添加引导元素。
两种画面比例(宽屏和竖屏)使用相同的两个安全框,即 Premiere 的默认值。预览切换会在每个边的中点绘制一个刻度标记绘制它们。参考源:packages/studio/src/utils/previewSafeMargins.ts 中的 ACTION_SAFE_PERCENT 和 TITLE_SAFE_PERCENT。
| 框 | 占画面比例 | 每条边的内边距 |
|---|---|---|
| 动作安全 | 90% | 5% |
| 字幕安全 | 80% | 10% |
- 安全边距:所有可见内容保持在动作安全框(90%)内,字幕和关键内容保持在字幕安全框(80%)内。
- 双画面和 50/50 布局需保持每一半的内容都在字幕安全框内。
5. 新电影:规划、故事板、构建
hyperframes-launches 中的影片按以下顺序制作。每个步骤都有负责人;请遵循此顺序,无需在此重复说明。
| 步骤 | 负责文件 / 规则 |
|---|---|
| 1. 简报 | /hyperframes 中的 references/intent-interview.md。在现有项目中,仅保留同一影片的后续工作:新版本或精简版,相同工作流程和宽高比。询问其必要问题,跳过 hyperframes init,绝不覆盖 BRIEF.md 或 STORYBOARD.md,在每个文件中添加新的带日期章节,并在回复中说明。具有不同工作流程或宽高比的影片应开始一个新项目,并在回复中说明。 |
| 2. 方向 | /hyperframes 中的 references/pitch-round.md |
| 3. 故事板 | /hyperframes-creative 中的 references/storyboard-recipe.md |
| 4. 构建 | 简报所路由到的工作流程(/hyperframes § 2)及其自身的参考文件 |
| 5. 反馈 | /hyperframes 中的 references/review-loop.md |
启动影片为产品发布而增加的内容。当工作流程选择的叙事弧有不同规定时,以叙事弧为准。
- 使用已发布产品的真实录像。 在简报中要求提供屏幕录制,除非工作流程本身能捕获(如通过 URL 捕获网站),并在收到之前用一个带标签的占位符保留其插槽。切勿近似模拟已发布产品的用户界面。作为上下文展示的第三方工具(如聊天应用、编辑器)应从捕获素材中忠实地重建。
- 维持同一世界。 同一窗口或画布应跨越多个节拍连贯地继续。仔细检查每一个剪辑点:任何持续的元素都不能跳跃。
- 光标和滚动内容。 光标或窗口本身滚出的内容,应从窗口或框架边缘移出,而不是在画面中间淡出。元素和文本的替换应遵循工作流程中的
cut-catalog.md(如果存在)。 - 以命令或地址特写结束, 标志落在仍在运动的画面中。
- 在每次版本迭代中声明运行时长。 运行超出目标时长是用户的决定,而不是你的。
检查你的工作
运行 hyperframes check(它会运行 lint 检查)并修复所有发现的问题。然后,在 Studio 中打开项目,检查时间线是否显示了一行基础行、每个场景宿主一行、一行字幕行以及音频行。