Archify 语义化 Story 载体Semantic Story Carrier设计与实现解析让五类语义流 Token 沿精确关系流动【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify本篇技术文章围绕 Archify 项目可视化研究第 49 轮Round 49的决策文档 research-visual-evolution-round-49.md 展开它记录了如何将第 48 轮Round 48引入的五类Semantic Flow Tokencall / data / event / security / state接入既有的 Story Beat 播放体系形成语义化 Story 载体。读者读完本文后将掌握 Archify 中关系身份去重的实现原理、Token 分类与几何构建的完整逻辑、?embed1play1分享播放契约的边界以及该方案在 template.html 中的真实落地点与对应测试。一、决策背景为什么要做语义化 Story 载体Round 48 为 Archify 的Relationship Preview关系预览引入了五类语义流 Token调用call、数据data、事件event、安全security、状态state。这些 Token 能沿着一条精确的关系路径path、line或polyline流动直观表达这条连线上流动的是什么语义载荷。但当时这五类 Token 只存在于直接关系检查的路径中并未出现在项目的正式 Story 播放、README 证明面与 Gallery 分享面上。Round 49 的决策是当一次有意的 Story 播放跨越一条精确的、由作者撰写的authored关系时恰好一个匹配的 call/data/event/security/state Token 应沿这条精确关系流动一次而 source route、marker、label、nodes、camera target、beat caption 与 Story Trail 全部保持不变。决策文档明确把这一轮定位为比再做一个 viewer 面板、minimap、风格预设、环境循环动画或新的 motion 持有者更强的切片它让项目的主要呈现面和 README 证明面与直接关系检查讲的是同一种语义故事同时先修复一个具体的身份identity缺陷。二、现状与缺口部件齐全但彼此不连通决策文档指出共享 viewer 中已经有正确的零件但尚未汇合现有能力位置archify/assets/template.html当前职责relationshipTokenKind()第 7954 行起将一条精确关系分类为 call/data/event/security/state并给出确定性优先级relationshipTokenGeometry()第 7995 行起在 author 出的path/line/polyline几何上放置紧凑 TokenstoryStep()与pulseStoryStep()第 9702 行、第 9917 行起构建有序 Story Beat 并驱动通用的 Story Trail 流动动画storyMotionAllowed()第 9885 行起拒绝一切 embed 中的 Story 运动即使 URL 显式带?embed1play1followStoryStep()第 9998 行起正确允许 embed 仅在data-share-playbacktrue时推进相机与字幕也就是说运动权限的闸门两侧标准不一致followStoryStep()已经支持显式分享播放而storyMotionAllowed()却把 embed 全部拒绝与此同时Story 载体carrier本身尚不存在。三、先修的身份缺陷带标签关系被计为两条边在考虑任何运动之前还存在一个精确身份exact identity缺陷。源码中storyStep()会遍历每一个带边语义的 DOM 元素并逐个入列template.html。问题在于带标签的关系既会作为可绘制的 route 被渲染又会作为 context label group 被渲染两者拥有相同的data-edge-key。在当前的 Agent Tool Call Gallery 产物中11 个关系键里有 5 个出现两次1、3、5、9、10。例如happy-path故事包含chat → planner其作者关系键为1于是这条关系的 route 与 label group 被计数为两条边被分类为multiple进而被既有的step.edges.length 1脉冲闸门排除。而源 JSON 明确证明这是一条关系ID 为plan-request并非两条平行关系。权威本地证据Agent Tool Call story 源文件编译后的 Agent Tool Call 产物共享 Story Beat 实现因此决策文档给出的第一个实现动作必须是在判定forward、reverse或multiple之前先按data-edge-key对语义边记录去重而不是用放宽成 1的运动条件来掩盖 bug。这一点在 story-carrier.test.mjs 第 47-55 行有专门测试断言模板中存在uniqueStoryEdges(forward)、uniqueStoryEdges(reverse)以及edges.length 1 forward.length 1 ? forward的精确逻辑。四、主源对比三条可借鉴的外部实现路径决策文档对照了三个公开实现明确借什么、怎么改、跳过什么1. Fireworks Tech Graph载体属于路线且故障时关闭fail closed其官方运动契约在节点、标签、容器、marker、几何与相机全部固定的前提下让连接器运动遵循语义顺序。场景使用可识别的、路线所属的载体Blueprint 注册珠、Notion 记忆卡均派生自源路径重复的语义角色通过精确的(role, stage, order)身份独立寻址剥离运动元数据后还原出相同的静态几何。Borrow一个有意义载体运行在精确且不可变的源路线上路线身份不明确时故障关闭。AdaptArchify 已有更稳定的data-edge-key/可选关系 ID 与五种跨渲染器 Token直接复用而非引入 Fireworks 的场景元数据矩阵。Skip5.75 秒无限循环 GIF 操作、按风格的时间表、新媒体格式、环境载体流与复制的签名几何。2. React Flowxyflow运动对象与可见边共享同一条计算路径其一等公民 Animating Edges 示例渲染普通BaseEdge并把同一条edgePath传给 SVGanimateMotion载体。路径是唯一事实来源运动只是相邻的视觉层而不是第二条路线计算。Borrow把载体绑定到已编译的精确路径上。Adapt复用既有有限 Token 词表放进 Story 既有的 780 ms 精确边脉冲而不是示例里无限循环的通用圆。SkipReact 运行时、可编辑节点状态、重复路径计算、无限重复、整节点沿边移动。3. AntV G6载体可以是边拥有的子形状但生命周期必须明确其 fly-marker 示例把 marker 建为精确边的子形状并把该边的 key shape 作为offsetPath其 path-in 示例则展示一个有界路径揭示动画显式 500 ms 时长并保留结束状态。Borrow让移动标记归精确关系几何所有并显式声明生命周期。Adapt每个被选中的 Story Beat 至多一个载体配 Archify 既有的清理逻辑与运动治理器motion governor。Skip图运行时、自定义边注册表、无限迭代与持久 ant-line/fly-marker 装饰。五、Borrow / Adapt / Skip 决策总表决策Round 49 边界Borrow一个可识别的载体沿一条精确不可变路线行进载体与可见关系使用同一条路径与作者方向。Adapt复用 Round 48 的五类 Token 种类与几何放进当前 Story 持有者允许出现在普通产物中且只允许出现在已显式的data-share-playbacktrueembed 契约中。Adapt在判定方向或多重性之前先把 Story Beat 的边归一化为每个稳定data-edge-key一条语义记录。Adapt对 group/no-edge 与真正的平行边 Beat 保留通用静态 Story Trail 与字幕运动必须故障关闭而不是任意选择。Skip新增 schema 字段、场景角色、Token 选择器、工具栏控件、依赖、布局 pass、渲染器专属播放代码或独立 timer/owner。Skip被动 embed 中的运动、无play1的页面加载运动、精确时刻链接、Still/减弱运动/隐藏/打印/导出状态、移动端专属行为。Skip无限循环、多边同步载体、随机路径选择、标签文本推断、相机/背景/节点运动、canonical SVG 残留。六、提议契约九条边界逐条落地到源码决策文档提出 9 条契约当前 template.html 中大部分已可直接对应到实现共享辅助函数把 Token 分类与几何抽成一个共享运行时 helper。Relationship Preview 与 Story 播放调用同一个 helper不复制五个 Token 分支。→ 源码中的relationshipTokenKind()/relationshipTokenGeometry()与Archify.flowTokens导出第 8042-8046 行正是这条契约的实现。每个data-edge-key一条语义记录保留第一条真实可绘制 route 及其作者方向、wrapper transform、可选关系 ID、标签与类型证据context label group 只是该记录的注解不是额外关系。→ 实现为uniqueStoryEdges()第 9686-9700 行它用storyEdgeKey()建立去重表且当已有记录没有可绘制几何、而新元素有几何时用新元素替换!storyGeometry(unique[index]).length storyGeometry(edge).length。Story Beat 只有去重结果恰好包含一条 forward 或一条 reverse 作者关系时才可携带载体。→pulseStoryStep()第一行闸门step.relation ! forward step.relation ! reverse || step.edges.length ! 1时直接返回 false第 9919 行。Token 永远沿关系的作者 source→target 方向行进故事顺序若反向访问端点仍使用 reverse-caption 契约但不得在视觉上反转作者流量。→ 方向分类在storyStep()中按data-edge-from/data-edge-to判定caption 方向文案另有storyCaptionRouteCopy()。启动一个合格 Beat 至多添加一个位于节点与标签之下的 story-only 载体使用既有 780 ms 有限脉冲与当前 owner generation不创建独立 claim/interval/无限动画。→pulseStoryStep()调用Archify.flowTokens.create(edge, shapes[0], { className: story-flow-token, duration: 0.78s })并把animateMotion的dur设为 0.78srelationshipTokenGeometry第 8023 行载体包在data-story-carrier-overlay分组中插入到首个[data-node-id]之前即节点/标签之下。普通完整产物在 Live 下允许载体embed 仅在data-embedtrue且data-share-playbacktrue即显式?embed1play1契约时允许被动 embed 与精确时刻链接保持静态。→storyMotionAllowed()第 9885-9892 行逐条实现data-motion ! live拒绝、data-embed true且无data-share-playback拒绝、打印态拒绝、motion governor 暂停拒绝。Beat 替换、暂停、Stop/Still、减弱运动、文档隐藏、手动导航、打印、导出、章节切换、播放完成都要同步移除载体过期的animationend回调不能清掉或释放更新的 Story owner。→clearStoryPulse()通过storyPulseGeneration代际计数 storyPulseOwnerTokenowner token 实现第 9901-9915 行animationend回调只在本代pulseGeneration storyPulseGeneration时才清理第 9954-9956 行。静态含义永不依赖 TokenStory Trail、beat caption、活动节点、路线方向文案与 settled 边强调在无运动时保持完整。→ 所有 caption 生成storyBeatCopy/storyBeatAria/storyCaptionRouteCopy与载体解耦可独立运行。不新增移动端专属产品工作窄布局只继承同一套静态回退桌面呈现与文档 embed 是目标面。七、风险与缓解把想当然逐条堵死风险缓解标签组被计为第二条关系按稳定data-edge-key去重在五种渲染器上测试带标签与不带标签的边。两条真实平行边共享端点保留不同 key 并把 Beat 分类为multiple不展示任意载体。反向故事顺序歪曲数据方向只沿作者 source→target 几何动画并保留显式反向文案。载体比 Beat 活得更久、或清掉更新的 Beat把 overlay 清理绑定到 Story generation/owner token并拒绝过期回调。README embed 变成环境动画只允许既有的显式play1请求被动 embed、时刻链接、Still、减弱运动保持静态。Token 与通用 trail 视觉竞争只一个 Token、780 ms、位于节点/标签之下不增加虚线流或辉光族。运行时装饰泄漏进导出在 canonical SVG/位图序列化与打印前同步剥离 story-carrier overlay 与运行时属性。八、验收标准可验证的十一项决策文档给出 11 条验收标准其中若干条已由 story-carrier.test.mjs 直接验证第 36-45 行测试确认五种渲染器都继承同一份 viewer-only carrier、产物 canonical SVG 中无story-flow-token/story-carrier-token/semantic-flow-token残留五种类型化渲染器通过共享模板继承同一套 Story Carrier 实现无渲染器私增播放分支含一条带标签关系的 fixture 产生两个语义 DOM 片段但解析为一个 Story 关系键、一个 forward/reverse Beat、至多一个 Token两条真正不同的平行关系键保持multiple且不产生载体call/data/event/security/state Beat 使用与 Relationship Preview 完全相同的确定性分类优先级与 SVG 形状覆盖path/line/polyline路线、wrapper transform、弯曲路线、垂直路线与作者反向Token 只在 Beat 有意推进或作为显式播放的一部分被激活时才开始hover、focus、URL 恢复、钉住的时刻都不重启它单个 Token 有限780 ms、位于节点/标签之下并在动画结束、暂停、替换、章节切换、完成、文档隐藏、Still、减弱运动、打印、导出后消失?embed1play1可见地推进 Story Carrier?embed1与#view...beat...保持静态分享播放中切到 Still 移除 Token 且不改变真实的活动 Beatcanonical SVG 与位图/导出快照不含载体元素、animateMotion、Story owner 残留、运行时 Token kind 或运行时 edge key浏览器验证至少覆盖Workflow Signal Flow 深色带标签的 call/security Beat、Architecture 或 Data Flow弯曲/垂直路线上的 data/event 载体、Lifecyclestate 载体、Blueprint 浅色无辉光锐利 Token、显式 README/Gallery 分享 embed 与被动 embed 及 Still 切换、零 console 错误与每次有限 pass 后零运行时 overlay聚焦的 Story/relationship/motion/export 测试、全部 11 个 Gallery 产物、composition 检查、完整npm test与git diff --check保持绿色。九、为什么这不是重复范围决策文档专门澄清了与历史轮次的关系Round 13 添加了Story Trail用通用路线 overlay 解释有序拓扑并不分类 Beat 上流动的载荷Rounds 16、37、38、39、41 添加了 beat 顺序、相机跟随、导演文案、未来上下文与 settled 交接都不复用关系类型载体Round 48 的Semantic Flow Tokens 只存在于直接 Relationship Preview其自身 embed 防护阻止它们进入主要 story/share 证明路径Round 49 不新增任何作者事实、阅读模式、控件、面板、相机规则或 motion owner它修复关系身份并让两个已上线的系统共享同一套精确语义视觉词表。十、结论与推荐以Semantic Story Carrier作为 Round 49 推进先通过把 DOM 片段去重为稳定关系键让 Story Beat 边身份回归真实再复用而非克隆Round 48 的 Token 构建器放进既有有限 Story owner仅在完整桌面产物与已显式的?embed1play1分享契约中允许载体。这是一个实现面很小、产品效果超比例的切片——图表的形式化 Story、README 证明与直接探索终于讲同一种视觉语言。读者可在 template.html 的relationshipTokenKind、uniqueStoryEdges、pulseStoryStep、storyMotionAllowed四处对照本文的契约逐条验证并以 story-carrier.test.mjs 为入口运行聚焦测试复现全部断言。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考