功能说明
Archify 是一个代理技能，而不是运行时扩展：它不提供任何服务，也不向 Harness 注入任何东西。负责画图的代理写出类型化的 JSON——也就是 Archify 的中间表示——Archify 再确定性地把这份源文件编译成 HTML 或 SVG 图表。仓库本体是一个 Node.js 渲染器与校验器，附带零依赖 CLI；布局、校验与导出由工具完成，绘图决策由模型完成。
这个分工才是它有意思的地方。因为中间表示是类型化的、渲染器是确定性的，同一份 JSON 永远产出同一张图；而一张坏图是一次带机器可读原因的校验失败，而不是一张悄悄画错的图。
一张图是怎么产生的
README 给出的五个阶段：
- 生成 —— 代理把你的描述转成类型化 JSON IR。
- 校验 —— 内置校验器检查 schema、布局、HTML/SVG 输出、路径走向与标签到路径的间距。
- 预览 —— 可选，且明确仅限回环：本地会话监听单个源文件，只在随机
127.0.0.1端口上重载已通过校验的版本。 - 交付 —— 先在同目录渲染并检查候选文件，只有通过校验的产物才会原子地替换目标文件。
- 迭代 —— 代理修改源文件，无关结构保持稳定。
校验失败时，validate 与 deliver 返回结构化诊断：稳定的规则码，以及对每个对象支持的修复方式，而不是一段调用栈。技能允许两轮自动修正，之后交回人工做视觉复核。
五种图表类型
| 类型 | 适用场景 |
|---|---|
| 架构 | 组件、服务、存储与边界 |
| 工作流 | CI/CD、审批、工具调用与运维手册 |
| 序列 | API 调用、缓存回退、鉴权与异步链路 |
| 数据流 | 管道、血缘、PII 与消费方 |
| 生命周期 | 状态、重试、等待与终态 |
默认输出是一份 HTML 文件，另可导出 PNG、SVG 与 WebM，以及 1200×630 分享卡。内置四套预设（含 Signal Flow、Blueprint，默认 Classic），主题分深浅两色。动效是有限的、由读者触发的，遵循 prefers-reduced-motion，且永远不会进入正式导出——静态导出就保持静态。
有两个功能超出了「画图」本身。Architecture Delta 会比较校验过的变更前、增量与变更后快照，精确列出新增、删除、变更、移动与改道的部分，并附一份机器可读凭据。证据节点 会自我标记，并可打开固定到某个公开提交的、经 Git 校验的文件与行号范围——也就是说，一张图所声称的内容可以回到代码里去核对。
运行要求
需要 Node.js。CLI 零依赖，可直接从检出目录运行；README 没有给出技能本身的最低 Node 版本。面向 DSH 的集成包更严格：它固定 Node ^22.19.0 || >=24.0.0，并面向开发者预览版的 Harness。
分发方式因宿主而异。其他 Harness 通过 skills CLI 安装，或直接放进技能目录；Claude.ai 与 Project Knowledge 则上传 ZIP。DeepSeek Harness 由独立社区包 @tt-a1i/archify-dsh 承接，README 明确标注它不是 DeepSeek 官方产品。
什么时候用它、什么时候不要用
当你需要的是一张可重新生成、可 diff、可校验的图，而不是某人画过一次的图片时，就用它。结构化源文件才是重点：你可以在 pull request 里审阅那份 JSON，而 Architecture Delta 会给出说清「改了什么」的前后对照。
不要指望它是一把通用画图工具。README 对边界的表述相当直接：自动解析 Mermaid、通用自动布局、托管分享与所见即所得编辑都有意不在范围内，并自述既不是绘图编辑器，也不是 Mermaid 主题。如果你要的是 Mermaid 渲染器，或者一个能拖着方块到处摆的画布，那它并不合适。
还有两点来自源码的提醒。增量与分享卡功能对自身主张相当克制——复核不推断影响、风险或合并安全性，reach 分享卡也明确写着「不主张运行时影响」。此外当前版本是开发预发布版 v2.17.0-dev.1，JSON schema 仍会变动。
兼容性说明
因为它是技能而不是运行时扩展，它基本不受 Harness 版本更迭的影响——但技能自身的 JSON schema 会动，而 Architecture Delta 依赖历史快照仍然可读。README 明确记录了唯一一次对外网络请求：可选的更新检查，抓取一份稳定清单以决定是否显示提醒。它从不下载或安装更新，也不发送你的版本号、提示词、项目数据或账号标识。设置 ARCHIFY_UPDATE_CHECK_DISABLED=1 可同时关闭该请求与提醒状态的写入。
FAQ
Archify 是插件还是技能？
是技能。它不声明任何 Harness 服务，自己的仓库里也没有根 package.json——这正是它不出现在自动索引层的原因，也是本站对它的收录属于人工策展条目、而非机械准入的原因。
生成图表会把我的代码发到外面吗？
README 记录了唯一一次对外请求，即可选的更新检查，并声明不传输提示词、项目数据、版本号或账号标识。它并未声称图表生成完全离线，也没有说明技能在分析仓库时读取磁盘上的哪些内容，因此这部分属于未验证，而不是已确认。
能导出到 PowerPoint 或用于印刷吗？
导出格式是 PNG（含 1200×630 分享卡）、SVG 与 WebM。README 没有提到面向印刷的输出，所以「印刷分辨率」会是夸大——文档中给出的尺寸就是分享卡与整图导出。
生成的图表画错了怎么办？
校验的设计目标就是在交付前拦住它。schema、布局、HTML/SVG、路径与标签间距检查必须全部通过，候选文件才能替换上一个已知可用的产物；失败时返回的是规则码与受支持的修复方式，而不是让你自己猜着重试。