Archify 时序图实战完整追踪一次缓存缺失的 API 调用链【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify用 cache-miss-request.sequence.json 描述请求Archify 渲染出的缓存缺失时序图不是一张静态图箭头可按调用顺序逐段回放任意路径可点选追踪还能导出高清图片。它面向 AI Agent 工作把系统描述编译成五种可验证的交互式图表并输出自带动画的自包含 HTML。这张时序图能回答什么问题线上偶发慢请求日志只告诉你慢告诉不了你慢在哪一跳。时序图把时间轴摊开谁先调用谁、哪一段是同步阻塞、哪一段只是异步旁路全部落在一张图上。仓库自带的示例覆盖了这条链路上的七个参与者User、Web App、API、Auth、Redis、Postgres、Trace时间自上而下流动被三个segments切成三幕Request用户打开页面Web App 发出GET /dashboardAPI 向 Auth 完成verify JWTFallbackAPI 读缓存收到miss回源 Postgres 执行query profile metricsResponse trace写回缓存、异步emit trace200 JSON沿原路返回。读图时有三个视觉线索值得注意。激活条activations标出每个参与者的忙碌区间Postgres 的激活条只有一小段回源窗口很短一眼可见主请求路径用emphasis强调色返回消息用低饱和的returnset cache与emit trace是紫色虚线的dashed旁路——用户感知的延迟与可观测性开销在图上被刻意分开。Archify 快速上手与安装安装只需一行npx skills add tt-a1i/archify -g不想装依赖可以先跑一次npx skills use tt-a1i/archifyarchify --agent codex。之后对 Agent 提出需求例如用 archify 把这次 API 请求画成时序图场景是缓存缺失。拿不准该用哪种图时用内置场景指南问一句它返回推荐类型和参考配方node bin/archify.mjs guide 展示带 Redis 缓存未命中的 API 请求 --json --lang zh配方仅供参考图仍然要按自己的系统重新描述而不是套模板。调用链怎么写时序图的 JSON 描述源文件是一份带类型的 JSON IR完整约束在 sequence.schema.json 里。按参与者 → 消息 → 分段的顺序理解participants定义横轴上每个参与者的id、语义typefrontend、backend、database、security、messagebus等和标签{ id: redis, type: database, label: Redis, sublabel: cache }messages是时间轴的主体每条消息给出from、to、垂直坐标y和variant。五种风格对应图例五类——emphasis主路径、return返回消息、security鉴权类调用、dashed异步非阻塞、default普通消息。缓存缺失那条箭头就是{ id: cache-miss, from: redis, to: api, label: miss, variant: return }。segments用 y 像素区间把时间线切成 Request / Fallback / Response 三段背景activations给忙碌参与者加激活条。长链还可以在meta.views里配置最多 5 个命名章节并设meta.animation: trace让箭头按调用顺序点亮。如何保证图不出错校验与交付Archify 的管线是从语义到像素的确定性编译Agent 推断空间关系生成 JSON IRschema校验把关字段合法性layout规则把关排版。渲染器 render-sequence.mjs 内置独立校验器无需装依赖参与者放不下画布、消息间距过密、箭头越界这类问题都会直接报错退出而不是画出一张看起来还行的坏图。校验分探索期和交付期交付期用deliver把规格文件冻结成快照输出的 HTML 附带 SHA-256 回执你分享出去的文件与背后的 JSON 一一对应node bin/archify.mjs validate sequence cache-miss-request.sequence.json --quality showcase --json node bin/archify.mjs deliver sequence cache-miss-request.sequence.json examples/sequence-cache-miss-request.html--quality showcase是交付级门禁0 错误 0 警告才放行。图打开之后分章播放与路由追踪分章讲解Guided views示例配了 3 个章节顶部按钮逐章聚焦相关参与者Play story自动播放整条调用链。路由追踪Route probe选中 Web App 到 Postgres 的路径面板显示 3 nodes · 2 directed hops · shortest authored route可复制深链或导出 1200×630 路由分享卡。主题与导出右上角切换 Dark/LiveExport 菜单支持复制 PNG、下载静态图、带运动的 WebM 和社交分享卡。给自己的项目画一张调用链☐ 列出这条请求链的参与者语义type各归其位网关、鉴权、缓存、主库☐ 按时间顺序写messages主路径emphasis返回return鉴权security旁路埋点dashed☐ 用 2–3 个segments切分时间线给关键服务补activations☐ 跑校验闭环validate --quality showcase→deliver冻结交付 →node bin/archify.mjs visual-check output.html --json在 1440×900 到 2048×1320 多档桌面分辨率下确认不溢出☐ 仍有排版疑虑时对照 authoring-contract 修正措辞与坐标或按 authoring-cookbook 的中文字段说明逐项核对。什么时候该选时序图时序图回答的是这次请求时间上发生了什么排查慢请求、梳理调用链、解释一次缓存回源选它。若关心的是组件间的静态结构关系架构图更合适关心对象在阶段间如何流转生命周期图更对路。SKILL.md 里的路由表会帮你做这个判断——你负责把业务讲清楚校验和排版交给 Archify。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Archify 时序图实战完整追踪一次缓存缺失的 API 调用链【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify用 cache-miss-request.sequence.json 描述请求Archify 渲染出的缓存缺失时序图不是一张静态图箭头可按调用顺序逐段回放任意路径可点选追踪还能导出高清图片。它面向 AI Agent 工作把系统描述编译成五种可验证的交互式图表并输出自带动画的自包含 HTML。这张时序图能回答什么问题线上偶发慢请求日志只告诉你慢告诉不了你慢在哪一跳。时序图把时间轴摊开谁先调用谁、哪一段是同步阻塞、哪一段只是异步旁路全部落在一张图上。仓库自带的示例覆盖了这条链路上的七个参与者User、Web App、API、Auth、Redis、Postgres、Trace时间自上而下流动被三个segments切成三幕Request用户打开页面Web App 发出GET /dashboardAPI 向 Auth 完成verify JWTFallbackAPI 读缓存收到miss回源 Postgres 执行query profile metricsResponse trace写回缓存、异步emit trace200 JSON沿原路返回。读图时有三个视觉线索值得注意。激活条activations标出每个参与者的忙碌区间Postgres 的激活条只有一小段回源窗口很短一眼可见主请求路径用emphasis强调色返回消息用低饱和的returnset cache与emit trace是紫色虚线的dashed旁路——用户感知的延迟与可观测性开销在图上被刻意分开。Archify 快速上手与安装安装只需一行npx skills add tt-a1i/archify -g不想装依赖可以先跑一次npx skills use tt-a1i/archifyarchify --agent codex。之后对 Agent 提出需求例如用 archify 把这次 API 请求画成时序图场景是缓存缺失。拿不准该用哪种图时用内置场景指南问一句它返回推荐类型和参考配方node bin/archify.mjs guide 展示带 Redis 缓存未命中的 API 请求 --json --lang zh配方仅供参考图仍然要按自己的系统重新描述而不是套模板。调用链怎么写时序图的 JSON 描述源文件是一份带类型的 JSON IR完整约束在 sequence.schema.json 里。按参与者 → 消息 → 分段的顺序理解participants定义横轴上每个参与者的id、语义typefrontend、backend、database、security、messagebus等和标签{ id: redis, type: database, label: Redis, sublabel: cache }messages是时间轴的主体每条消息给出from、to、垂直坐标y和variant。五种风格对应图例五类——emphasis主路径、return返回消息、security鉴权类调用、dashed异步非阻塞、default普通消息。缓存缺失那条箭头就是{ id: cache-miss, from: redis, to: api, label: miss, variant: return }。segments用 y 像素区间把时间线切成 Request / Fallback / Response 三段背景activations给忙碌参与者加激活条。长链还可以在meta.views里配置最多 5 个命名章节并设meta.animation: trace让箭头按调用顺序点亮。如何保证图不出错校验与交付Archify 的管线是从语义到像素的确定性编译Agent 推断空间关系生成 JSON IRschema校验把关字段合法性layout规则把关排版。渲染器 render-sequence.mjs 内置独立校验器无需装依赖参与者放不下画布、消息间距过密、箭头越界这类问题都会直接报错退出而不是画出一张看起来还行的坏图。校验分探索期和交付期交付期用deliver把规格文件冻结成快照输出的 HTML 附带 SHA-256 回执你分享出去的文件与背后的 JSON 一一对应node bin/archify.mjs validate sequence cache-miss-request.sequence.json --quality showcase --json node bin/archify.mjs deliver sequence cache-miss-request.sequence.json examples/sequence-cache-miss-request.html--quality showcase是交付级门禁0 错误 0 警告才放行。图打开之后分章播放与路由追踪分章讲解Guided views示例配了 3 个章节顶部按钮逐章聚焦相关参与者Play story自动播放整条调用链。路由追踪Route probe选中 Web App 到 Postgres 的路径面板显示 3 nodes · 2 directed hops · shortest authored route可复制深链或导出 1200×630 路由分享卡。主题与导出右上角切换 Dark/LiveExport 菜单支持复制 PNG、下载静态图、带运动的 WebM 和社交分享卡。给自己的项目画一张调用链☐ 列出这条请求链的参与者语义type各归其位网关、鉴权、缓存、主库☐ 按时间顺序写messages主路径emphasis返回return鉴权security旁路埋点dashed☐ 用 2–3 个segments切分时间线给关键服务补activations☐ 跑校验闭环validate --quality showcase→deliver冻结交付 →node bin/archify.mjs visual-check output.html --json在 1440×900 到 2048×1320 多档桌面分辨率下确认不溢出☐ 仍有排版疑虑时对照 authoring-contract 修正措辞与坐标或按 authoring-cookbook 的中文字段说明逐项核对。什么时候该选时序图时序图回答的是这次请求时间上发生了什么排查慢请求、梳理调用链、解释一次缓存回源选它。若关心的是组件间的静态结构关系架构图更合适关心对象在阶段间如何流转生命周期图更对路。SKILL.md 里的路由表会帮你做这个判断——你负责把业务讲清楚校验和排版交给 Archify。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
