插件安装: 在执行设置或更新命令之前,请遵循插件执行规则(当该技能位于 HyperFrames 插件内部时)。独立安装请保留以下更新说明。
首先,保持该技能最新——在运行前请与用户确认:
npx hyperframes skills update faceless-explainer。如果一切为最新版本,则为快速空操作;否则,它将刷新该技能及其依赖的核心领域技能,然后再使用它们。
媒体使用: 在获取音频/图片/标志之前,调用
/media-use从 HeyGen 目录解析 BGM/SFX/图片,并从其官方来源获取品牌标志。先运行--adopt以注册现有资产。参见/media-use技能。
无讲解人出镜解说 转 HyperFrames
使用此技能将一段文本转换为解说视频:选择一个设计系统,规划教学内容,并在 HyperFrames 中逐帧构建。无讲解人出镜意味着每个视觉元素都是在后期生成的——没有捕获步骤,也没有真实的资产清单。
入口是
/hyperframes。 你是编排者。运行每个步骤,验证其门控,然后才继续。此技能适用于通过文本解释一个主题,没有产品也没有要捕获的网站。任何其他意图,仅仅“制作视频”,或任何不确定性 → 首先阅读/hyperframes——意图层拥有所有路由决策,并且如果没有BRIEF.md,新创建也会经过它(设置的首要规则)。
你是编排者。在 videos/<project>/ 目录下工作。按顺序运行步骤,并在继续之前通过每个门控。用户门控步骤为第 0 步、第 3 步和第 6 步。在第 0 步之前阅读 ../hyperframes/references/brief-contract.md——它定义了门控类型以及 BRIEF.md 的 flow/storyboard 如何派生模式,该模式控制第 3/4/6 步的门控。除第 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 派生模式(概要合同 § 1)。(2)无 BRIEF.md 但项目存在(磁盘上有 hyperframes.json / STORYBOARD.md)→ 从故事板的元数据和已记录的首选项继续;绝不对已构建一半的项目重新提问。(3)两者都不存在——直接到达此处的新创建请求 → 阅读 /hyperframes 并运行其意图层(references/intent-interview.md):它会检查配方和记忆的默认值,执行此路由的问题(../hyperframes/references/routes/faceless-explainer.md),并返回锁定的概要。编辑请求跳过所有这些——直接进行编辑。
仅在缺少 hyperframes.json 时初始化。从主题中以 kebab-case 命名为 <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 并逐字转发其输出。它会报告语音/BGM 将使用 HeyGen 还是本地引擎,以及当未登录时如何登录。应用一个分支:
- 协作模式: 等待用户登录或显式选择
offline/go。 - 自主模式: 说明状态并通过可用的本地引擎继续。
当没有离线提供商时,不要静默忽略必需的能力;暴露阻塞点。不要将此决策合并到另一个问题中,或将密钥写入每个仓库的 .env。认证所有权和离线回退:/media-use references/setup-providers.md § 提供商。
门控: 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 的 colors/fonts 为空)→ 脚本将保留预设自己的调色板,这是一个完整可交付的设计。仅当用户指定了品牌颜色/字体时,才在运行前将其添加到 tokens.json,并且仅在必要时手动调整 frame.md。
门控: build-frame.mjs 退出 0——frame.md 来自一个已命名的预设,并且(当预设附带时).hyperframes/caption-skin.html 作为字幕皮肤源存在;所选预设已记录为首选项(--key style_preset --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。根据概要的 length 设置元数据 duration:——这是一个粗略的预期;组装步骤会报告最终长度与其的对比。
使用 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>。管道默认值否则为 Marcia(女性)(HeyGen)/ am_michael(Kokoro)——因此像“男性声音”这样的请求如果你不传递标志则会被静默忽略。语音 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 音乐库的 BGM 查找以及时间元数据。BGM 情绪来自故事板的 music: 字段。这使用 HeyGen Audio API 进行检索而非生成,以及相同的 ~/.heygen 凭据作为 TTS。有关提供商详细信息,请阅读 ../media-use/audio/references/tts.md。
如果没有旁白且没有 SCRIPT.md,则跳过语音生成。如果故事板有音乐情绪,BGM 仍可能运行。
规范的全静默标记(在重用此音频模型的工作流中共享):STORYBOARD.md 顶部 YAML 块中的 music: none 并且没有 SCRIPT.md。该组合将项目标记为静默——无旁白、无 BGM、无 SFX。audio.mjs 会识别它并生成任何内容(它会移除任何过时的 audio_meta.json;assemble 将缺失的 audio_meta.json 视为静默),因此此步骤是一个干净的跳过。music: none 与旁白一起保留 TTS 并仅关闭 BGM。请精确使用此拼写——不要发明其他标记。
门控: 音频作业已启动,或者项目已标记为静默(music: none + 无 SCRIPT.md)。
第 4 步:帧视觉设计
目