HyperFrames v0.7.68 发布解析修复循环短视频的帧覆盖率误判与 Composition CSS 嵌套选择器作用域丢失【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframesHyperFrames v0.7.682026-07-22 发布是一个 Bug-fix 版本解决了两类会直接影响成片质量的问题一是渲染流水线中的视频帧覆盖率门禁coverage gate不再错误地中止循环短片的渲染二是 composition 级 CSS 中基于原生 CSS Nesting 的嵌套选择器不再被 scoping 逻辑静默忽略。读完本文你将理解 HyperFrames 渲染器的帧覆盖率保障机制是如何工作的、HF_VIDEO_COVERAGE_THRESHOLD等配置的取值含义以及 composition CSS 作用域重写CSS scoping在编译期做了哪些事、CSS Nesting 场景下此前的缺陷成因与修复方式。版本概览v0.7.68 的变更面很小但指向明确。按 releases/v0.7.68.md 的官方记录该版本包含Fixes2 项ProducerCredit looping short videos in coverage gate#2665——在更长的时间槽中设置了loop的短片段会一次性交付全部源帧并按重复次数复用门禁现在按 source-source 而非 unique-source-vs-slot 计算3 秒循环片段放在 10 秒槽位中不再因 30% 覆盖率被中止。CorePreserve nested-rule selectors in composition CSS scoping#2721——原生 CSS NestingChrome 112 / Firefox 117 / Safari 16.5现在可以在 composition 的style块中正常工作scoper 不再把 composition 选择器重复应用到嵌套规则上[data-composition-idfoo] { .title { … } }能正确匹配 composition 内部的.title。Docs Examples2 项Skills在 changelog-video 中将字幕captions设为非可选。Changelog新增 2026-07-13 至 2026-07-20 的周报摘要。Other Changes1 项回滚feat(producer): renderStretch to re-time short compositions across longer scenes (#2676)即撤销了用 renderStretch 把短 composition 重新计时铺满更长场景的功能。下面逐一深入这两个核心修复并结合仓库源码说明其底层机制。背景什么是视频帧覆盖率门禁要理解第一个修复先要理解 coverage gate 为什么存在。HyperFrames 渲染器在把 composition 编码为 MP4 之前会先对时间线上的每个video片段做帧抽取extraction把源视频的帧交给运行时注入器runtime injector逐帧合成。问题在于某些故障场景下check与snapshot都能通过但最终编码出的 MP4 中对应片段是黑屏/空白——静默地产出错误成片。为此渲染器内置了一道 fail-loud 门禁对每个片段计算capturedFrames / expectedFrames比例低于阈值就在 extract 阶段结束时抛出VideoFrameCoverageError直接中止渲染而不是让坏成片流出。这套逻辑位于 packages/producer/src/services/render/videoFrameCoverage.ts关键设计包括阈值解析resolveVideoCoverageThreshold()从环境变量HF_VIDEO_COVERAGE_THRESHOLD读取阈值默认0.95允许 5% 的捕获帧缺失设为0或负数表示完全禁用门禁大于1会被钳制为1要求精确覆盖不给 29.97 fps 时间线上 ffmpeg 的 ±1 帧边界取整留余量非数值则回退默认值。预期帧数计算expectedFramesForClip()按片段[start, end)窗口与帧率计算应抽取的帧数CFR 抽取使用 FFmpeg-vf fpsfps四舍五入到最近帧边界VFR 抽取使用-fps_mode cfr -r fps向上取整。交付帧数统计统计的是entry.framePaths.size——真正交付给运行时注入器的去重帧路径数量而非抽取器自报的总数部分抽取器的totalFrames包含缓存命中跳过的帧会虚高。短路片段容差对预期帧数在 14–20 帧之间、且仅差 1 帧的边界性缺失ffmpeg 边界取整造成在阈值小于 1 时予以放行避免误报。修复一循环短视频不再被覆盖率门禁误判中止问题成因修复前的门禁按“槽位帧数”计算预期覆盖一个 3 秒视频放在 10 秒的时间槽中expected 为 10s × 30fps 300 帧而抽取器只会从 3 秒源视频中抽出 90 帧。若片段设置了loop播放时这 90 帧会按重复次数复用输出侧的 300 帧每一帧都能映射到某个源帧交付是完整的——但修复前的门禁按90 / 300 30%计算低于 95% 阈值直接把渲染中止了。这是一个典型的误判false positive门禁的度量口径与播放语义不一致。源码层面的修复逻辑修复后的expectedFramesForVideo()packages/producer/src/services/render/videoFrameCoverage.ts把预期帧数改为Math.min(slotFrames, sourceFrames)槽位能需要多少帧与源视频实际能提供多少帧取较小者。源码注释给出的依据是非循环短片段会在尾部“持帧”hold final frame循环短片段则按重复次数复用整套源帧——两种情况下同一套唯一源帧已经完整覆盖了整个槽位因此覆盖率必须度量 source-source而不是 slot-source。以 #2665 的回归用例为例packages/producer/src/services/render/videoFrameCoverage.test.tsloop: true的视频放在 0–10s 槽位30fps源时长 3s 抽出 90 帧修复后报告为expectedFrames: 90, capturedFrames: 90, ratio: 1门禁通过而修复前同样的输入会被算成 30% 并中止。误判被消除但 fail-loud 语义被完整保留值得注意的是这次修复只放宽了“度量口径”没有削弱门禁本身的保护能力。同一个测试文件中有多条对照用例videoFrameCoverage.test.ts循环片段的源抽取真的被截断时90 帧源只交付了 60 帧ratio低于阈值仍然抛出VideoFrameCoverageError非循环片段的尾部持帧同样只按源部分记账credits a non-looping held tail against the source portion onlyL243-L248抽取截断时依旧 fail-loud容器音轨比视频流长60s 音频 3s 视频流的场景门禁按可播放的视频流记账不再被更长的容器时长拉低覆盖率L261-L281。对使用者的实际影响如果你的 composition 里有“短素材循环铺满长场景”这类常见做法v0.7.68 起这类渲染不会再被覆盖率门禁中断如果你遇到真实抽取失败门禁仍然会以清晰报错中止并提示Set HF_VIDEO_COVERAGE_THRESHOLD0 to disable this gate而HF_VIDEO_COVERAGE_THRESHOLD的取值行为默认 0.95、0禁用、1精确覆盖与之前一致。修复二Composition CSS Scoping 保留嵌套规则选择器问题成因HyperFrames 的 composition 机制允许把带data-composition-id的子合成sub-composition挂载/内联到父合成中。为避免不同 composition 之间的样式互相污染编译期的 CSS scoper 会重写每个 compositionstyle块中的选择器顶层规则的选择器前会被加上 composition 作用域例如[data-composition-idfoo]使样式只命中本 composition 内部。缺陷在于scoper 无差别地对所有规则包括嵌套在另一条规则内部的规则重复应用这一前缀。考虑如下使用原生 CSS Nesting 的写法[data-composition-idfoo] { .title { color: red; } }修复前的 scoper 会把嵌套的.title也重新加上作用域前缀得到[data-composition-idfoo] [data-composition-idfoo] .title这样的后代选择器。而 composition 根在 DOM 中只出现一次、不会自我嵌套这个选择器永远匹配不到任何元素——嵌套规则被静默忽略样式“写了但没生效”且没有任何报错排查成本很高。源码层面的修复逻辑修复位于 packages/core/src/compiler/compositionScoping.ts。新增的isNestedInsideAnotherRule()L213-L220通过向上遍历 PostCSS AST 父节点判断当前 Rule 是否嵌套在另一条 Rule 内部scopeCssToComposition()的walkRules回调在两个条件成立时跳过作用域重写L241-L254root.walkRules((rule) { if (isInsideGlobalAtRule(rule)) return; // keyframes / font-face 等全局 at-rule 内部 if (isNestedInsideAnotherRule(rule)) return; // CSS Nesting 嵌套规则保留原选择器 rule.selectors rule.selectors.map(/* 应用 composition scope 前缀 */); });原理是 CSS Nesting 模块的匹配语义嵌套规则在匹配时天然继承父规则的前缀即外层[data-composition-idfoo]已经提供了作用域浏览器会自行把嵌套的.title解析为“位于[data-composition-idfoo]内部的.title”。因此只有顶层规则需要被 scoper 显式加前缀嵌套规则必须保持原样。验证用例packages/core/src/compiler/compositionScoping.test.ts 中有两条针对 #2721 的回归用例preserves nested-rule selectors so CSS Nesting inheritance works (#2721)L868验证单级嵌套的选择器保持原样、不再产生修复前那种永不匹配的[…] .title重写结果preserves deeply-nested CSS Nesting rules (#2721)L896进一步覆盖多层深度嵌套的情形。对使用者的实际影响在支持原生 CSS Nesting 的浏览器基线Chrome 112 / Firefox 117 / Safari 16.5见 docs/concepts/compositions.mdx 相关概念文档下你可以直接在子合成的style块里写出嵌套样式组织作用域内的布局与主题而不再被迫为每条规则手写完整的选择器前缀同一 composition 内多实例挂载composition id 改名重放的场景也受同样的 scoper 逻辑保护。其他变更与版本边界renderStretch 功能回滚v0.7.68 回滚了此前引入的renderStretchre-time short compositions across longer scenes#2676。从源码结构看该功能与上述覆盖率门禁同属 Producer 渲染管线时间槽 vs 短内容的时长对齐两者围绕同一类“短内容进长槽位”的语义问题先后调整——v0.7.68 选择先收窄 renderStretch 行为、修正覆盖率度量口径。使用该能力渲染短 composition 铺满长场景的用户升级后应回到回滚前的行为预期。Skills 变更changelog-video 技能模板中将字幕captions标记为非可选即生成 changelog 类视频时会默认携带字幕。适用前提以上行为以当前仓库中 v0.7.68 发布说明releases/v0.7.68.md为准HF_VIDEO_COVERAGE_THRESHOLD仅在渲染Producer环节生效对本地预览与 snapshot 检查无影响。小结v0.7.68 虽然只有两个用户可见的 Bug 修复但都落在 HyperFrames 渲染确定性的关键路径上帧覆盖率门禁的度量口径从“槽位帧数”修正为“源帧数封顶”Math.min(slotFrames, sourceFrames)循环短片与尾部持帧的合法用法不再被误判中止而真实抽取截断仍然 fail-loudvideoFrameCoverage.ts、videoFrameCoverage.test.tscomposition CSS scoper 识别 CSS Nesting 嵌套规则并跳过重复加前缀嵌套选择器得以按浏览器语义正常匹配不再被静默忽略compositionScoping.ts、compositionScoping.test.ts。如果你正在用短素材循环填充长场景、或在子合成中使用原生 CSS Nesting 组织样式升级到 v0.7.68 后这两类用法的行为会与预期一致若需自定义覆盖严格度可通过HF_VIDEO_COVERAGE_THRESHOLD环境变量调整默认 0.95设为 0 禁用。【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考