用途
hyperframes-faceless-explainer 是 HyperFrames 体系中的一个技能,用于把任意文本——一篇文章、笔记、一个主题或一份简报——转化为无出镜(faceless)讲解视频。所谓无出镜,是指没有网站或真实素材可供采集,所有视觉元素都在后续步骤中凭空设计生成。该技能面向“从文本讲解一个主题”的场景,不涉及产品演示或网站录制。
主要能力
该技能充当编排器,按顺序执行各步骤并逐一把关。整体工作流包括:
- Step 0 初始化:创建 HyperFrames 项目并固化简报(BRIEF.md)。
- Step 1 简报:把用户文本原样保存为信息源,手工创建合成采集包(visible-text.txt、tokens.json)。
- Step 2 设计系统:选择一个内置 frame 预设,由脚本生成 frame.md 与字幕皮肤。
- Step 3 分镜与脚本:把文本转化为逐帧教学计划(STORYBOARD.md)和脚本(SCRIPT.md)。
- Step 3.1 音频:根据脚本生成旁白、词级时间戳、背景音乐与音频元数据。
- Step 4 帧视觉设计:为每个分镜帧补充视觉方向、布局意图与动效选择。
- Step 5 帧构建:为每一帧派发子代理,生成 compositions/frames/NN-*.html 与 index.html。
- Step 6 最终渲染:输出 renders/video.mp4。
其中 Step 0、Step 3、Step 6 为用户把关步骤。
使用方式
技能强调先保持自身为最新版本,运行前需与用户确认:npx hyperframes skills update faceless-explainer。在获取音频/图片/logo 前,需调用 /media-use 从 HeyGen 目录解析 BGM/SFX/图片,并从官方来源获取品牌 logo,先运行 --adopt 注册已有素材。
初始化命令为:npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer。项目名从主题取 kebab-case,如 compound-interest-explained。初始化后立即写入 BRIEF.md(初始化会拒绝非空目录,故不能提前写)。
设计系统步骤运行:node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .,脚本会复制预设的 FRAME.md 为 frame.md,并按角色把品牌色映射到预设色键、替换字体,同时复制字幕皮肤并自校验。
音频步骤运行:node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &。旁白声音需在调用前根据用户要求选择;若用户指定了声音、性别或语气,需传入 --voice <id>。默认声音为 HeyGen 上的 Marcia(女声)或 Kokoro 上的 am_michael。
在发明任何具名视觉效果前,需先搜索实时目录:npx hyperframes catalog --query "<the look, in plain English>" --json,该搜索无需安装任何东西,可从任意目录对托管注册表(约 400 个区块与组件)排序。
适用场景
适用于从纯文本讲解一个主题、没有产品或网站可采集的情况。若意图不明确、只是“做个视频”,或存在任何不确定性,应先阅读 /hyperframes,由意图层决定路由。
限制
- 无出镜讲解没有品牌色/字体时,脚本会保留预设自带调色板。
- 不要运行 npx hyperframes capture(没有 URL)。
- 不要创建 asset-descriptions.md 或填充 capture/assets/。
- 唯一例外:用户提供了真实图片时,放到 public/<basename> 并在 Step 3 注明。
- 完全静音标记为:STORYBOARD.md 顶部 YAML 块中 music: none 且无 SCRIPT.md。
- 设计或动效规则不写在本技能中,而位于 frame-worker 子代理、../hyperframes-animation/rules/ 与 blueprints/、以及 hyperframes-creative。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。