DSH插件测评:archify 把一段话变成能点的架构图

archify 是 tt-a1i 做的一个 DSH 插件，把一段描述、一份计划或一个代码库，转成可交互的架构、流程、时序、数据流、生命周期图。它替「要讲清一个系统」的人省掉手画：装它之前，你要么在 draw.io 里一张张摆框，要么让模型吐一段 Mermaid 再自己调。截至 2026-11-01，GitHub 92,363 颗星、npm 上周下载 15,148 次。

它的做法是把图拆成两份产物：一份类型化 spec，一个自包含 HTML。

技术负责人或独立开发者。判断该画什么之前，先在会话里点名：让它把这仓库的运行时架构摊成 spec，8–12 个核心组件、一条主链路、外部依赖和信任边界，细节放卡片里别堆连线。拿到 JSON 后跑 validate architecture spec.json 确认结构没崩，再 deliver architecture spec.json out.html --open。产出：一个能点节点、能切深浅色、能导出 PNG 的 HTML。

写 PR 的人。手上有改动前后的两份 spec 时，跑 compare architecture base.json head.json diff.html --receipt diff.receipt.json，把 diff.html 和收据一起贴进 PR 描述。产出：一张 base→head 的差异图，加一份机器可读的收据，评审不用靠你在评论里逐条解释。边界：只有 architecture 这一类支持对比，别的类型得自己贴两张。

产品经理、运营。不写代码，直接用中文把步骤和分支说给 DSH，让它按 workflow 生成 spec：先用 guide 确认这该是 workflow 而不是 sequence，再 finalize workflow spec.json flow.html。产出：一张自上而下的流程图；同事要放进需求文档时，从页面导出菜单拿 1200×630 的分享卡 PNG，比截图清楚。

装之前先把这张表对一遍，版本一旦对不上，后面的都白搭。

分个工：draw.io 灵活，但没有校验、没有 diff；让模型直接吐 Mermaid 快，渲染与交互却不由你控制；archify 把图变成 spec 加 HTML，能校验、能对比、能留收据，代价是只认它那 5 类图和 schema。

四条里，第一条几乎每个人第一天都会撞上。

三条命令的顺序不能换：先看版本、再装、最后重启；反了就会以为装了没生效。这四坑都不用改代码，装之前扫一眼，能省掉一次白折腾。