ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

4 个问题上手 Archify:把一次缓存缺失的 API 调用链变成可校验时序图

4 个问题上手 Archify:把一次缓存缺失的 API 调用链变成可校验时序图 4 个问题上手 Archify把一次缓存缺失的 API 调用链变成可校验时序图【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archifyArchify 是一个给 AI 编程助手用的 Agent 技能你用自然语言描述系统它就把代码库或系统描述编译成架构图、时序图、数据流图、工作流图、生命周期图五种交互式成品输出单文件 HTML打开即用、可导出可分享。读完本文你会知道它装起来有多快、一张时序图到底怎么描述、又如何保证画得对还画得漂亮。它画的是什么样的图5 种类型各管一类场景很多人以为画系统图就是画框和箭头但不同问题适合不同的图。Archify 把类型路由得很明确你描述的场景决定用哪种类型适合回答的问题architecture谁和谁相连组件、服务、边界怎么分布sequence谁在什么时候调用了谁API 调用链、请求生命周期、异步追踪workflow流程怎么走审批、CI/CD、工具调用的顺序和分支dataflow数据怎么流动管线、血缘、PII 边界lifecycle状态怎么迁移重试、等待、终态这里以 sequence时序图为主角因为这次请求为什么慢这种问题架构图答不了时序图可以。仓库里的 cache-miss-request.sequence.json 是个教科书级例子7 个参与者User → Web App → API → Auth → Redis → Postgres → Trace时间从上往下流12 条消息把一次缓存缺失 → 回源数据库 → 返回的完整调用链讲清楚一行命令装好技能2 分钟就能开工 Archify 是 Node.js 渲染与校验系统适配 Cursor、Claude Code、Codex CLI 和 OpenCode。全局安装就一行npx skills add tt-a1i/archify -g装完直接对 Agent 说人话比如用 archify 追踪这个 API 请求包含缓存缺失场景它负责写出图的数据描述并跑通渲染校验。不确定该选哪种图时内置的场景指南零依赖、随问随答还会返回推荐类型和配方node archify/bin/archify.mjs guide 展示带 Redis 缓存未命中的 API 请求 --json不想安装也可以先试一次npx skills use tt-a1i/archifyarchify --agent codex。一张时序图怎么描述4 个 JSON 字段讲完整条链图的源文件是一份带类型的 JSONSchema 在 sequence.schema.json骨架只有四块你只描述业务坐标细节交给渲染器participants参与者。每项有id、语义typefrontend/backend/database/security等和标签如redis是database类型、子标签cachemessages消息箭头。写from、to、垂直坐标y和风格variant缓存缺失那条就是redis → api、标签misssegments背景分段用 y 像素区间把时间线切成 Request / Fallback / Response 三幕图读起来有节奏activations激活条——参与者忙碌时段在图上的影子。图里 Postgres 只有一小段一眼看出回源窗口很短。消息风格是这套图约定里的语法图例会自动生成variant用途示例emphasis主请求路径强调色GET /dashboardreturn安静的返回消息miss、200 JSONsecurity鉴权、权限类调用verify JWTdashed异步/非阻塞旁路set cache、emit tracedefault普通调用read cache主路径用强调色、鉴权单独着色、埋点绝不抢戏于是用户感知延迟和可观测性开销在图上自然分开。想要分章讲解还可以在meta.views配最多 5 个命名章节这个例子配了 3 章并开启meta.animation: trace让箭头按调用顺序逐段点亮。怎么确保画得对校验不通过就拒绝渲染 ✅这是 Archify 和画完再说的工具最大的区别渲染前先按 schema 严格校验再做布局检查——参与者放不下、消息间距过密、箭头越界都会直接报错而不是画出一张坏图。流程是从语义到像素的确定性编译node archify/bin/archify.mjs validate sequence cache-miss-request.sequence.json --quality showcase --json node archify/bin/archify.mjs deliver sequence cache-miss-request.sequence.json output.html node archify/bin/archify.mjs visual-check output.html --jsonvalidate是探索期的逐次检查deliver是交付期终检——它把 JSON 字节级冻结成快照再渲染HTML 附带 SHA-256 回执你分享的文件和它背后的 JSON 严格对得上。showcase 级别要求 0 错误 0 警告。最后visual-check会在 1440×900 到 2048×1320 多档桌面分辨率下确认不溢出交付前多一道保险。画得漂亮、还能直接分享HTML 打开就是交互成品用浏览器打开渲染好的 HTML它不是一张静态图分章讲解顶部章节按钮逐章聚焦相关参与者Play story自动播放整条调用链路由追踪选中 Web App 到 Postgres 的路径面板显示节点数与有向跳数还能一键导出 1200×630 的路由分享卡片主题与导出一键切换深浅色Export 菜单可复制 PNG、下载静态图、WebM 动效或社交分享卡。动手画你自己的项目 API 链换掉示例、换成你的系统思路不变列参与者并给语义类型、按时间顺序写消息并选对 variant、用 2–3 个 segment 切时间线、给关键服务加激活条然后validate→deliver→visual-check三连。更多字段约定见 agent 编图手册 和 Skill 总入口。一条缓存缺失的调用链不到 100 行 JSON 就能表达清楚。画得好看、画得正确这两件难事 Archify 兜底你只需要讲清楚业务本身。资源相对路径缓存缺失时序图源文件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.md【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表