ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

缓存 miss 的 12 步分解:Archify 时序图实操

缓存 miss 的 12 步分解:Archify 时序图实操 缓存 miss 的 12 步分解Archify 时序图实操【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archifyArchify是面向 AI Agent 的图表技能把系统描述转成五种可校验的交互图时序图sequence diagram是其一。本文的产出物是一张还原缓存缺失场景的单文件可分发交互页面7 个参与者、12 条消息、3 个阶段切分。读完后你能在自己的项目里跑通 validate 到 deliver 的完整链路。先看成品Cache Miss Request Sequence时间从上往下流动7 个参与者横排铺开User、Web App、API、Auth、Redis、Postgres、Trace。12 条消息箭头贯穿整条 API 调用链3 个背景分段Request / Fallback / Response trace把时间线切成三个阶段。Postgres 列上的激活条不到一行高回源窗口极短set cache与emit trace两条紫色虚线是异步旁路。图例把消息风格分成五类emphasis主路径、return返回、security鉴权、dashed异步、default其余。这张图回答的问题只有一个缓存缺失的那次请求延迟花在哪一跳可观测性写入是否拖累了主路径。不画这张图你会漏掉什么日志只有首尾时间戳300ms 花在哪一跳看不出来缓存命中还是缺失从单条日志里很难判断异步埋点和主路径调用混在一起阻塞代价的边界模糊。archify/SKILL.md 的路由表把sequence分给 API 调用链、请求生命周期、异步追踪与返回流——正是谁在什么时候调用了谁这类问题。两条命令跑起来全局安装npx skills add tt-a1i/archify -g适配 Cursor、Claude Code、Codex CLI、OpenCode 四类 Agent 环境不想安装可先单次试用npx skills use tt-a1i/archifyarchify --agent codex不确定该用哪种图让内置指南推荐node archify/bin/archify.mjs guide 展示带 Redis 缓存未命中的 API 请求 --json --lang zhcache-miss-request.sequence.json 里 4 个字段撑起整条链源文件 81 行骨架就是 4 块字段作用真实示例最小值participants7 个参与者各带语义 type 与标签{ id: redis, type: database, label: Redis }messages箭头端点、y 坐标与风格{ id: cache-miss, from: redis, to: api, label: miss, variant: return }segmentsfrom/to为 y 像素区间划分三阶段{ from: 315, to: 505, label: Fallback }activations参与者的忙碌窗口{ participant: db, from: 438, to: 496 }两个可选配置值得开meta.views最多 5 个命名章节本例配了 3 章Request and identity、Cache fallback、Return and tracemeta.animation: trace让箭头按调用顺序逐段点亮。完整字段约束在 archify/schemas/sequence.schema.json。从语义到像素5 步编译管线你用自然语言或 Mermaid 描述系统Agent 推断空间关系落成带类型的Typed JSON IR内置 Validator 按sequence.schema.json逐字段核对规格类型化渲染器执行布局规则消息间距小于 28px、箭头越界这类问题直接报错输出单文件可分发的交互页面支持动画与多倍率导出。validate分两种用法探索期在每次候选编辑后跑一遍快速定位问题交付期做终检showcase级别要求 0 错误 0 警告。deliver更彻底把规格字节冻结成同目录快照渲染并检查那份快照全部门禁通过才原子替换目标 HTML回执里附规格与产物各自的SHA-256和字节数。你发给同事的那个 HTML 能与仓库里的 JSON 字节级对上回执就是证据。第一条命令在仓库根目录执行后两条在archify/目录下node archify/renderers/sequence/render-sequence.mjs cache-miss-request.sequence.json out.html # 渲染 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 out.html # 原子交付打开 HTML这不是静态图分章播放顶部 3 个章节按钮逐章聚焦相关参与者每章带独立说明按下Play story整条调用链自动播放箭头按调用顺序点亮。路由追踪选中 Web App 到 Postgres 的路径面板显示 3 nodes · 2 directed hops · shortest authored route可一键复制深链也能导出 1200×630 的路由分享卡。主题与导出右上角 Dark/Live 切换深浅色Export 菜单支持 PNG 复制到剪贴板、下载静态图、带运动格式的 WebM 以及社交分享卡。换成你的系统4 步出图列出这条请求链的参与者网关、鉴权、缓存、主库语义type各归其位。注意参与者要按读者跟读故事的顺序横排。按时间顺序写消息主路径emphasis、返回return、鉴权security、旁路埋点dashed。注意消息垂直间距需 ≥28px否则布局检查直接报错。用segments把时间线切成 2–3 段给关键服务加激活条。注意from/to是 y 像素坐标不是参与者 id。跑validate→deliver再验证桌面分辨率不溢出node bin/archify.mjs visual-check out.html --json覆盖 1440×900 到 2048×1320 四档视口。字段约定详见 authoring-contract.md 与 authoring-cookbook.zh-CN.md。路径速查资源路径缓存缺失示例源文件archify/examples/cache-miss-request.sequence.json渲染成品 HTMLexamples/sequence-cache-miss-request.html时序图 Schemaarchify/schemas/sequence.schema.json时序渲染器文档archify/renderers/sequence/README.md技能总入口archify/SKILL.md7 个参与者、12 条消息、81 行 JSON。Archify 只接住画得正确、交付可核验这两件难事你只需要把业务讲清楚。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表