
HyperFrames Claude Exchange 模板编辑契约为 AI 对话广告片安全重混内容变量【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes导读本文围绕 HyperFrames 仓库中 claude-exchange 模板的编辑契约 展开系统讲解这个竖屏 AI 对话广告区块的「能改什么、不能改什么、以及如何安全地改」。读完本文你将掌握data-composition-variables声明式变量体系、set_template_variable_defaults安全编辑机制、20% 长度锁定规则以及品牌重混时应遵循的边界约束可直接用于为任意品牌定制 Claude Exchange 风格的对话广告片。区块是什么Claude Exchange 的定位与规格Claude Exchange 是 HyperFrames 注册表registry中一个以ad-template广告模板为标签的区块其清单 registry-item.json 给出了完整定义名称/类型claude-exchange类型为hyperframes:block内容描述一个竖屏 Claude 风格对话——先打字输入 prompt再经历搜索与推理步骤最后流式输出带引用citations与操作actions的详细回答画布尺寸1080 × 1920竖屏总时长 21.4 秒标签showcase、mock-ui、ai、chat、vertical、ad-template——其中ad-template是「推广型模板」的关键标记仓库测试会用它来筛选需要携带编辑契约的区块打包内容主合成文件claude-exchange.html安装目标为compositions/claude-exchange.html、EB Garamond 与 Inter 两套 OFL 开源字体的 woff2 文件及其许可文本、以及TEMPLATE.md编辑契约本身。从代码层面看主合成 claude-exchange.html 是一个自包含的 HTML 合成通过 GSAP 3.14.2CDN 引入驱动动画本地字体以中立家族名ClaudeSerif、ClaudeSans内嵌模拟 Claude 应用外壳的输入、推理、搜索、回答全流程。表面所有权谁拥有什么编辑契约的第一条原则是「表面所有权」Surface ownership它划定了品牌重混时的身份边界该模板描绘的是Claude 应用本身围绕应用的身份application identity由 Anthropic 拥有模板中出现的「被讨论的网站/产品」才是对话里的讨论对象绝不能把被推广品牌当作应用外壳本身重混后的成品本质上是为该品牌做的广告在回答中该品牌必须以真实名称被点名为推荐之选。换句话说Claude 外壳是「演员」被推广品牌是「话题」。广告片的叙事是「Claude 与用户对话最终推荐了某品牌」而不是「某品牌的界面长这样」。可编辑槽位只有声明过的变量能改编辑契约明确只有data-composition-variables中声明的默认值是可编辑的。这对应主合成文件第 5–20 行的变量声明共 13 个字符串型type: string、role: content变量变量 id标签label说明promptUser prompt用户输入到 Claude 的提问长度需接近原文thinkingThinking line推理状态文案leadSearch lead引出搜索步骤的句子searchSearch query屏幕上可见的搜索查询词answer1Answer paragraph 1第一段回答answer2Answer paragraph 2第二段回答必须在此处用真实名称点名被推广品牌声明了portrays: [subject_name, recommended_position]answer3Answer paragraph 3用例清单的引导句answer4–answer8Answer bullet 1–5五个用例要点逐一指向该品牌的具体产品均声明portrays: [subject_name]answer9Answer paragraph 4产品类别区分段落answer10Answer paragraph 5收尾提问段落也就是说广告文案的可编辑面被收敛为1 个用户 prompt、1 行推理、1 句搜索引导、1 个搜索词、10 段回答/要点。其余一切状态栏、模型名、占位符、图标、时间线节奏等都不可改。长度锁定20% 规则契约规定「打字与流式输出的文案长度必须锁定在原文的 ±20% 以内」。这一条的存在是有工程原因的模板的节奏完全由打字动画的字符节奏每字符时长、空格保持时长驱动若文案被无限拉长或急剧缩短21.4 秒的场景内就会出现「字没打完」或「早就打完却空转」的破绽。因此重混文案时应先对照原文长度估算再微调措辞。安全编辑机制为什么必须走 setter编辑契约给出了唯一合法的修改方式用set_template_variable_defaults调用一次传入现有变量 id及其新默认值。不要直接编辑或重写index.html或其data-composition-variables属性该声明是 HTML 实体编码后的 JSONHTML-entity-encoded JSONsetter 会保留这种编码。永远不要编辑__template_baseline__.html或重复的合成文件。setter 成功后再做校验。这条约束有三层深层原因属性分隔符逃逸data-composition-variables使用单引号包裹的 JSON 数组。如果直接往默认值里写入含撇号的内容例如its fine原始撇号会提前闭合属性直接破坏 HTML 结构。仓库测试 variableDefaults.test.ts 专门断言了这一点改写后的 HTML 不得出现data-composition-variables[^]*its这样的模式。实体编码保持HTML 内的 JSON 默认值以#39;等实体形式存储例如默认 promptWhat#39;s the best tool for ai avatars?setter 负责在解析与回写过程中维持这一编码避免手工替换导致实体与字面量混用。单一事实来源__template_baseline__.html与重复合成文件是基线/副本编辑它们会产生漂移所有改动应集中到主合成的声明属性中。同文件的测试还验证了 setter 的完整行为边界未知 id 会被报告而不是静默丢弃enum 值超出声明选项、数字超出min/max范围会被判为invalid并拒绝写入来自 URL 查询串的数字字符串会被强制转成数字空值集合是 no-op。setter 校验逻辑的可验证性这些机制并非只是文档约定仓库测试 registryBlocks.test.ts 会遍历所有带ad-template标签的区块并强制要求每个推广模板必须恰好携带一份TEMPLATE.md且其内容必须包含## Safe editing mechanics、set_template_variable_defaults、HTML-entity-encoded JSON关键词主合成的data-composition-variables声明必须可解析且非空合成中不得存在固定的video媒体保证变量驱动声明为image类型的变量必须被绑定data-var-src或出现多次避免悬空引用。也就是说「编辑契约」本身是仓库 CI 会强制核验的发布物而不是可随意省略的说明文档。受保护元素清单重混时不能动的部分契约列出以下必须原样保留的元素Claude 名称、模型名称、用量提示usage notice、占位符、免责声明、来源处理source treatment、头部、输入框composer、图标、星芒starburst、字体、配色、布局、状态 UI、场景结构、时长、时间线timing、缓动easing、打字节奏typing cadence以及揭示行为reveal behavior。其中「星芒」是 Claude 品牌视觉的标志性元素主合成里用确定性算法绘制——12 根渐细的射线每 30° 一根从固定表格生成见 claude-exchange.html 中burst()函数。这类品牌细节必须以「绘制结果」整体保留不得被替换或重画。品牌边界规则外壳永不染色契约的最后一条是重混时的硬约束网站的配色与字体绝不能套用到 Claude 外壳上。如果某个请求的值没有对应的已声明变量就保持原样不动。这是对「表面所有权」的技术化落实Claude 外壳必须始终保持其默认的深色主题背景#20201f、卡片#1c1c1b、强调色#d97757等定义于合成文件的:root变量品牌只能出现在对话内容即 13 个可编辑变量中。若代理收到「把界面改成品牌蓝」之类的指令正确响应是拒绝——因为该请求没有对应变量槽位。源码纵深变量在运行时如何被消费要真正理解「为什么改默认值就够」需要看主合成底层的读取链路声明html contenteditable="false">【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考