深入Archify黄金基线v1兼容性与坐标稳定策略的完整设计【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archifyArchify 是一个开源的架构图表渲染系统Agent 只需产出带类型的 JSON 中间表示它就能确定性地编译出自包含 HTML/SVG 架构图、工作流图、时序图、数据流图和生命周期图。本文带你深入 Archify 的黄金基线测试体系看懂它如何用 v1 兼容性策略与坐标稳定算法保证同样的输入永远得到同样的图。黄金基线确定性渲染的底线承诺为什么一张图需要黄金基线因为 Archify 的消费者是 AI Agent——如果每次渲染结果都略有漂移Agent 将无法信任输出更无法迭代修正。Archify 的答案是渲染器必须是完全确定性的。在 golden.mjs 中定义了一套黄金文件golden file机制取 5 种图表类型的官方示例 JSON 源文件如 web-app.architecture.json现场重新渲染一遍生成全新 HTML将新产物与仓库中已提交的示例 HTML逐字节比对仅归一化换行符差异只要有一个字节不同测试就失败并提示若变更是有意为之请重新渲染示例并提交。这把视觉回归从人眼比对变成了机器契约。v1兼容策略旧版图 JSON 照样渲染、照样校验项目从 schema v1 演进到 v2最大的风险是用户手里已有的旧版图数据不能作废。Archify 在 v1-compatibility.test.mjs 中为此立下了明确的兼容性契约五类官方 v1 基线逐一走查架构、工作流、时序、数据流、生命周期五份schema_version: 1的基线文档保存在 test/fixtures/v1-baseline/ 目录测试逐一断言它们渲染成功 校验通过 产物非空不强制升级基线文档不带quality_profile字段也必须能渲染v1 输入走的是宽松但不失效的降级路径手绘坐标保持权威以 agent-run.lifecycle.json 为例测试断言了作者手绘的via折点如[[480,336],[480,432],[402,432]]必须原样出现在产物 SVG 的data-composition-points中——作者写的坐标永远是事实来源窄画布与图例的优雅降级一个容易被忽略的细节是显式viewBox的兼容。v1 文档常带非常窄的画布比如 320×800此时自动图例放不下。Archify 的策略是 v1-compatibility.test.mjs 锁定的永不硬失败——放得下图例就保留放不下就静默降级但节点拓扑一个都不能少测试精确断言每种类型的节点数量。而 auto viewBox 场景下画布又会自动加宽到容纳最宽图例项L115-L145。宽进严出失败时降级而非报错——这是 v1 兼容策略的核心哲学。坐标稳定策略分段线性映射保住手绘路径v2 的核心改进是更智能的列宽rank布局但这会移动节点 X 坐标。节点挪了作者手绘的连线via折点就会悬空。Archify 的解法在 workflow-migration-geometry.mjs 中分三步内在投影intrinsicWorkflow临时剥离显式viewBox让编译器先算出 v2 下的自然列中心规划投影planningWorkflow剔除尚未合法化的路由几何只保留影响排布的关系边避免未映射的旧坐标干扰新布局分段线性映射createHorizontalRankMapper在旧列中心 → 新列中心之间构建确定性的分段线性函数把每个旧 X 坐标按所在区间的比例精确重映射超出列跨度的坐标用最近区间外推保留相对偏移量效果是节点按新布局整体舒展后手绘路径跟着等比例平移不崩、不乱、不悬空。配合 workflow-migration.test.mjs 与 workflow-compiler.test.mjs 的回归锁定坐标迁移成为可验证的工程行为而非玄学。黄金文件比对与布局规则两层防线黄金基线并不只靠逐字节比对一层。Archify 的测试分为两个互补的层面防线锁住什么代表文件黄金文件比对整体产物逐字节一致防任意漂移golden.mjs布局规则单测每条手写校验规则单独触发、报出可修复的提示layout-rules.test.mjs布局规则层尤其用心它把合法示例恰好变异成一处违规断言渲染器以非零码退出且错误信息必须同时包含数值阈值与修复建议——因为最终读这段话修 JSON 的是一位 LLM报错文案本身就是一种 API 契约见 schemas/workflow.schema.json 配套的校验器。三步验证清单确认你的改动没让基线漂移在本地贡献或调试时可以按这个最小清单自检跑黄金测试在archify目录执行npm test确认fresh render 与已提交示例一致全绿跑 v1 回归node --test test/v1-compatibility.test.mjs确认五类旧版文档仍可渲染与校验目检产物打开 examples/web-app.html 等已渲染产物核对主题、图例、导出菜单等交互无异常黄金基线不是一次通过的测试而是每次改动都被强制对账的纪律。它让 AI Agent 生成的每一张架构图都可复现、可对比、可信任——这正是 Archify 能从画得好看走到画得可信的关键一步。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 深入Archify黄金基线：v1兼容性与坐标稳定策略的完整设计
深入Archify黄金基线v1兼容性与坐标稳定策略的完整设计【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archifyArchify 是一个开源的架构图表渲染系统Agent 只需产出带类型的 JSON 中间表示它就能确定性地编译出自包含 HTML/SVG 架构图、工作流图、时序图、数据流图和生命周期图。本文带你深入 Archify 的黄金基线测试体系看懂它如何用 v1 兼容性策略与坐标稳定算法保证同样的输入永远得到同样的图。黄金基线确定性渲染的底线承诺为什么一张图需要黄金基线因为 Archify 的消费者是 AI Agent——如果每次渲染结果都略有漂移Agent 将无法信任输出更无法迭代修正。Archify 的答案是渲染器必须是完全确定性的。在 golden.mjs 中定义了一套黄金文件golden file机制取 5 种图表类型的官方示例 JSON 源文件如 web-app.architecture.json现场重新渲染一遍生成全新 HTML将新产物与仓库中已提交的示例 HTML逐字节比对仅归一化换行符差异只要有一个字节不同测试就失败并提示若变更是有意为之请重新渲染示例并提交。这把视觉回归从人眼比对变成了机器契约。v1兼容策略旧版图 JSON 照样渲染、照样校验项目从 schema v1 演进到 v2最大的风险是用户手里已有的旧版图数据不能作废。Archify 在 v1-compatibility.test.mjs 中为此立下了明确的兼容性契约五类官方 v1 基线逐一走查架构、工作流、时序、数据流、生命周期五份schema_version: 1的基线文档保存在 test/fixtures/v1-baseline/ 目录测试逐一断言它们渲染成功 校验通过 产物非空不强制升级基线文档不带quality_profile字段也必须能渲染v1 输入走的是宽松但不失效的降级路径手绘坐标保持权威以 agent-run.lifecycle.json 为例测试断言了作者手绘的via折点如[[480,336],[480,432],[402,432]]必须原样出现在产物 SVG 的data-composition-points中——作者写的坐标永远是事实来源窄画布与图例的优雅降级一个容易被忽略的细节是显式viewBox的兼容。v1 文档常带非常窄的画布比如 320×800此时自动图例放不下。Archify 的策略是 v1-compatibility.test.mjs 锁定的永不硬失败——放得下图例就保留放不下就静默降级但节点拓扑一个都不能少测试精确断言每种类型的节点数量。而 auto viewBox 场景下画布又会自动加宽到容纳最宽图例项L115-L145。宽进严出失败时降级而非报错——这是 v1 兼容策略的核心哲学。坐标稳定策略分段线性映射保住手绘路径v2 的核心改进是更智能的列宽rank布局但这会移动节点 X 坐标。节点挪了作者手绘的连线via折点就会悬空。Archify 的解法在 workflow-migration-geometry.mjs 中分三步内在投影intrinsicWorkflow临时剥离显式viewBox让编译器先算出 v2 下的自然列中心规划投影planningWorkflow剔除尚未合法化的路由几何只保留影响排布的关系边避免未映射的旧坐标干扰新布局分段线性映射createHorizontalRankMapper在旧列中心 → 新列中心之间构建确定性的分段线性函数把每个旧 X 坐标按所在区间的比例精确重映射超出列跨度的坐标用最近区间外推保留相对偏移量效果是节点按新布局整体舒展后手绘路径跟着等比例平移不崩、不乱、不悬空。配合 workflow-migration.test.mjs 与 workflow-compiler.test.mjs 的回归锁定坐标迁移成为可验证的工程行为而非玄学。黄金文件比对与布局规则两层防线黄金基线并不只靠逐字节比对一层。Archify 的测试分为两个互补的层面防线锁住什么代表文件黄金文件比对整体产物逐字节一致防任意漂移golden.mjs布局规则单测每条手写校验规则单独触发、报出可修复的提示layout-rules.test.mjs布局规则层尤其用心它把合法示例恰好变异成一处违规断言渲染器以非零码退出且错误信息必须同时包含数值阈值与修复建议——因为最终读这段话修 JSON 的是一位 LLM报错文案本身就是一种 API 契约见 schemas/workflow.schema.json 配套的校验器。三步验证清单确认你的改动没让基线漂移在本地贡献或调试时可以按这个最小清单自检跑黄金测试在archify目录执行npm test确认fresh render 与已提交示例一致全绿跑 v1 回归node --test test/v1-compatibility.test.mjs确认五类旧版文档仍可渲染与校验目检产物打开 examples/web-app.html 等已渲染产物核对主题、图例、导出菜单等交互无异常黄金基线不是一次通过的测试而是每次改动都被强制对账的纪律。它让 AI Agent 生成的每一张架构图都可复现、可对比、可信任——这正是 Archify 能从画得好看走到画得可信的关键一步。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考