SuperAPI AI 工具集

archify

前端与建站

查看项目

更新于 10-15 16:46

技能介绍

用途:依据带类型的 JSON 生成经过校验的独立 HTML 图,默认静态输出并内联 SVG,支持深色/浅色主题,覆盖架构、工作流、时序、数据流、生命周期五类图。据场景选择类型:组件、服务、云/安全边界与基础设施用 architecture;流程、审批门、工具调用、CI/CD 用 workflow;API 调用链、请求生命周期用 sequence;管道、ETL/ELT、血缘用 dataflow;状态迁移用 lifecycle。可用 node bin/archify.mjs guide "<scenario>" --json 辅助判断;Mermaid 输入仅作拓扑与语义参考,需重新编写 JSON。

用法:在工作目录执行。每个新请求使用独立目录 .archify/<type>-<slug>-<YYYYMMDD-HHMMSS>/,其中保存 candidate.json 与 <slug>.html,并在 meta.output 指向该 HTML 相对路径。命令中的 bin/archify.mjs 需替换为已安装包的绝对路径或相对工作目录的路径。首次候选直接用 finalize,例如:node bin/archify.mjs finalize <type> <candidate.json> <output.html> --quality showcase --json;代码库候选需加 --repo-root <repo-root>。finalize 依次执行 validate、deliver、严格校验与真实浏览器 browser-check,在首个不通过的门处停止,非零退出即失败,需修复后重跑完整命令。安装诊断可用 node bin/archify.mjs doctor 与 node bin/archify.mjs demo <output-directory>。

限制:browser-check 仅检测 Chrome 或 Chromium,未安装时通过 ARCHIFY_CHROME 指定基于 Chromium 的浏览器(Edge 未经验证);离线时设置 ARCHIFY_UPDATE_CHECK_DISABLED=1;Windows 上部分 Node 版本会因路径 dev 为 0 导致失败;动效需显式开启 meta.animation: "trace";无 shell 访问时需手工放置 SVG。仓库若有可编辑图要求或指定输出目录,应遵循该规则。生成物可能含本地绝对路径与系统用户名,应加入忽略文件,不可提交或外传。