插件安装: 在运行设置或更新命令之前,若此技能位于 HyperFrames 插件内,请遵循插件执行规则。独立安装则保留下面的更新说明。
首先,保持技能新鲜——在运行前与用户确认:
npx hyperframes skills update faceless-explainer。如果一切为最新版本则快速跳过;否则会刷新此技能及其依赖的核心领域技能。
媒体使用: 在获取音频/图像/标志之前,请调用
/media-use来解决来自 HeyGen 目录的背景音乐/音效/图像以及来自官方来源的品牌标志。先运行--adopt注册现有资产。参见/media-use技能。如果宿主应用提供其自己的音乐或音效工具,则使用它们处理音乐和声音效果。
Faceless Explainer 到 HyperFrames
使用此技能将一段文本转化为讲解视频:选择设计系统,规划教学故事,并在 HyperFrames 中逐帧构建。无面意味着每个视觉都是后续创作的——没有捕获步骤,也没有真实资产清单。
入口是
/hyperframes。 你是编排者。执行每一步,验证其关卡,然后才继续。此技能用于从文本讲解主题,无产品无网站可捕获。任何其他意图、一个简单的“制作视频”请求或不确定 → 先阅读/hyperframes——意图层拥有所有路由决策,并且一个新鲜创建者若在此处没有BRIEF.md也会经过该层(设置的开门规则)。
你是编排者。在 videos/<project>/ 目录下工作。按顺序执行步骤,在继续前通过每个关卡。用户关卡为步骤 0、步骤 3 和步骤 6。在步骤 0 之前阅读 ../hyperframes/references/brief-contract.md——它定义了关卡类型以及 BRIEF.md 的 flow/storyboard 如何导出控制步骤 3/4/6 关卡的 mode。除了步骤 5(你派遣每个帧的子代理)外,每个步骤都由你自己完成。不要在此放置设计或运动规则;这些位于帧工作子代理中,此技能本地的 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ 以及 hyperframes-creative 中。
工作流程:步骤 0 设置 → hyperframes.json;步骤 1 简报 → capture/extracted/;步骤 2 设计系统 → frame.md;步骤 3 分镜/脚本 → STORYBOARD.md 和 SCRIPT.md;步骤 3.1 音频 → audio_meta.json;步骤 4 视觉设计 → 增强的 STORYBOARD.md;步骤 5 帧 → compositions/frames/NN-*.html 和 index.html;步骤 6 最终渲染 → renders/video.mp4。
步骤 0:设置
目标:以确认的简报进入,创建 HyperFrames 项目,并使简报持久化。
简报由意图层确认,而非此处提问。 开门规则,按顺序:(1) BRIEF.md 存在 → 读取它且不提问——简报已确定,其 flow/storyboard 导出 mode(简报契约 § 1)。(2) 无 BRIEF.md 但项目存在(磁盘上有 hyperframes.json/STORYBOARD.md)→ 从分镜的 frontmatter 和已记录偏好恢复;永不重新询问一个半建项目。(3) 两者均无——到达此处的全新创建请求 → 读取 /hyperframes 并运行其意图层(references/intent-interview.md):它检查配方和已记忆默认值,进行此路线的问题(../hyperframes/references/routes/faceless-explainer.md),并返回锁定的简报。编辑请求跳过所有这些——直接进行编辑。
仅在缺少 hyperframes.json 时初始化。从主题副标题式命名 <project>,例如 compound-interest-explained;切勿使用工作区名称或时间戳。
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer——init 检查已安装技能与 GitHub 最新版本,如果任何技能已过时则更新全局集合。
初始化后,让 <PROJECT_ROOT> 为 videos/<project>,并以此目录作为工作目录运行每个后续相对路径命令。在下面的命令中,. 表示 <PROJECT_ROOT>;切勿在调用者目录中写入 .media、capture 或输出文件。
初始化后立即编写 BRIEF.md(绝不能提前——init 拒绝非空目录):意图层的锁定简报,格式按 ../hyperframes/references/brief-format.md。解析 <MEDIA_DIR> 为已安装的 /media-use 技能目录。然后使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 记录每个偏好支持的回答(brief-format.md 命名子集)。如果意图层采用了配方,运行 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>;它将脚本的 frame.md 复制到项目中(然后步骤 2 被跳过)并返回步骤 3 草稿的骨架。配方提供答案,不提供批准;审查关卡仍然运行。
在继续设置之前显示登录状态——运行 npx hyperframes auth status 并逐字输出其结果。它会报告语音/背景音乐将使用 HeyGen 还是本地引擎,并且当未登录时,报告如何登录。应用一个分支:
- 协作模式: 等待用户登录或明确选择
offline/go。 - 自主模式: 陈述状态并通过可用的本地引擎继续。
当无离线提供者时不要静默忽略所需能力;呈现障碍。不要将此决定折叠到另一个问题中或将密钥写入每个仓库的 .env。认证所有权和离线回退:/media-use references/setup-providers.md § Providers。
关卡: hyperframes.json 和 BRIEF.md 存在;偏好支持的回答已记录(简报契约 § 2);登录状态已显示(已登录,或继续离线)。
步骤 1:简报(无捕获)
目标:将用户的文本作为信息源折叠到项目中。没有网站捕获,没有真实资产——这是一个无面讲解。
逐字保存用户的完整输入,然后手动创建合成捕获包:
capture/extracted/visible-text.txt——完整文章/笔记/主题/简报,逐字。这是信息来源,不是故事模板(步骤 3 会重塑它)。capture/extracted/tokens.json——{ "title": "", "description": "", "colors": [], "fonts": [] }。从简报填写title/description。除非用户明确给出品牌颜色或字体,否则保持colors/fonts为空——然后添加它们(设计预设无论如何都提供完整调色板)。
如果用户粘贴了脚本或希望保留其措辞,则将其逐字保存为 user_script.txt;VO_MODE(逐字或重构)来自 BRIEF.md——意图层在脚本到达时会询问它。仅当简报缺少此信息时,才在此处询问一次,并将答案存储以供步骤 3 使用。
不要 运行 npx hyperframes capture(没有 URL)。不要创建 asset-descriptions.md 或填充 capture/assets/——无面视觉效果在步骤 4-5 中创作,而不是捕获。唯一例外:如果用户提供了真实图像,则将其放在 public/<basename> 下并记下供步骤 3 使用。
关卡: capture/extracted/visible-text.txt 和 capture/extracted/tokens.json 存在;你可以用一句清晰的话陈述讲解器的主题和受众。
步骤 2:设计系统
目标:选择一个已提供的帧预设;一个脚本将其转换为本视频的 frame.md + 字幕皮肤。
当 BRIEF.md 指定 style_preset——用户已从意图层的展示中通过视觉选择它——使用它;仅当简报无声时,你才能做出判断。然后你做一个决定——哪个预设:阅读 ../hyperframes-creative/references/design-spec.md 并浏览 ../hyperframes-creative/frame-presets/;选择外观最适合主题、语气和受众的预设。然后运行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
脚本确定性地完成后续工作:将预设的 FRAME.md 复制到 frame.md 并混音到 capture/extracted/tokens.json 中的任何品牌令牌(品牌颜色按角色映射到预设的颜色键;预设的显示+正文字体替换为品牌的),将预设的字幕皮肤复制到 .hyperframes/caption-skin.html,并自检(映射中断时退出 1)。一旦退出 0 就继续——不要手动编辑规范。
无面讲解通常没有品牌颜色/字体(tokens.json 颜色/字体为空)→ 脚本保留预设自己的调色板,一个完整的可交付设计。仅在用户命名了品牌颜色/字体时将它们添加到 tokens.json 再运行,并且仅在映射确实需要时才随后手动调整 frame.md。
关卡: build-frame.mjs 退出 0——frame.md 来自命名预设,并且(当预设提供一个时).hyperframes/caption-skin.html 存在作为字幕皮肤源;所选预设已记录为偏好(--key style_preset --workflow <this workflow>,简报契约 § 2)。
步骤 3:分镜和脚本
目标:将文本转换为经批准的逐帧教学计划。
阅读 ../hyperframes-creative/references/story-spine.md(钩子语言、价值优先于证据、作为提案的分镜、可追踪源的视觉效果),references/story-design.md,../hyperframes-animation/blueprints-index.md,../hyperframes/references/storyboard-format.md,以及 ../hyperframes/references/script-format.md。使用它们写出 STORYBOARD.md,以及当需要解说时,SCRIPT.md。将 frontmatter duration: 设置为简报中 length 的值——一个大致的预期;装配会报告最终剪辑与之的差距。
使用 story-design.md 来规划讲解结构(概念/如何做/列表/故事)、钩子策略、清晰度技巧、情感节拍、类型枚举映射以及 VO_MODE。视频序列来自叙事设计,而非输入文本的段落顺序——重新排序、合并、省略、压缩。作为软指导,参考 ../hyperframes-animation/blueprints-index.md 中的角色→蓝图菜单:对于每个节拍,按照其候选蓝图暗示的形状编写配音,并在符合时标记候选 blueprint: ID。教学真理仍然决定哪些节拍存在——永远不要强制一个节拍符合某个蓝图,也永远不要仅仅因为有一个可用形状而发明一个节拍。无面视觉效果在后续生成,因此帧不携带资产清单:除非用户提供了真实的 public/<basename> 图像,否则将 asset_candidates 留空。使用分镜和脚本参考中的确切必填字段。
起草后,运行审查循环的计划通道——../hyperframes/references/review-loop.md § 1:将计划作为提案呈现,并提出两个问题——批准或更改,以及是否先要草图(推荐)或跳过。反馈以聊天回复形式给出;循环直到批准。这是一个检查点关卡(简报契约 § 1):在自主模式下没有什么要询问——将相同摘要作为预告发布并继续;草图融入构建,其带一个问题最终预览在步骤 6。
关卡: STORYBOARD.md 存在,每帧都有必需的叙事字段,当需要解说时 SCRIPT.md 存在,并且用户批准了逐帧计划(自主模式:摘要已作为预告发布)。
步骤 3.1:音频
目标:从已批准的脚本生成叙述、单词时间戳、音乐和音频元数据。
在步骤 3 批准后开始音频。在后台运行,然后继续步骤 4。(登录状态已在步骤 0 显示;引擎自动回退。)
在调用前根据用户请求选择叙述语音。 如果请求指定了语音、性别或语气,选择匹配的语音 ID 并传递 --voice <id>。管道默认值否则是 HeyGen 上的 Marcia(女性) / Kokoro 上的 am_michael——因此像“男性声音”这样的请求除非你传递标志否则会被静默忽略。语音 ID 因提供商而异;根据步骤 0 登录状态选择的提供商解析:HeyGen(已登录)通过 node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list(或 GET /v3/voices?engine=starfish);Kokoro(离线)通过 <MEDIA_DIR>/audio/references/tts.md 中的语音表(am_/bm_ 前缀为男性,af_/bf_ 前缀为女性)。当用户未表达偏好时,先回退到已记住的语音(简报契约 § 2)再使用管道默认值,并说明你使用了哪个;仅当两者都未指定时省略 --voice。当用户明确选择了此运行的语音时,记录它(prefs.mjs record --key voice)。
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &
音频脚本处理叙述、单词时间戳、从 HeyGen 音乐库查找背景音乐以及时间元数据。背景音乐情绪来自分镜的 music: 字段。这使用 HeyGen 音频 API 进行检索,而非生成,并使用与 TTS 相同的 ~/.heygen 凭据。有关提供商详情,请阅读 ../media-use/audio/references/tts.md。当宿主应用自己的工具制作音乐或音效时,将文件放在 assets/ 下并在 audio_meta.json 中列出并标记 "source": "host":音乐作为 bgm { "path": "assets/…", "source": "host" },分镜中带有 music: none;音效作为 sfx 条目 { "frame": <n>, "file": "assets/…", "offset_s": 0, "duration_s": <其长度>, "source": "host" }。每个音频通道都保留这些,并且带有宿主音效的帧不会获得查找提示。
如果没有叙述且没有 SCRIPT.md,跳过语音生成。如果分镜有音乐情绪,背景音乐仍可能运行。
规范的全静默标记(在重用此音频模型的工作流间共享):STORYBOARD.md 顶部 YAML 块中的 music: none,无 SCRIPT.md,并且无 sfx: 提示或宿主音频。该组合将项目标记为静默——当静默时,后续渲染通道
…(内容已截断)