HyperFrames v0.7.53Studio 手动编辑的合成安全加固与 GSAP Writer、Lint 修复全解析【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframesHyperFrames v0.7.53 发布于 2026-07-11本次版本的核心主题是让 Studio 的手动编辑对色彩分级color-graded合成变得安全编辑不再把运行时透明度瞬态烘焙进 tween 边界修复了编辑后元素消失的经典 bug缩放与旋转按组提交干净值选中元素不再重写或破坏作者手写的 clip-path裁剪工具也改为在元素旋转后的坐标系中绘制。与此同时GSAP 写入器不再在保存的合成中累积重复键Lint 规则与 CLI 提示也有一批针对性修正。读完本文你将理解这些修复背后的运行时机理、对应的源码落点以及如何在升级后验证这些行为。版本主题一次针对 Studio 编辑链路的整体安全加固v0.7.53 的改动高度集中于一个目标保证用户在 Studio 中手动编辑缩放、旋转、裁剪、属性面板修改一个带色彩分级的合成时不会意外改写合成作者精心编写的内容。发布说明用一句话概括了本次变更的四个支柱编辑不再把运行时 opacity 瞬态烘焙进 tween 边界消除元素在编辑后消失的问题resize 与 rotate 提交每组的干净值per-group values选中元素不再重写或销毁作者编写的 clip-path裁剪工具绘制在元素旋转后的坐标系中rotated frame。围绕这四点还有一批 Core、Parsers、Lint、CLI、Telemetry 的配套修复。下面按模块逐个展开。Studio让手动编辑对分级合成安全停止烘焙运行时透明度瞬态编辑后元素消失修复这是本次发布最关键的修复。在色彩分级合成中元素往往通过 GSAP tween 在运行期动态改变opacity例如淡入淡出、字幕进出。此前 Studio 在编辑过程中对 tween 重新初始化re-init时会把运行时的透明度瞬态值错误地当作作者意图写回 tween 边界导致重新计算出的 tween 起点/终点与作者编写的值不一致最终表现为元素在编辑后消失。本次通过两个提交联合解决Studio: Stop tween re-inits from baking runtime opacity transients—— 切断 tween 重新初始化对运行时 opacity 瞬态的烘焙路径Core: Capture authored inline opacity at parse time and follow source geometry—— 在解析阶段parse time就捕获作者写下的内联 opacity并让元素的透明度跟随源几何source geometry变化而不是跟随运行时瞬态。从架构上看这条修复横跨 Studio 与 Core 两个包Core 负责在解析期锁定作者值作为唯一事实来源Studio 则在编辑期不再覆盖它。这也解释了为什么发布说明把编辑不再烘焙瞬态与解析期捕获作者内联 opacity并列为核心修复。缩放与旋转按组提交干净值Studio: Correct gesture commits for scaled and graded elements修正了缩放resize与旋转rotate在缩放后且已分级元素上的手势提交逻辑。核心要求是提交时每组per-group得到干净的值——即提交到 GSAP tween 组里的变换值应当是稳定的最终值而不是叠加了多次手势的中间增量否则每次编辑都会在原来的变换上继续累加产生漂移。配合Studio: Route panel property commits to a group-owning set属性面板的提交被路由到组拥有group-owning的集合中确保当多个元素属于同一动画组时面板提交不会错位到错误的组而是由该组自己持有最终提交结果。选中元素不再重写作者 clip-path裁剪是 Studio 最复杂的编辑操作之一。此前选中一个带 clip-path 的元素再编辑会把元素现有的 clip-path 覆盖为裁剪计算的中间值作者手动编写的clip-path被破坏。本次修复让选中lift与取消选中restore保持作者值原样。源码层面packages/studio/src/components/editor/DomEditCropHandles.tsx 展示了这套抬升-恢复模型在 lift 阶段组件把元素的作者 clip-path 保存到preLiftInlineClipRefel.style.getPropertyValue(clip-path)同时将实际样式置为none以便开始拖拽拖拽结束后如果未提交则按保存的作者值原样恢复el.style.setProperty(clip-path, restore)否则移除临时属性。对应的 DomEditCropHandles.test.tsx 验证了clip-path: inset(...)、circle(...)等形状在抬升后能精确还原。Studio: Crop restore value is owned by the lifted elements gesture进一步明确了裁剪恢复值的归属恢复值应当由被抬升元素自己的手势gesture持有而不是由面板或其他上下文持有避免多元素共享裁剪状态时互相串值。裁剪工具绘制在元素旋转后的坐标系中Studio: Draw the crop UI in the elements rotated frame修复了旋转元素上裁剪 UI 的坐标错位此前裁剪框按未旋转的轴对齐矩形绘制与屏幕上旋转后的元素不重合。现在裁剪 UI 直接绘制在元素的旋转坐标系rotated frame中手柄与网格与视觉位置一致。Studio: Crop tool stands down for clips it cannot edit为裁剪工具增加了让位stand down保护当遇到当前实现无法安全编辑的 clip例如某些复杂 clip-path 形状或不受支持的组合时裁剪工具主动退出而非强行计算避免产生错误结果。Coretiming masks 对 source loaders 安全Core: Make timing masks safe for source loaders修复了 timing masks时序掩码在 source loaders源加载器负责加载视频/音频等媒体源的模块场景下的安全性问题。从改动内容看这属于 Core 运行时的防御性修复确保时序掩码在媒体源尚未就绪或正在加载时不会访问到无效状态避免加载阶段的竞态或空引用。它对 Studio 编辑链路的间接意义在于带媒体的分级合成在编辑预览时依赖可靠的 source loader 行为掩码安全是编辑稳定性的一部分。ParsersGSAP 写入器不再累积重复 vars 键Parsers: Never emit duplicate vars keys in either writer修复了一个会污染保存产物的 bugGSAP 的写入器writer在把 tween 的 vars 对象重新写回脚本时可能对同一个键重复输出例如immediateRender: true, immediateRender: true。这个问题在 packages/parsers/src/gsapParser.test.ts 的回归测试recast writer never doubles vars keys中有精确复现解析一个混和的tl.set(#a, { z: 0, rotationX: 5, immediateRender: true, scale: 1 }, 0)并通过splitIntoPropertyGroups拆分后解析器会把immediateRender放进 extras拆分时如果不做去重就会在每组里都补一份该标记。回归测试断言拆分后每一行tl.set(...)中的immediateRender恰好出现一次。修复覆盖either writer两个写入器意味着解析/重写链路中所有输出路径——包括属性分组拆分splitIntoPropertyGroups与常规的重写路径——都不再产生重复键保证 Studio 保存合成后脚本干净、可被 GSAP 无损解析。Lint解析方式与规则判定修正不再用正则解析 HTML 结构Lint: Parse HTML structure without regex是 Lint 包的一次底层改进原来用正则扫描 HTML 结构例如判断某段文本是否位于标签内在引号、转义、注释等边界情况下容易误判。修复后改为真正的结构解析packages/lint/src/rules/core.ts 中的isInsideHtmlTag即体现了这种逐字符、带引号状态机的结构感知逻辑跟踪标签开关与引号配对而不是用正则盲匹配。锚定 opacity-zero probe0.98 不再误匹配Lint: Anchor the opacity-zero probe so 0.98 stops matching修复了透明度探针opacity-zero probe的判定 bug此前判定文本/元素最终是否不可见的探针没有锚定完整数值边界导致opacity: 0.98这类合法值被误判为0开头而命中透明度为零的警告。本次将探针锚定anchor到完整的 opacity 数值只有真正为零的透明度才会命中。这与 Lint 的其他可见性规则配套例如 packages/lint/src/rules/captions.ts 中检测字幕退出动画缺少硬性tl.set终结时会检查opacity: 0以及 packages/lint/src/rules/composition.ts 中opacity:0 / visibility:hidden 的 overlay 仍然计入合成复杂度的规则——这些规则全部依赖可靠的 opacity 值读取锚定探针保证了数值边界的正确性。标记数字开头的元素 idLint: Flag digit-leading element ids新增规则id_requires_css_escape实现在 packages/lint/src/rules/core.ts 中当元素的id以数字开头/^\d/时给出 warning提示id123-frame这类 id 会让常见选择器#123-frame在querySelector()中直接抛SyntaxError。fixHint 给出两条建议将 id 改为字母开头推荐例如frame-123或在运行时使用#${CSS.escape(id)}构造选择器。packages/lint/src/rules/core.test.ts 中对应的测试验证了id123-frame命中 warning、idframe-123通过。这条规则对 Agent 生成的 HTML 尤其有用——生成器常产出以序号开头的 id在真实浏览器里会静默失效Lint 现在能在渲染前就把问题暴露出来。CLI 与 Telemetry提示修正与停滞阶段暴露CLI: Correct strict warning hint修正了hyperframes lint在 strict 模式下的警告提示文案让提示与实际触发条件一致避免误导开发者。Telemetry: Expose stalled render stages让遥测数据能够暴露停滞stalled的渲染阶段。渲染流水线Producer由多个阶段组成若某一阶段卡住如捕获、编码、上传此前只能看到整体失败现在可定位具体停滞阶段便于排查渲染挂起类问题。Product Launch 与 Hooks工程配套修复Product Launch: Hoist approved frame videos during assemblyProduct Launch 技能在组装最终视频时把已批准approved的帧视频提升到组装流程的合适位置确保成品使用的是通过评审的帧。Hooks: Scope pre-commit build check to target repo, fix stale symlinks将 pre-commit 的构建检查范围限定到目标仓库避免在多仓库工作区中误查其他仓库并修复了陈旧的符号链接导致的检查误报。Internal测试与仓库卫生Producer: Gate source tests by execution laneProducer 的 source 相关测试按执行通道execution lane门控避免测试在不同运行环境下相互干扰。Repo: Forbid tracked generated artifacts仓库强制禁止把生成产物纳入版本管理配合 scripts/check-tracked-artifacts.mjs 这类检查脚本防止构建产物、打包结果等被误提交。升级与验证建议升级到 v0.7.53 后建议按以下路径验证本次修复是否生效编辑后元素不再消失在 Studio 中打开一个带色彩分级与透明度动画tween 中有opacity变化的合成对元素做一次缩放/旋转编辑并保存检查重新播放时元素透明度是否与编辑前一致且 tween 边界未被改写。clip-path 保持原样对一个手工编写了clip-path的元素执行裁剪操作取消选中后确认clip-path值精确还原无法编辑的 clip 上裁剪工具应主动让位而不是产生错误结果。旋转元素上的裁剪框旋转元素后启动裁剪确认裁剪框与网格贴合元素旋转后的视觉位置。GSAP 脚本干净保存合成后检查生成的 GSAP 脚本中immediateRender等标记在每个 tween 中只出现一次。Lint 新规则对id123-frame的 HTML 运行hyperframes lint应看到id_requires_css_escape的 warning 及CSS.escape修复提示同时确认opacity: 0.98不再触发 opacity-zero 类误报。小结HyperFrames v0.7.53 是一次典型的稳健性发布没有新增对外功能而是把 Studio 手动编辑链路中所有会破坏作者合成意图的隐患逐一封堵——从 opacity 瞬态烘焙、per-group 提交、clip-path 保留、旋转坐标系裁剪到 GSAP writer 的重复键、Lint 的判定精度与 CLI 提示再到遥测的停滞阶段暴露。对于依赖 Studio 编辑分级合成、或以 Agent 批量生成 HTML 的用户本次更新直接提升了编辑不破坏内容的可信度值得立即升级。【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 HyperFrames v0.7.53：Studio 手动编辑的合成安全加固与 GSAP Writer、Lint 修复全解析
HyperFrames v0.7.53Studio 手动编辑的合成安全加固与 GSAP Writer、Lint 修复全解析【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframesHyperFrames v0.7.53 发布于 2026-07-11本次版本的核心主题是让 Studio 的手动编辑对色彩分级color-graded合成变得安全编辑不再把运行时透明度瞬态烘焙进 tween 边界修复了编辑后元素消失的经典 bug缩放与旋转按组提交干净值选中元素不再重写或破坏作者手写的 clip-path裁剪工具也改为在元素旋转后的坐标系中绘制。与此同时GSAP 写入器不再在保存的合成中累积重复键Lint 规则与 CLI 提示也有一批针对性修正。读完本文你将理解这些修复背后的运行时机理、对应的源码落点以及如何在升级后验证这些行为。版本主题一次针对 Studio 编辑链路的整体安全加固v0.7.53 的改动高度集中于一个目标保证用户在 Studio 中手动编辑缩放、旋转、裁剪、属性面板修改一个带色彩分级的合成时不会意外改写合成作者精心编写的内容。发布说明用一句话概括了本次变更的四个支柱编辑不再把运行时 opacity 瞬态烘焙进 tween 边界消除元素在编辑后消失的问题resize 与 rotate 提交每组的干净值per-group values选中元素不再重写或销毁作者编写的 clip-path裁剪工具绘制在元素旋转后的坐标系中rotated frame。围绕这四点还有一批 Core、Parsers、Lint、CLI、Telemetry 的配套修复。下面按模块逐个展开。Studio让手动编辑对分级合成安全停止烘焙运行时透明度瞬态编辑后元素消失修复这是本次发布最关键的修复。在色彩分级合成中元素往往通过 GSAP tween 在运行期动态改变opacity例如淡入淡出、字幕进出。此前 Studio 在编辑过程中对 tween 重新初始化re-init时会把运行时的透明度瞬态值错误地当作作者意图写回 tween 边界导致重新计算出的 tween 起点/终点与作者编写的值不一致最终表现为元素在编辑后消失。本次通过两个提交联合解决Studio: Stop tween re-inits from baking runtime opacity transients—— 切断 tween 重新初始化对运行时 opacity 瞬态的烘焙路径Core: Capture authored inline opacity at parse time and follow source geometry—— 在解析阶段parse time就捕获作者写下的内联 opacity并让元素的透明度跟随源几何source geometry变化而不是跟随运行时瞬态。从架构上看这条修复横跨 Studio 与 Core 两个包Core 负责在解析期锁定作者值作为唯一事实来源Studio 则在编辑期不再覆盖它。这也解释了为什么发布说明把编辑不再烘焙瞬态与解析期捕获作者内联 opacity并列为核心修复。缩放与旋转按组提交干净值Studio: Correct gesture commits for scaled and graded elements修正了缩放resize与旋转rotate在缩放后且已分级元素上的手势提交逻辑。核心要求是提交时每组per-group得到干净的值——即提交到 GSAP tween 组里的变换值应当是稳定的最终值而不是叠加了多次手势的中间增量否则每次编辑都会在原来的变换上继续累加产生漂移。配合Studio: Route panel property commits to a group-owning set属性面板的提交被路由到组拥有group-owning的集合中确保当多个元素属于同一动画组时面板提交不会错位到错误的组而是由该组自己持有最终提交结果。选中元素不再重写作者 clip-path裁剪是 Studio 最复杂的编辑操作之一。此前选中一个带 clip-path 的元素再编辑会把元素现有的 clip-path 覆盖为裁剪计算的中间值作者手动编写的clip-path被破坏。本次修复让选中lift与取消选中restore保持作者值原样。源码层面packages/studio/src/components/editor/DomEditCropHandles.tsx 展示了这套抬升-恢复模型在 lift 阶段组件把元素的作者 clip-path 保存到preLiftInlineClipRefel.style.getPropertyValue(clip-path)同时将实际样式置为none以便开始拖拽拖拽结束后如果未提交则按保存的作者值原样恢复el.style.setProperty(clip-path, restore)否则移除临时属性。对应的 DomEditCropHandles.test.tsx 验证了clip-path: inset(...)、circle(...)等形状在抬升后能精确还原。Studio: Crop restore value is owned by the lifted elements gesture进一步明确了裁剪恢复值的归属恢复值应当由被抬升元素自己的手势gesture持有而不是由面板或其他上下文持有避免多元素共享裁剪状态时互相串值。裁剪工具绘制在元素旋转后的坐标系中Studio: Draw the crop UI in the elements rotated frame修复了旋转元素上裁剪 UI 的坐标错位此前裁剪框按未旋转的轴对齐矩形绘制与屏幕上旋转后的元素不重合。现在裁剪 UI 直接绘制在元素的旋转坐标系rotated frame中手柄与网格与视觉位置一致。Studio: Crop tool stands down for clips it cannot edit为裁剪工具增加了让位stand down保护当遇到当前实现无法安全编辑的 clip例如某些复杂 clip-path 形状或不受支持的组合时裁剪工具主动退出而非强行计算避免产生错误结果。Coretiming masks 对 source loaders 安全Core: Make timing masks safe for source loaders修复了 timing masks时序掩码在 source loaders源加载器负责加载视频/音频等媒体源的模块场景下的安全性问题。从改动内容看这属于 Core 运行时的防御性修复确保时序掩码在媒体源尚未就绪或正在加载时不会访问到无效状态避免加载阶段的竞态或空引用。它对 Studio 编辑链路的间接意义在于带媒体的分级合成在编辑预览时依赖可靠的 source loader 行为掩码安全是编辑稳定性的一部分。ParsersGSAP 写入器不再累积重复 vars 键Parsers: Never emit duplicate vars keys in either writer修复了一个会污染保存产物的 bugGSAP 的写入器writer在把 tween 的 vars 对象重新写回脚本时可能对同一个键重复输出例如immediateRender: true, immediateRender: true。这个问题在 packages/parsers/src/gsapParser.test.ts 的回归测试recast writer never doubles vars keys中有精确复现解析一个混和的tl.set(#a, { z: 0, rotationX: 5, immediateRender: true, scale: 1 }, 0)并通过splitIntoPropertyGroups拆分后解析器会把immediateRender放进 extras拆分时如果不做去重就会在每组里都补一份该标记。回归测试断言拆分后每一行tl.set(...)中的immediateRender恰好出现一次。修复覆盖either writer两个写入器意味着解析/重写链路中所有输出路径——包括属性分组拆分splitIntoPropertyGroups与常规的重写路径——都不再产生重复键保证 Studio 保存合成后脚本干净、可被 GSAP 无损解析。Lint解析方式与规则判定修正不再用正则解析 HTML 结构Lint: Parse HTML structure without regex是 Lint 包的一次底层改进原来用正则扫描 HTML 结构例如判断某段文本是否位于标签内在引号、转义、注释等边界情况下容易误判。修复后改为真正的结构解析packages/lint/src/rules/core.ts 中的isInsideHtmlTag即体现了这种逐字符、带引号状态机的结构感知逻辑跟踪标签开关与引号配对而不是用正则盲匹配。锚定 opacity-zero probe0.98 不再误匹配Lint: Anchor the opacity-zero probe so 0.98 stops matching修复了透明度探针opacity-zero probe的判定 bug此前判定文本/元素最终是否不可见的探针没有锚定完整数值边界导致opacity: 0.98这类合法值被误判为0开头而命中透明度为零的警告。本次将探针锚定anchor到完整的 opacity 数值只有真正为零的透明度才会命中。这与 Lint 的其他可见性规则配套例如 packages/lint/src/rules/captions.ts 中检测字幕退出动画缺少硬性tl.set终结时会检查opacity: 0以及 packages/lint/src/rules/composition.ts 中opacity:0 / visibility:hidden 的 overlay 仍然计入合成复杂度的规则——这些规则全部依赖可靠的 opacity 值读取锚定探针保证了数值边界的正确性。标记数字开头的元素 idLint: Flag digit-leading element ids新增规则id_requires_css_escape实现在 packages/lint/src/rules/core.ts 中当元素的id以数字开头/^\d/时给出 warning提示id123-frame这类 id 会让常见选择器#123-frame在querySelector()中直接抛SyntaxError。fixHint 给出两条建议将 id 改为字母开头推荐例如frame-123或在运行时使用#${CSS.escape(id)}构造选择器。packages/lint/src/rules/core.test.ts 中对应的测试验证了id123-frame命中 warning、idframe-123通过。这条规则对 Agent 生成的 HTML 尤其有用——生成器常产出以序号开头的 id在真实浏览器里会静默失效Lint 现在能在渲染前就把问题暴露出来。CLI 与 Telemetry提示修正与停滞阶段暴露CLI: Correct strict warning hint修正了hyperframes lint在 strict 模式下的警告提示文案让提示与实际触发条件一致避免误导开发者。Telemetry: Expose stalled render stages让遥测数据能够暴露停滞stalled的渲染阶段。渲染流水线Producer由多个阶段组成若某一阶段卡住如捕获、编码、上传此前只能看到整体失败现在可定位具体停滞阶段便于排查渲染挂起类问题。Product Launch 与 Hooks工程配套修复Product Launch: Hoist approved frame videos during assemblyProduct Launch 技能在组装最终视频时把已批准approved的帧视频提升到组装流程的合适位置确保成品使用的是通过评审的帧。Hooks: Scope pre-commit build check to target repo, fix stale symlinks将 pre-commit 的构建检查范围限定到目标仓库避免在多仓库工作区中误查其他仓库并修复了陈旧的符号链接导致的检查误报。Internal测试与仓库卫生Producer: Gate source tests by execution laneProducer 的 source 相关测试按执行通道execution lane门控避免测试在不同运行环境下相互干扰。Repo: Forbid tracked generated artifacts仓库强制禁止把生成产物纳入版本管理配合 scripts/check-tracked-artifacts.mjs 这类检查脚本防止构建产物、打包结果等被误提交。升级与验证建议升级到 v0.7.53 后建议按以下路径验证本次修复是否生效编辑后元素不再消失在 Studio 中打开一个带色彩分级与透明度动画tween 中有opacity变化的合成对元素做一次缩放/旋转编辑并保存检查重新播放时元素透明度是否与编辑前一致且 tween 边界未被改写。clip-path 保持原样对一个手工编写了clip-path的元素执行裁剪操作取消选中后确认clip-path值精确还原无法编辑的 clip 上裁剪工具应主动让位而不是产生错误结果。旋转元素上的裁剪框旋转元素后启动裁剪确认裁剪框与网格贴合元素旋转后的视觉位置。GSAP 脚本干净保存合成后检查生成的 GSAP 脚本中immediateRender等标记在每个 tween 中只出现一次。Lint 新规则对id123-frame的 HTML 运行hyperframes lint应看到id_requires_css_escape的 warning 及CSS.escape修复提示同时确认opacity: 0.98不再触发 opacity-zero 类误报。小结HyperFrames v0.7.53 是一次典型的稳健性发布没有新增对外功能而是把 Studio 手动编辑链路中所有会破坏作者合成意图的隐患逐一封堵——从 opacity 瞬态烘焙、per-group 提交、clip-path 保留、旋转坐标系裁剪到 GSAP writer 的重复键、Lint 的判定精度与 CLI 提示再到遥测的停滞阶段暴露。对于依赖 Studio 编辑分级合成、或以 Agent 批量生成 HTML 的用户本次更新直接提升了编辑不破坏内容的可信度值得立即升级。【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考