Archify生命周期图解实战状态机、重试、等待与终态的画法【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archifyArchify 是一款开源 Agent Skill能把 JSON 语义模型变成可交互、可导出的自包含 HTML 图表其中**生命周期图lifecycle diagram**专门用来表达状态机主流程阶段、重试回路、等待状态与终态出口。本文以项目自带的 Agent 运行示例为主线手把手讲清状态机、重试、等待与终态的画法最后用一条命令渲染出支持主题切换和 4 倍高清导出的 HTML。 为什么状态机需要专门的“生命周期图”Archify 内置 5 类图架构图、工作流、时序图、数据流图和生命周期图。按 authoring-cookbook.md 的划分lifecycle 的定位是“States, retries, waits, and terminal outcomes”——状态、重试、等待与终态。架构图回答“系统长什么样”工作流图回答“事情按什么顺序做”生命周期图回答“对象现在处于哪个状态、还能去哪儿”一个 Agent 的“排队 → 规划 → 执行 → 审查 → 完成”加上“需要审批”“失败重试”“已取消/超时”就是一台典型状态机正是 lifecycle 的主场。 搭好骨架三条泳道 状态 迁移lifecycle 输入就是一个 JSON 文件四要素lanes泳道、states状态、transitions迁移、cards摘要卡片可选。泳道lanes是理解整张图的钥匙lanes: [ { id: main, label: Lifecycle phases }, { id: waiting, label: Interruptions }, { id: exceptions, label: Recovery loop }, { id: terminal, label: Terminal exits } ]main泳道必填映射到顶部的阶段带承载主生命周期轨道terminal泳道映射到底部的终态带其余泳道共享中间事件带放中断与恢复逻辑状态states只需声明类型和位置{ id: executing, type: active, label: Executing, sublabel: tool calls, lane: main, col: 2, step: 03 }迁移transitions只写from/to其余交给自动路由。最小骨架长这样 八种状态类型选对类型图就成功了一半states[].type支持 8 种定义见 lifecycle.schema.json官方推荐用法类型用途start入口状态active正在执行的工作状态waiting暂停、等待外部输入decision质量门禁、审批检查点success成功完成failure失败与终态出口neutral/external中性状态 / 外部依赖图例Legend会从这些类型自动派生不需要手工维护。 重试回路让 Failed 回到 Executing重试的关键是回环迁移不破坏主轨道。官方示例 agent-run.lifecycle.json 中Failed在事件带回指Executing时用variant: emphasis加粗并用via显式绕出左侧通道{ id: failed-retry, from: failed, to: executing, variant: emphasis, fromSide: left, toSide: top, via: [[20, 385], [20, 80], [402, 80]] }设计规则要求避免斜线和交叉线多段迁移会自动加圆角cornerRadius可调。⏸️ 等待状态暂停 ≠ 结束“需要审批”“等待用户输入”这类状态放中间事件带类型用waiting。要点等待状态不指向终态带运行只是暂停而非结束。例如Executing → Needs Approval用route: straight垂直落下语义一目了然。 终态画法垂直落下绝不回头终态Cancelled、Expired、Failed耗尽重试预算等统一放terminal泳道设计规则很明确终态出口尽量从来源状态垂直落下且终态不再指回活跃执行。这样读图的人一眼就能分清“还能继续”和“到此为止”。⚡ 一条命令渲染自包含 HTML 4x 高清导出node archify/renderers/lifecycle/render-lifecycle.mjs input.lifecycle.json output.html渲染器render-lifecycle.mjs零依赖会先做 Schema 校验再做布局体检泳道缺失、状态重叠、标签碰撞、过短迁移、无关交叉都会直接报错——图错不过夜渲染前先自检。加上quality_profile: showcase可启用交付级严格检查animation: trace让箭头沿路径流动。打开生成的 HTML 还能一键导出 PNG / WebP / SVG / WebM最高 4 倍分辨率。 关键文件速查文件说明lifecycle.schema.json生命周期图 JSON Schema8 种状态类型、泳道与迁移约束agent-run.lifecycle.json官方示例Agent 运行状态机含重试回路与三个终态deployment-release.lifecycle.json部署发布生命周期审批门禁、回滚与健康检查暂停render-lifecycle.mjs生命周期渲染器一条命令产出自包含 HTMLrenderers/lifecycle/README.md泳道布局预算、图例契约与设计规则authoring-cookbook.md五类图表的选型与编写指南小结生命周期图的核心心法就四条——主流程走main轨道、重试回路显式绕道、等待状态不终结、终态垂直落下不回头。把状态机写进 JSONArchify 负责校验、排版与导出你只管讲清“对象的一生”。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考