Communitygithub.com

HyperFrames 核心 — 合成契约

HyperFrames 合成契约 — HTML 结构、data-* 属性、剪辑和轨道。编写有效 HyperFrames HTML 的权威参考。

HyperFrames 核心 — 合成契约 是什么?

该技能提供了 HyperFrames 合成系统的完整技术规范,面向需要编写符合 HyperFrames 标准 HTML 的开发者或 AI 代理。它详细定义了 HTML 骨架、画布元标签、场景、轨道和剪辑的所有属性及使用方式。支持图片、视频、音频以及 TTS 旁白等多种媒体类型,并通过 data-hf-* 属性实现动画、过渡、循环和修剪等高级控制。该规范适用于所有 HyperFrames 平台,并提供了 `npx hyperframes lint` 命令进行验证。对于正在构建程序化视频合成或动画系统的开发者而言,这是必须遵循的权威参考。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/christiansalazar-wk/ai-lore/tree/HEAD/skills/hyperframes-core

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

HyperFrames 核心 — 合成契约 preview

文档

HyperFrames 核心 — 合成契约 是做什么的?

HTML 骨架

<!DOCTYPE html>
<html data-hf-version="1">
<head>
  <meta charset="UTF-8" />
  <meta name="hf:canvas-width" content="1920" />
  <meta name="hf:canvas-height" content="1080" />
  <meta name="hf:fps" content="30" />
  <meta name="hf:duration" content="auto" />
</head>
<body>
  <div data-hf-scene="intro" data-hf-duration="5s">
    <div data-hf-track="background">
      <div data-hf-clip data-hf-start="0s" data-hf-duration="5s"
           style="background:#111;width:100%;height:100%;position:absolute;"></div>
    </div>
    <div data-hf-track="title">
      <div data-hf-clip data-hf-start="0.5s" data-hf-duration="4s"
           data-hf-animate="fade-in">
        <h1>你好,世界</h1>
      </div>
    </div>
  </div>
</body>
</html>

画布元标签

标签默认值说明
hf:canvas-width1920像素
hf:canvas-height1080像素
hf:fps30每秒帧数
hf:durationauto总时长;也可显式指定,例如 60s
hf:bg-color#000默认场景背景色

场景属性 (data-hf-scene)

属性类型描述
data-hf-scene字符串场景名称 / ID
data-hf-duration时间5s、10s、auto
data-hf-transition字符串cut、fade、slide-left、slide-right、zoom
data-hf-transition-duration时间默认 0.5s
data-hf-bgURL 或颜色场景背景

轨道属性 (data-hf-track)

属性类型描述
data-hf-track字符串轨道名称
data-hf-z数字z-index 层级
data-hf-mute布尔值静音该轨道的音频

剪辑属性 (data-hf-clip)

属性类型描述
data-hf-clip—将元素标记为剪辑
data-hf-start时间在场景内的开始偏移量
data-hf-duration时间剪辑时长;auto 表示内容自有时长
data-hf-end时间duration 的替代属性
data-hf-animate字符串简写动画预设
data-hf-in字符串入场动画
data-hf-out字符串退场动画
data-hf-volume0–1音频音量
data-hf-speed数字播放速度倍率
data-hf-loop布尔值循环媒体
data-hf-trim-start时间从开头修剪媒体
data-hf-trim-end时间在结尾修剪媒体

媒体剪辑

<!-- 视频 -->
<video data-hf-clip data-hf-start="0s" src="assets/hero.mp4" />

<!-- 图片(静止,按时长保持) -->
<img data-hf-clip data-hf-start="0s" data-hf-duration="3s" src="assets/logo.png" />

<!-- 音频 -->
<audio data-hf-clip data-hf-start="0s" src="assets/music.mp3" data-hf-volume="0.4" />

<!-- TTS 旁白 -->
<div data-hf-clip data-hf-tts="你好,欢迎观看演示。" data-hf-start="1s" />

时间格式

所有时间值均使用 CSS 风格的表示法:0s、1.5s、2000ms。允许使用小数秒。

验证

npx hyperframes lint index.html

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

相关技能