HyperFrames 无脸解说视频叙事设计指南从文本中提取教学主线产出 STORYBOARD 与 SCRIPT【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes本文是 HyperFrames 仓库中faceless-explainer技能体系的核心叙事参考story-design.md的深度展开。它服务于无脸解说视频faceless explainer工作流的 Step 3把一篇纯文本文章、笔记、主题或 brief转化为逐帧教学计划STORYBOARD.md和锁定的旁白脚本SCRIPT.md。读完本文你将掌握四类解说结构的选型方法、九种开场钩子策略、可命名的修辞技巧目录、情感节拍曲线、跨帧连续性与转场纪律以及VO_MODE与完全静默标记的正确用法并能直接套用文末的帧模板与最终检查清单投入实战。文档定位Step 3 的故事层参考不负责视觉story-design.md是 faceless-explainer 工作流 Step 3Storyboard and Script必须阅读的输入之一。它的职责边界非常清晰它定义故事视频教什么、按什么顺序教、为什么每一帧存在它不定义布局、视觉特效、动画或最终的 markdown schema——这些分别由视觉设计与动画层负责帧文件的精确语法必须遵循 storyboard-format.md 和 script-format.md与有脸的产品发布视频product-launch-video不同无脸解说视频没有网站可抓取、没有真实素材清单所有视觉都在下游Step 4-5由每个帧的叙事意图凭空发明排版、抽象图形、图表、数据可视化。在 SKILL.md 的完整工作流中Step 3 位于设计系统Step 2产出frame.md之后、音频生成Step 3.1之前是一个用户把关门禁草拟完成后以提案形式呈现给用户审批。也就是说本文档产出的分镜本身就是待审提案而非终稿。写作前的四类输入开始写故事之前必须依次读取以下输入输入作用hyperframes.json锁定的 brief角度angle、时长length、画幅aspect ratio、语言language其字段结构可参考 docs/schema/hyperframes.jsonframe.md语气tone、情绪mood、设计系统design system与语域registercapture/extracted/visible-text.txt文章 / 笔记 / 主题 / brief 的全文是信息的来源注意Step 1 由人工合成该抓取包因为无脸流程不运行npx hyperframes captureuser_script.txt与VO_MODE仅当用户粘贴了脚本时存在VO_MODE决定旁白是逐字保留还是重构需要特别强调无脸流程中不存在asset-descriptions.md也没有capture/assets/可检查。每一个视觉都在下游步骤被发明你的职责是叙事而不是视觉素材清单。核心规则文章是信息倾倒视频是被引导的理解行为这是整个文档的第一原则也是新手最常见的失败模式不要按段落顺序改写原文。要对源文本做重排reorder、合并merge、删减omit、压缩compress整理成一条清晰的教学序列。剥离插叙asides暴露主干spine。最常见的单一失败就是按顺序复述文章——绝不要这样做。输入文本是信息的来源不是故事的模板。从源码印证看这一原则在 SKILL.md 的 Step 3 描述中被原样强调The videos sequence comes fromnarrative design, not the input texts paragraph order。同时 story-spine.md 的反转冰山原则也与此呼应价值主张要在第二拍落地其余一切机制、示例、数据都是为该主张服务的证据。Step 3 方法四步产出教学分镜1. 提取教学真相Teaching Truth从 brief 与文本中识别六个要素Audience受众——视频在对谁说话他们已知什么、未知什么Gap or stakes缺口或利害——这段讲解要解决的困惑、疑问或为什么要在乎Thesis论点——观众离开时应带走的一句话Spine主干——支撑论点的 3-6 个想法机制/步骤/条目/节拍Evidence证据——落地它的具体数字、例子、对比或演算案例Landing落点——可带走的结论或引导观众去思考/尝试/行动的召唤。分镜围绕论点thesis来写而不是围绕文章的章节来写。2. 让语气与frame.md匹配frame.md是软性指导——视觉系统调整的是声音voice不是结构structureframe.md信号故事效果warm, handmade, notes-likeplain, considered, low-hype; humane平实、审慎、低炒作、人性化bold, poster-like, declarativeshort punchy beats, confident claims短促有力的节拍、自信的主张friendly, polished, modernapproachable direct address, lighter平易近人的直接对白、更轻快literary, technical-but-humanthoughtful, precise; safe for code/dev深思熟虑、精准对代码/开发者友好一句话概括教学真相决定弧线视觉系统决定声音。3. 选择一种解说结构每次只能选一种结构或明确命名复合结构不要拼接不同结构的阶段——每种结构都是一条完整通往理解的路结构一句话定义内容负载适合…主体形态concept-explainerX 是什么以及它为什么重要受众半懂的一个想法/术语/现象命名概念 → 逐层揭示机制 → 落地其含义how-to-process这是怎么做 / X 如何运作有序步骤有清晰起点→终点的程序或机制在一致视觉舞台上的 3-6 步序列每步一个动作listicle关于 X 的 N 件事一组平行的、同级条目技巧、错误、理由钩子 → N 个大致同级的条目 → 收尾三法则rule-of-three最强story-explainer通过叙事弧线来教学案例研究、历史、警示故事铺垫 → 张力 → 转折 → 解决 → 教训教训须可泛化选型判据一个想法要理解 → concept有序流程 → how-to平行同级条目 → listicle具体叙事/案例 → story。复合结构compounds用外层弧线叠加内层节奏——例如concept-explainer with process机制阶段内部含有序步骤、story-explainer with how-to。在 frontmatter 中把arc设为所选结构或outer with inner。下游视觉阶段会读取它来控制节奏进程式内层节奏意味着在一致舞台上更紧凑的接缝和更短的帧。4. 构建帧序列每一帧只有一个明确的职责job。避免只表达更多细节或另一个点的帧。每个帧需要定义以下字段使用 storyboard 格式的字段并加入下方叙事补充type——hook | pain_point | product_intro | feature_showcase | benefit_highlight | social_proof | branding | cta之一。这个枚举与下游视觉层共享用于节奏控制按下表复用为教学角色persuasion——一个有名有姓的修辞/清晰化技巧见技巧目录而不是解释这个想法beat——目标情绪见情感词汇scene——一行视觉想法不是详细构图voiceover——口头引导文本静默帧留空transition_in——注册表转场名见转场一节blueprint可选候选——查阅 blueprints-index.md 中的角色→蓝图菜单当有已验证的形态适配该节拍时标注其 id这只是标签而非承诺Step 4 会确认或覆盖。随后按该蓝图暗示的形态写voiceover让这句话在 Step 4 运行前就可揭示。教学真相仍然决定哪些节拍存在——绝不为了凑蓝图而发明、删减或扭曲节拍没有适配时省略blueprint直接平实写句。在每帧的 prose 中还需写明narrativeRole——该场景在讲解中的职责例如把复利具体化为一个雪球而不是展示一张图表keyMessage——观众看完这一帧后应理解的一件事一句话。type 枚举的重映射共享枚举 → 解说角色共享枚举的取值与解说角色一一对应让下游节奏匹配帧的职责你想要的解说角色使用的type为什么用这个值钩子 / 好奇心缺口hook高杠杆的开场 3-5 秒痛点 / 问题 / 为何在意pain_point讲解要消除的摩擦或缺口命名核心概念product_intro引入主角——这里的主角是想法机制 / 步骤 / 条目feature_showcase主体中的一个单元——流程的一步、一个机制、一个条目含义 / 回报 / so whatbenefit_highlight理解带来的后果或价值证据 / 示例 / 数据点social_proof具体的落地数字、演算示例、对比论点 / takeaways / 原则branding哲学落点——可泛化的想法、那一句话引导思考 / 尝试 / 行动cta收尾的请求——去试、去观察、去质疑主体通常是一串feature_showcase步骤/机制/条目穿插benefit_highlight含义与social_proof示例/数据。至少应存在一个feature_showcase或product_intro——每个解说都有主体和一个被命名的想法。开场钩子策略前 3-5 秒打开认知缺口为开场选择一个策略。对解说类视频钩子的任务是打开认知缺口或利害关系策略适用场景示例震撼数据Shocking statistic一个可信数字能量化利害人类造出的塑料有 90% 从未被回收。反问Rhetorical question制造即时的认知缺口为什么随着年龄增长时间似乎越来越快反直觉主张Counterintuitive claim真相与常识相悖给高速公路加更多车道反而会让堵车更严重。痛点验证Pain validation受众已经感到困惑人人都说分散投资就行——没人说那是什么意思。具象隐喻Visceral metaphor想法太抽象需要变具体你的注意力是一盏聚光灯而应用们在争夺开关。概念宣告Concept announcement术语本身就是主题要让它难忘有个词形容这个旁观者效应。直接对话Direct address受众画像明确如果你曾做到一半摔了菜谱——这就是为你做的。想象 / 情景Imagine / scenario思想实验框定全片想象一种钱不花掉就会贬值。利害 / 后果Stakes / consequence为何现在在意是真实的成本或风险这一步做错整炉就毁了。钩子必须制造好奇心、张力或利害。不要用一句笼统定义开场。依据 story-spine.md钩子说的是观众的语言理解的回报绝不是源文本的小节标题而论点message要在第 2 拍落地——之后的讲解都是它的证据。清晰度 / 修辞技巧目录persuasion必须是命名技术persuasion是一个命名技术——这一帧如何让想法落地或变清晰——而不是模糊的意图。多个技术同时生效时可以组合如Analogy progressive disclosure家族技巧具象化Make-concrete类比/隐喻 · 具体化抽象 → 可触对象· 带真实数字的演算示例 · 锚定在熟悉的参照物上按序揭示Reveal-in-order渐进披露一次一个术语/层· 构建简单 → 一般情形· 路标化首先…然后…最后对比Contrast前后对比 · 常识 vs 现实 · 两选项比较 · 反例这里它会失效结构Structure三法则 · 编号枚举 · 问答配对 · 先框后填先说出形状再填充内容证据Evidence统计证明 · 引用/来源 · 演示展示机制在运行· 因果链A → B → C记忆与落点Memory landing回调回到钩子的意象· 蒸馏压缩成一句话· 造词/助记 · 泛化具体 → 原则当目录里没有合适技巧时就现场命名一个新技巧并解释其机制例如减法框定先用它不是来定义这个概念。永远不要写泛泛的解释这个想法。情感节拍跟随一条理解弧线beat是一个词或短复合短语如 Curiosity and clarity。避免泛泛的 positive / interested。解说类视频沿一条理解弧线推进负面低谷Negative valley——打开缺口hook / pain_pointcuriosity好奇· puzzlement困惑· surprise惊讶· tension张力· concern关切· skepticism怀疑· recognition认同· intrigue入迷转折Pivot——定向product_intro / 概念命名clarity清晰· orientation定向· anticipation期待· focus聚焦构建Build——构建理解feature_showcase / benefit_highlight / social_proofcomprehension理解· aha顿悟· confidence自信· fascination着迷· foresight预见· momentum动量· conviction笃定· delight愉悦· unease警示性不安· mastery掌控解决Resolution——落点branding / cta / 结尾clarity清晰· satisfaction满足· resolve决心· inspiration启发· inevitability必然感· now I get it我懂了复合节拍往往最强例如 Surprise recognition、Comprehension delight。主体是一段序列不是单个帧解说的核心几乎总是在同一视觉舞台上的 3-6 个主体帧每帧推进一个机制/步骤/条目/层次理解累积式上升。一个孤立的主体帧几乎教不会任何东西。concept-explainer命名概念product_intro→ 逐层揭示机制一串feature_showcase穿插benefit_highlight讲so whatsocial_proof给落地示例how-to-process每步一个feature_showcase按序排列在同一舞台。让被操作对象在相邻步骤间延续携带见连续性一节listicle每个条目一个feature_showcase条目彼此平行因此条目间默认用cut/push-slidestory-explainer帧跟随节拍铺垫/张力/转折/解决/教训类型按上表映射张力用pain_point教训用branding。跨帧连续性无 worker 分组该框架是一帧一个 worker——不存在把多帧交给同一 worker 的continue run。一段连续镜头依靠两个故事板层面的杠杆都归你掌控读出一镜到底的效果一致的舞台consistent stage——连续主体帧共享同一构图想法同一个生长的图表、同一条数轴、同一张书桌在每个帧的scene中写明让 Step 4 与各 worker 保持舞台稳定一致的转场consistent transition——为一段序列选一种接缝类型有序步骤通常用push-slide DIR软性图层揭示用crossfade并在整段中重复让这些帧读起来像一段流动而不是独立幻灯片。当单个元素真的要在两个想法之间变换图表节点变成柱条、公式变成它的结果时把它保留在一个帧内作为发展节拍入场 → 变换 → 稳定而不是跨接缝拆开——该动作归 worker 所有。在帧的scene/ 叙事中注明意图Step 4 会把它变成带时间码的镜头序列实例化候选blueprint。转场只用注册表名称全片重复 2-3 种transition_in只允许使用注册表转场名cut | crossfade | blur-crossfade | push-slide LEFT | push-slide RIGHT | push-slide UP | push-slide DOWN | zoom-through | squeeze这些名称在仓库中有可验证的实现依据skills/faceless-explainer/scripts/lib/transitions.json收录了经过策展的 Tier-B 子集每个转场都带 GSAP 模板crossfade是双端透明度、blur-crossfade用 10px 模糊掩盖背景色冲突、push-slide按方向注入水平或垂直位移、zoom-through用 2.5x/0.5x 缩放加模糊、squeeze是左缘压扁 右缘展开并设定了max_duration_s: 2.0的上限。注入逻辑由scripts/transitions.mjs实现在 Step 6 把模板盖印到window.__timelines[main]上。选用纪律全片只挑2-3 种转场并重复使用第 1 帧用cut作占位它没有前一帧接缝匹配叙事有序步骤 → 一致的push-slide软性图层揭示或氛围转变 →crossfade/blur-crossfade推近细节或拉远 →zoom-through干净的话题切换或新列表条目 →cut。无脸视觉没有资产清单每一个视觉都在下游根据帧的narrativeRole/keyMessage/scene被发明——排版、抽象图形、图表、数据可视化都是头等公民。因此不要写asset_candidates行来把意图中的图表或排版描述成文件。视觉意图属于scenenarrativeRole视觉阶段读取的是它们唯一的真实资产是用户提供、已放置在public/basename的图片。此时加一行asset_candidates: public/basename — ≤25 词它是什么。绝不虚构路径绝不引用capture/。脚本规则没有粘贴脚本时为每个有声帧写紧凑旁白每帧 1-2 句通常 6-20 词具体、有人味是教学不是把文章朗读出来把每一行写成离散的提示cues而不是一口气的连读长句。Step 5 会在旁白点名每个屏幕上元素时逐一揭示它这是反 PowerPoint 机制。一句有清晰短语边界的话——先是雪球——然后是山坡——然后是速度——免费地把揭示节奏交给了镜头而一个冗长从句会让帧失去可供节奏化的东西强具象化Compound interest isnt addition, its a snowball — every turn picks up the snow from the last, then more.弱文章复述The study, published in 2019, examined three cohorts and found that…——这是朗读不是讲解。避免Unlock the power of…、Seamless experience、冗长的名词短语列表、只做填充桥接的帧Or…。静默帧是允许的且在解说中很常见——图表自行组装、演算示例动起来、转折前的一拍屏息。把voiceover留空并从SCRIPT.md中排除该帧此时narrativeRolepersuasion必须承载脚本没有说出的内容。当VO_MODE restructure把user_script.txt当作源材料。可以重写、重排、合并或删减以适配所选结构与目标时长。当VO_MODE verbatim不要改写用户的措辞。在句号或段落边界把脚本切成帧大小的块可以在自然的从句边界拆分长句但不得改动用词。最终时长以提供的脚本为准。音乐与静默分镜顶层 YAML 块携带music:字段——音频步骤据此检索的 BGM 情绪例如music: confident minimal tech underscore。省略时按message:→arc:→ 中性默认值回退因此除非显式关闭BGM 总会播放。music: none——关闭 BGM旁白如果有仍会运行music: none 没有SCRIPT.md——规范化的完全静默标记无旁白、无 BGM、无 SFX。audio.mjs不生成任何东西音频步骤是一次干净的跳过。用户要求静默/无音乐视频时请精确使用这个拼写。这一约定在仓库源码中有直接实现依据skills/faceless-explainer/scripts/audio.mjs的runGenerate读取分镜顶层 YAML 的music字段当它等于none且脚本行数为 0 时直接删除陈旧输出并打印 project marked silent — nothing to generateaudio.mjsBGM 查询词的回退链同样是music→message→arc→ 默认calm cinematic underscoreaudio.mjs。配套地assemble-index.mjs把缺失audio_meta.json视为静默信号并用bgm_pending标志区分还在生成的 bed与设计上就是静默防止把半成品组装成无声片--allow-pending-bgm仅用于显式预览。帧模板使用核心 storyboard 格式要求的精确字段。这是每帧应满足的叙事形状## Frame N — Short name - scene: one clear visual idea - voiceover: spoken guide text, or empty - duration: rough estimate in seconds - transition_in: crossfade - status: outline - src: compositions/frames/NN-short-name.html - type: feature_showcase - persuasion: Progressive disclosure - beat: comprehension - blueprint: dataviz-countup — candidate shape from the role→blueprint menu; omit when none fits narrativeRole: What this frame does in the viewers understanding. keyMessage: The one idea the viewer should remember.其中statusoutline→built→animated、src、transition_in等基础字段的完整语义定义在 storyboard-format.md该文件还说明分镜会被hyperframes/core/storyboard解析为宽松的StoryboardManifest未知键原样保留到extra并在 Studio 中以 contact sheet 形式渲染。SCRIPT.md的头部结构**Voice:**/**Voice settings:**/**Voice direction:**、每行分区## Line N — label (Frame N)与缩进正文约定则定义在 script-format.md——缩进块是唯一喂给 TTS 的部分。最终检查清单在请求用户审批前逐项核验结构已命名一种解说结构复合仅当显式命名序列是叙事驱动的不是段落顺序驱动的钩子开场使用了命名钩子策略主体每帧只有一个职责主体累积式构建一串feature_showcase/benefit_highlight/product_intro而不是单个孤立主体帧字段每帧都有type、persuasion目录中的命名技巧和beat具体不泛泛旁白每个voiceover都按短语切分成提示Step 5 可逐一揭示不是一气呵成的长从句凡有已验证形状适配处都标注候选blueprint:无适配处则省略情绪情绪弧线有符合结构的有意义起伏转场只使用注册表名称且重复 2-3 种第 1 帧为cut连续性一致舞台 一致转场承载任何多帧序列真正的元素变换保留在单帧内资产asset_candidates缺省无脸除非存在真实的用户提供public/basename脚本SCRIPT.md只包含锁定的口头旁白静默帧是刻意的且从中排除。这份清单同时也是对 SKILL.md Step 3 门禁STORYBOARD.md存在、每帧具备必要叙事字段、有旁白时SCRIPT.md存在、用户已批准逐帧计划的支撑材料。通过检查后分镜进入 Step 3.1 音频与 Step 4 视觉设计阶段而你在 Step 3 写下的每一句按蓝图形态书写的 voiceover、每一个被命名的persuasion与beat都将成为下游 worker 精确还原叙事的坐标。【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
HyperFrames 无脸解说视频叙事设计指南从文本中提取教学主线产出 STORYBOARD 与 SCRIPT【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes本文是 HyperFrames 仓库中faceless-explainer技能体系的核心叙事参考story-design.md的深度展开。它服务于无脸解说视频faceless explainer工作流的 Step 3把一篇纯文本文章、笔记、主题或 brief转化为逐帧教学计划STORYBOARD.md和锁定的旁白脚本SCRIPT.md。读完本文你将掌握四类解说结构的选型方法、九种开场钩子策略、可命名的修辞技巧目录、情感节拍曲线、跨帧连续性与转场纪律以及VO_MODE与完全静默标记的正确用法并能直接套用文末的帧模板与最终检查清单投入实战。文档定位Step 3 的故事层参考不负责视觉story-design.md是 faceless-explainer 工作流 Step 3Storyboard and Script必须阅读的输入之一。它的职责边界非常清晰它定义故事视频教什么、按什么顺序教、为什么每一帧存在它不定义布局、视觉特效、动画或最终的 markdown schema——这些分别由视觉设计与动画层负责帧文件的精确语法必须遵循 storyboard-format.md 和 script-format.md与有脸的产品发布视频product-launch-video不同无脸解说视频没有网站可抓取、没有真实素材清单所有视觉都在下游Step 4-5由每个帧的叙事意图凭空发明排版、抽象图形、图表、数据可视化。在 SKILL.md 的完整工作流中Step 3 位于设计系统Step 2产出frame.md之后、音频生成Step 3.1之前是一个用户把关门禁草拟完成后以提案形式呈现给用户审批。也就是说本文档产出的分镜本身就是待审提案而非终稿。写作前的四类输入开始写故事之前必须依次读取以下输入输入作用hyperframes.json锁定的 brief角度angle、时长length、画幅aspect ratio、语言language其字段结构可参考 docs/schema/hyperframes.jsonframe.md语气tone、情绪mood、设计系统design system与语域registercapture/extracted/visible-text.txt文章 / 笔记 / 主题 / brief 的全文是信息的来源注意Step 1 由人工合成该抓取包因为无脸流程不运行npx hyperframes captureuser_script.txt与VO_MODE仅当用户粘贴了脚本时存在VO_MODE决定旁白是逐字保留还是重构需要特别强调无脸流程中不存在asset-descriptions.md也没有capture/assets/可检查。每一个视觉都在下游步骤被发明你的职责是叙事而不是视觉素材清单。核心规则文章是信息倾倒视频是被引导的理解行为这是整个文档的第一原则也是新手最常见的失败模式不要按段落顺序改写原文。要对源文本做重排reorder、合并merge、删减omit、压缩compress整理成一条清晰的教学序列。剥离插叙asides暴露主干spine。最常见的单一失败就是按顺序复述文章——绝不要这样做。输入文本是信息的来源不是故事的模板。从源码印证看这一原则在 SKILL.md 的 Step 3 描述中被原样强调The videos sequence comes fromnarrative design, not the input texts paragraph order。同时 story-spine.md 的反转冰山原则也与此呼应价值主张要在第二拍落地其余一切机制、示例、数据都是为该主张服务的证据。Step 3 方法四步产出教学分镜1. 提取教学真相Teaching Truth从 brief 与文本中识别六个要素Audience受众——视频在对谁说话他们已知什么、未知什么Gap or stakes缺口或利害——这段讲解要解决的困惑、疑问或为什么要在乎Thesis论点——观众离开时应带走的一句话Spine主干——支撑论点的 3-6 个想法机制/步骤/条目/节拍Evidence证据——落地它的具体数字、例子、对比或演算案例Landing落点——可带走的结论或引导观众去思考/尝试/行动的召唤。分镜围绕论点thesis来写而不是围绕文章的章节来写。2. 让语气与frame.md匹配frame.md是软性指导——视觉系统调整的是声音voice不是结构structureframe.md信号故事效果warm, handmade, notes-likeplain, considered, low-hype; humane平实、审慎、低炒作、人性化bold, poster-like, declarativeshort punchy beats, confident claims短促有力的节拍、自信的主张friendly, polished, modernapproachable direct address, lighter平易近人的直接对白、更轻快literary, technical-but-humanthoughtful, precise; safe for code/dev深思熟虑、精准对代码/开发者友好一句话概括教学真相决定弧线视觉系统决定声音。3. 选择一种解说结构每次只能选一种结构或明确命名复合结构不要拼接不同结构的阶段——每种结构都是一条完整通往理解的路结构一句话定义内容负载适合…主体形态concept-explainerX 是什么以及它为什么重要受众半懂的一个想法/术语/现象命名概念 → 逐层揭示机制 → 落地其含义how-to-process这是怎么做 / X 如何运作有序步骤有清晰起点→终点的程序或机制在一致视觉舞台上的 3-6 步序列每步一个动作listicle关于 X 的 N 件事一组平行的、同级条目技巧、错误、理由钩子 → N 个大致同级的条目 → 收尾三法则rule-of-three最强story-explainer通过叙事弧线来教学案例研究、历史、警示故事铺垫 → 张力 → 转折 → 解决 → 教训教训须可泛化选型判据一个想法要理解 → concept有序流程 → how-to平行同级条目 → listicle具体叙事/案例 → story。复合结构compounds用外层弧线叠加内层节奏——例如concept-explainer with process机制阶段内部含有序步骤、story-explainer with how-to。在 frontmatter 中把arc设为所选结构或outer with inner。下游视觉阶段会读取它来控制节奏进程式内层节奏意味着在一致舞台上更紧凑的接缝和更短的帧。4. 构建帧序列每一帧只有一个明确的职责job。避免只表达更多细节或另一个点的帧。每个帧需要定义以下字段使用 storyboard 格式的字段并加入下方叙事补充type——hook | pain_point | product_intro | feature_showcase | benefit_highlight | social_proof | branding | cta之一。这个枚举与下游视觉层共享用于节奏控制按下表复用为教学角色persuasion——一个有名有姓的修辞/清晰化技巧见技巧目录而不是解释这个想法beat——目标情绪见情感词汇scene——一行视觉想法不是详细构图voiceover——口头引导文本静默帧留空transition_in——注册表转场名见转场一节blueprint可选候选——查阅 blueprints-index.md 中的角色→蓝图菜单当有已验证的形态适配该节拍时标注其 id这只是标签而非承诺Step 4 会确认或覆盖。随后按该蓝图暗示的形态写voiceover让这句话在 Step 4 运行前就可揭示。教学真相仍然决定哪些节拍存在——绝不为了凑蓝图而发明、删减或扭曲节拍没有适配时省略blueprint直接平实写句。在每帧的 prose 中还需写明narrativeRole——该场景在讲解中的职责例如把复利具体化为一个雪球而不是展示一张图表keyMessage——观众看完这一帧后应理解的一件事一句话。type 枚举的重映射共享枚举 → 解说角色共享枚举的取值与解说角色一一对应让下游节奏匹配帧的职责你想要的解说角色使用的type为什么用这个值钩子 / 好奇心缺口hook高杠杆的开场 3-5 秒痛点 / 问题 / 为何在意pain_point讲解要消除的摩擦或缺口命名核心概念product_intro引入主角——这里的主角是想法机制 / 步骤 / 条目feature_showcase主体中的一个单元——流程的一步、一个机制、一个条目含义 / 回报 / so whatbenefit_highlight理解带来的后果或价值证据 / 示例 / 数据点social_proof具体的落地数字、演算示例、对比论点 / takeaways / 原则branding哲学落点——可泛化的想法、那一句话引导思考 / 尝试 / 行动cta收尾的请求——去试、去观察、去质疑主体通常是一串feature_showcase步骤/机制/条目穿插benefit_highlight含义与social_proof示例/数据。至少应存在一个feature_showcase或product_intro——每个解说都有主体和一个被命名的想法。开场钩子策略前 3-5 秒打开认知缺口为开场选择一个策略。对解说类视频钩子的任务是打开认知缺口或利害关系策略适用场景示例震撼数据Shocking statistic一个可信数字能量化利害人类造出的塑料有 90% 从未被回收。反问Rhetorical question制造即时的认知缺口为什么随着年龄增长时间似乎越来越快反直觉主张Counterintuitive claim真相与常识相悖给高速公路加更多车道反而会让堵车更严重。痛点验证Pain validation受众已经感到困惑人人都说分散投资就行——没人说那是什么意思。具象隐喻Visceral metaphor想法太抽象需要变具体你的注意力是一盏聚光灯而应用们在争夺开关。概念宣告Concept announcement术语本身就是主题要让它难忘有个词形容这个旁观者效应。直接对话Direct address受众画像明确如果你曾做到一半摔了菜谱——这就是为你做的。想象 / 情景Imagine / scenario思想实验框定全片想象一种钱不花掉就会贬值。利害 / 后果Stakes / consequence为何现在在意是真实的成本或风险这一步做错整炉就毁了。钩子必须制造好奇心、张力或利害。不要用一句笼统定义开场。依据 story-spine.md钩子说的是观众的语言理解的回报绝不是源文本的小节标题而论点message要在第 2 拍落地——之后的讲解都是它的证据。清晰度 / 修辞技巧目录persuasion必须是命名技术persuasion是一个命名技术——这一帧如何让想法落地或变清晰——而不是模糊的意图。多个技术同时生效时可以组合如Analogy progressive disclosure家族技巧具象化Make-concrete类比/隐喻 · 具体化抽象 → 可触对象· 带真实数字的演算示例 · 锚定在熟悉的参照物上按序揭示Reveal-in-order渐进披露一次一个术语/层· 构建简单 → 一般情形· 路标化首先…然后…最后对比Contrast前后对比 · 常识 vs 现实 · 两选项比较 · 反例这里它会失效结构Structure三法则 · 编号枚举 · 问答配对 · 先框后填先说出形状再填充内容证据Evidence统计证明 · 引用/来源 · 演示展示机制在运行· 因果链A → B → C记忆与落点Memory landing回调回到钩子的意象· 蒸馏压缩成一句话· 造词/助记 · 泛化具体 → 原则当目录里没有合适技巧时就现场命名一个新技巧并解释其机制例如减法框定先用它不是来定义这个概念。永远不要写泛泛的解释这个想法。情感节拍跟随一条理解弧线beat是一个词或短复合短语如 Curiosity and clarity。避免泛泛的 positive / interested。解说类视频沿一条理解弧线推进负面低谷Negative valley——打开缺口hook / pain_pointcuriosity好奇· puzzlement困惑· surprise惊讶· tension张力· concern关切· skepticism怀疑· recognition认同· intrigue入迷转折Pivot——定向product_intro / 概念命名clarity清晰· orientation定向· anticipation期待· focus聚焦构建Build——构建理解feature_showcase / benefit_highlight / social_proofcomprehension理解· aha顿悟· confidence自信· fascination着迷· foresight预见· momentum动量· conviction笃定· delight愉悦· unease警示性不安· mastery掌控解决Resolution——落点branding / cta / 结尾clarity清晰· satisfaction满足· resolve决心· inspiration启发· inevitability必然感· now I get it我懂了复合节拍往往最强例如 Surprise recognition、Comprehension delight。主体是一段序列不是单个帧解说的核心几乎总是在同一视觉舞台上的 3-6 个主体帧每帧推进一个机制/步骤/条目/层次理解累积式上升。一个孤立的主体帧几乎教不会任何东西。concept-explainer命名概念product_intro→ 逐层揭示机制一串feature_showcase穿插benefit_highlight讲so whatsocial_proof给落地示例how-to-process每步一个feature_showcase按序排列在同一舞台。让被操作对象在相邻步骤间延续携带见连续性一节listicle每个条目一个feature_showcase条目彼此平行因此条目间默认用cut/push-slidestory-explainer帧跟随节拍铺垫/张力/转折/解决/教训类型按上表映射张力用pain_point教训用branding。跨帧连续性无 worker 分组该框架是一帧一个 worker——不存在把多帧交给同一 worker 的continue run。一段连续镜头依靠两个故事板层面的杠杆都归你掌控读出一镜到底的效果一致的舞台consistent stage——连续主体帧共享同一构图想法同一个生长的图表、同一条数轴、同一张书桌在每个帧的scene中写明让 Step 4 与各 worker 保持舞台稳定一致的转场consistent transition——为一段序列选一种接缝类型有序步骤通常用push-slide DIR软性图层揭示用crossfade并在整段中重复让这些帧读起来像一段流动而不是独立幻灯片。当单个元素真的要在两个想法之间变换图表节点变成柱条、公式变成它的结果时把它保留在一个帧内作为发展节拍入场 → 变换 → 稳定而不是跨接缝拆开——该动作归 worker 所有。在帧的scene/ 叙事中注明意图Step 4 会把它变成带时间码的镜头序列实例化候选blueprint。转场只用注册表名称全片重复 2-3 种transition_in只允许使用注册表转场名cut | crossfade | blur-crossfade | push-slide LEFT | push-slide RIGHT | push-slide UP | push-slide DOWN | zoom-through | squeeze这些名称在仓库中有可验证的实现依据skills/faceless-explainer/scripts/lib/transitions.json收录了经过策展的 Tier-B 子集每个转场都带 GSAP 模板crossfade是双端透明度、blur-crossfade用 10px 模糊掩盖背景色冲突、push-slide按方向注入水平或垂直位移、zoom-through用 2.5x/0.5x 缩放加模糊、squeeze是左缘压扁 右缘展开并设定了max_duration_s: 2.0的上限。注入逻辑由scripts/transitions.mjs实现在 Step 6 把模板盖印到window.__timelines[main]上。选用纪律全片只挑2-3 种转场并重复使用第 1 帧用cut作占位它没有前一帧接缝匹配叙事有序步骤 → 一致的push-slide软性图层揭示或氛围转变 →crossfade/blur-crossfade推近细节或拉远 →zoom-through干净的话题切换或新列表条目 →cut。无脸视觉没有资产清单每一个视觉都在下游根据帧的narrativeRole/keyMessage/scene被发明——排版、抽象图形、图表、数据可视化都是头等公民。因此不要写asset_candidates行来把意图中的图表或排版描述成文件。视觉意图属于scenenarrativeRole视觉阶段读取的是它们唯一的真实资产是用户提供、已放置在public/basename的图片。此时加一行asset_candidates: public/basename — ≤25 词它是什么。绝不虚构路径绝不引用capture/。脚本规则没有粘贴脚本时为每个有声帧写紧凑旁白每帧 1-2 句通常 6-20 词具体、有人味是教学不是把文章朗读出来把每一行写成离散的提示cues而不是一口气的连读长句。Step 5 会在旁白点名每个屏幕上元素时逐一揭示它这是反 PowerPoint 机制。一句有清晰短语边界的话——先是雪球——然后是山坡——然后是速度——免费地把揭示节奏交给了镜头而一个冗长从句会让帧失去可供节奏化的东西强具象化Compound interest isnt addition, its a snowball — every turn picks up the snow from the last, then more.弱文章复述The study, published in 2019, examined three cohorts and found that…——这是朗读不是讲解。避免Unlock the power of…、Seamless experience、冗长的名词短语列表、只做填充桥接的帧Or…。静默帧是允许的且在解说中很常见——图表自行组装、演算示例动起来、转折前的一拍屏息。把voiceover留空并从SCRIPT.md中排除该帧此时narrativeRolepersuasion必须承载脚本没有说出的内容。当VO_MODE restructure把user_script.txt当作源材料。可以重写、重排、合并或删减以适配所选结构与目标时长。当VO_MODE verbatim不要改写用户的措辞。在句号或段落边界把脚本切成帧大小的块可以在自然的从句边界拆分长句但不得改动用词。最终时长以提供的脚本为准。音乐与静默分镜顶层 YAML 块携带music:字段——音频步骤据此检索的 BGM 情绪例如music: confident minimal tech underscore。省略时按message:→arc:→ 中性默认值回退因此除非显式关闭BGM 总会播放。music: none——关闭 BGM旁白如果有仍会运行music: none 没有SCRIPT.md——规范化的完全静默标记无旁白、无 BGM、无 SFX。audio.mjs不生成任何东西音频步骤是一次干净的跳过。用户要求静默/无音乐视频时请精确使用这个拼写。这一约定在仓库源码中有直接实现依据skills/faceless-explainer/scripts/audio.mjs的runGenerate读取分镜顶层 YAML 的music字段当它等于none且脚本行数为 0 时直接删除陈旧输出并打印 project marked silent — nothing to generateaudio.mjsBGM 查询词的回退链同样是music→message→arc→ 默认calm cinematic underscoreaudio.mjs。配套地assemble-index.mjs把缺失audio_meta.json视为静默信号并用bgm_pending标志区分还在生成的 bed与设计上就是静默防止把半成品组装成无声片--allow-pending-bgm仅用于显式预览。帧模板使用核心 storyboard 格式要求的精确字段。这是每帧应满足的叙事形状## Frame N — Short name - scene: one clear visual idea - voiceover: spoken guide text, or empty - duration: rough estimate in seconds - transition_in: crossfade - status: outline - src: compositions/frames/NN-short-name.html - type: feature_showcase - persuasion: Progressive disclosure - beat: comprehension - blueprint: dataviz-countup — candidate shape from the role→blueprint menu; omit when none fits narrativeRole: What this frame does in the viewers understanding. keyMessage: The one idea the viewer should remember.其中statusoutline→built→animated、src、transition_in等基础字段的完整语义定义在 storyboard-format.md该文件还说明分镜会被hyperframes/core/storyboard解析为宽松的StoryboardManifest未知键原样保留到extra并在 Studio 中以 contact sheet 形式渲染。SCRIPT.md的头部结构**Voice:**/**Voice settings:**/**Voice direction:**、每行分区## Line N — label (Frame N)与缩进正文约定则定义在 script-format.md——缩进块是唯一喂给 TTS 的部分。最终检查清单在请求用户审批前逐项核验结构已命名一种解说结构复合仅当显式命名序列是叙事驱动的不是段落顺序驱动的钩子开场使用了命名钩子策略主体每帧只有一个职责主体累积式构建一串feature_showcase/benefit_highlight/product_intro而不是单个孤立主体帧字段每帧都有type、persuasion目录中的命名技巧和beat具体不泛泛旁白每个voiceover都按短语切分成提示Step 5 可逐一揭示不是一气呵成的长从句凡有已验证形状适配处都标注候选blueprint:无适配处则省略情绪情绪弧线有符合结构的有意义起伏转场只使用注册表名称且重复 2-3 种第 1 帧为cut连续性一致舞台 一致转场承载任何多帧序列真正的元素变换保留在单帧内资产asset_candidates缺省无脸除非存在真实的用户提供public/basename脚本SCRIPT.md只包含锁定的口头旁白静默帧是刻意的且从中排除。这份清单同时也是对 SKILL.md Step 3 门禁STORYBOARD.md存在、每帧具备必要叙事字段、有旁白时SCRIPT.md存在、用户已批准逐帧计划的支撑材料。通过检查后分镜进入 Step 3.1 音频与 Step 4 视觉设计阶段而你在 Step 3 写下的每一句按蓝图形态书写的 voiceover、每一个被命名的persuasion与beat都将成为下游 worker 精确还原叙事的坐标。【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
