HyperFrames v0.7.57 版本解析稳定发布链接、团队空间协作与 HeyGen 调用溯源标记【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframesHyperFrames v0.7.57发布于 2026-07-14是一次以「发布链路稳定性」为核心的版本迭代hyperframes publish现在返回稳定公共 URL重复发布原地更新同一链接新增--space团队空间标志与可提交的项目描述文件让整个团队收敛到同一个共享链接同时预览评审会话可跨页面刷新存活并为所有 HeyGen API 调用加上X-HeyGen-Client-Source溯源头。读完本文你将掌握稳定发布的完整参数语义、团队协作的落地方式、调用溯源机制以及本版本修复清单背后的工程细节。版本核心一览本版本亮点集中在三个方面主题状态影响面hyperframes publish稳定公共 URL新增能力CLI 发布链路预览评审会话跨刷新存活体验改进Preview / Studio 评审流程X-HeyGen-Client-Source调用溯源头新增标记CLI、Media Use、avatar-video 配方一批渲染、校验、Studio 修复稳定性提升Engine、producer、lint、player、render稳定公共 URL重复发布原地更新同一链接行为变化此前hyperframes publish每次发布可能生成全新链接反复分享会带来链接失散问题。v0.7.57 之后只要登录态有效重复发布会更新同一个链接。发布前 CLI 会读取本机缓存提示该目录此前发布的位置Previously published at url该逻辑位于 packages/cli/src/commands/publish.ts稳定 project id 的解析顺序为「显式--update目标 已提交的团队 project id 本机存储/新生成的 id」从而保证同一目录的重复发布收敛到同一链接。发布成功后输出会明确区分「Updated existing project」与「Created new project」两种状态。参数语义hyperframes publish在 v0.7.57 中的完整参数来源packages/cli/src/commands/publish.ts参数类型说明dir位置参数项目目录默认为当前目录--yes/-y布尔跳过发布确认提示适合脚本--public布尔任何人凭 URL 可访问默认私有需认证与访问权限--update url|id字符串原地更新已发布项目传入其 URL 或 id--space space-id字符串发布到共享团队空间让队友更新同一链接--no-proxy布尔跳过为浏览器不友好的编码如 HEVC烘焙 H.264 代理--update的目标解析兼容完整 URL、无 scheme 的 URL、带?query/#hash的链接以及裸 idparseUpdateTargetpublish.ts。关键约束--update与--space仅在已认证的前提下生效未登录时会直接报错--update requires authentication. Run hyperframes auth login first.这是为了杜绝本想更新旧链接、实际却静默生成了新链接的失败模式。若登录已过期失效CLI 同样会大声提示而不是假装更新成功。团队空间与可提交的 project.json配合--space space-idCLI 会在项目目录写入一个可提交的描述文件.hyperframes/project.json{ projectId: stable-project-id, spaceId: team-space-id }实现位于 packages/cli/src/utils/projectLink.ts。该文件不含任何密钥所有权由服务端依据已认证空间的成员关系强制校验团队将其提交到仓库后任何成员在项目根目录执行hyperframes publish都会收敛到同一个共享链接。space id 的解析顺序为「显式--space 已提交的 space id 个人空间」。发布成功后若检测到未提交或 space 变化CLI 会提示写入路径并建议提交Wrote .hyperframes/project.json — commit it so your team publishes to this link.注意这是便捷性文件若项目目录只读导致写入失败不会把一次成功发布误报为失败外层 catch 仅接管真正的发布错误。本地链接缓存本机缓存维护在~/.hyperframes/projects.json目录权限0o700文件权限0o600按项目绝对路径记录{ projectId, url }projectLink.ts。该缓存与团队project.json配合构成了「本机记忆 仓库级收敛」的双层稳定链接机制。测试验证packages/cli/src/commands/publish.test.ts 覆盖了关键路径裸 id 的解析、重复发布无需--update标志即可命中同一链接、以及重复发布且未带--public时不妄称 Private的输出契约CLI 只陈述自己请求了什么不替服务端宣称未观察到的可见性状态。预览评审会话跨刷新存活本版本让预览评审会话在页面刷新后得以保留PR #2384实现位于 packages/cli/src/commands/preview.ts。评审者不再担心刷新页面导致评审上下文丢失适合需要反复确认的多人评审场景。该命令还支持--port、--no-open、--background、--status、--stop、--list、--kill-all等参数可灵活接入 CI 或远程评审工作流。为 HeyGen 调用打上 X-HeyGen-Client-Source 溯源标记CLI 侧实现v0.7.57 为 CLI 发起的 HeyGen API 调用统一附加溯源头X-HeyGen-Client-Source: hyperframes常量定义于 packages/cli/src/auth/client.tsexport const HEYGEN_CLIENT_SOURCE_HEADER X-HeyGen-Client-Source; export const HEYGEN_CLIENT_SOURCE hyperframes;buildAuthHeadersclient.ts对两种认证类型分别处理OAuth发送Authorization: Bearer token、X-HeyGen-Source: cli仅 OAuth 生效、用于门控免费额度与X-HeyGen-Client-Source: hyperframesAPI Key发送x-api-key与X-HeyGen-Client-Source: hyperframesAPI-key 请求不发X-HeyGen-Source避免对非 OAuth 请求做矛盾的 cli-source 声明但工具溯源头仍会发送——API-key 的调用同样是 hyperframes 使用。该标记用于后端在计费元数据中隔离 hyperframes CLI 的使用量。测试断言见 packages/cli/src/auth/client.test.ts。API 基地址支持HEYGEN_API_URL环境变量覆盖默认https://api.heygen.com便于开发联调。Media Use 与 avatar-video 配方同一溯源头也扩展到了 Media Use 技能与 avatar-video HeyGen 配方PR #2365、#2391即skills/media-use等目录中的调用同样携带该头保证无论请求来自 CLI 还是技能脚本后端都能识别为 hyperframes 使用。本版本同时精简了 Media Use 文档中的 HeyGen 生成式用例表格PR #2370并把云端渲染与变量说明补进了 CLI 技能PR #2356。渲染与校验链路的稳定性修复截图不变量与 HDR 元数据Engine 与 producer 在本版本中统一了forceScreenshot的权威来源单一本地变量驱动并把编程式forceScreenshot的退出开关带到具体解析站点同时确立软件 GPU 浏览器即隐式开启截图捕获的不变量并在具体解析点应用该不变量相关修复见packages/engine与packages/producer目录。渲染侧要求HDR 输出必须携带传输元数据PR #2377配套测试把 HDR fixture 色彩标签写入 H.264 VUIPR #2389此外还为显式并行捕获超时增加了重试PR #2331并让渲染结果以结构化形式输出PR #2153。WebM / 透明通道探测CLI 侧收紧了 WebM 处理支持 1–3 帧的极短 WebM 并补充像素探针测试当ALPHA_MODE标签写入但缺少 side data 时能正确识别 WebM 透明通道丢失批量资源导入的RENDER_FAILED也补充了更明确的 endpoints 标注。遮挡探测与对比度校验遮挡探测occlusion probe修复了三类误报pointer-events不可见元素、低 alpha 渐变、尚未进入视口的文本PR #2357对比度检查现在会跳过被故意覆盖的文本PR #2366。lint、init 与 keyframesLint 隔离了 IIFE 时序常量PR #2378并可从template内的 script/style 中提取关键帧PR #2374hyperframes init强制要求非交互模式显式声明来源PR #2395并拒绝缺失的示例值PR #2376check命令新增坐标帧coordinate-frame布局发现结果PR #2354。性能、发布与内部工程改进性能Producer 缓存本地字体压缩结果PR #2397重复打包字体时避免重复压缩发布packed 消费者打包产物的传递依赖解析为本地 tarball避免发布产物依赖漂移PR #2396仓库侧新增 packed consumers 校验脚本Player主动管理连接与媒体资源、为运行时协议增加版本号保持运行时传输契约Browser可恢复被遗弃的安装锁PR #2328并支持当前版本的 FFmpeg filter 脚本PR #2324CIStudio 切换后稳定 Windows 测试套件PR #2320并修复了安装锁等待通知的 flaky 测试。升级与验证建议更新到 v0.7.57 后先在登录态下执行hyperframes publish确认输出出现稳定的URL与Updated existing project状态团队协作场景指定--space space-id发布一次提交生成的.hyperframes/project.json再让队友直接hyperframes publish验证是否收敛到同一链接检查~/.hyperframes/projects.json权限应为0o700目录 /0o600文件确认发布链路本地缓存正常涉及 HDR 输出时确认工程已携带传输元数据避免渲染侧校验拒绝。版本完整变更可对比 releases 目录下的相邻版本记录v0.7.56 → v0.7.57核心实现与测试分别位于 publish.ts、projectLink.ts、auth/client.ts 与对应测试文件。【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考