用途:根据小型类型化 JSON 规格,生成精致的独立 HTML 图表,支持架构、工作流、时序、数据流和生命周期/状态五类图。默认静态输出,仅当用户要求演示时启用动效。
主要能力:输出为内联 SVG 的自包含可探索 HTML;内置主题切换、平移/缩放、搜索、聚焦、关系追踪、语义视图、演示与导出。图表类型路由:architecture(组件、服务、云/安全边界、基础设施)、workflow(流程、审批门、工具调用、CI/CD)、sequence(API 调用链、请求生命周期)、dataflow(管道、ETL/ELT、血缘、治理)、lifecycle(状态转换、重试、终止态)。
使用方式:从 schemas/、schemas/common.schema.json 与 examples/ 各读一个匹配文件;新工作流用 schema_version: 2,保留旧几何时用 v1。先写出候选 JSON,再校验:node bin/archify.mjs validate <type> <candidate.json> --quality showcase --json;交付:node bin/archify.mjs deliver <type> <candidate.json> <output.html> --quality showcase --json。交付后可运行 node bin/archify.mjs visual-check <output.html> --json。无 Shell 时手动放置 SVG 到 assets/template.html。可用 node bin/archify.mjs doctor 与 demo <目录> 验证。
适用场景:需要可读、可交付的单文件架构与流程说明图,支持 Mermaid 语义转换(flowchart→workflow/architecture,sequenceDiagram→sequence,stateDiagram→lifecycle),但只取其拓扑与含义,重新撰写 JSON。
限制:默认静态;展示模式需显式启用。showcase 校验需 9 项检查全过、0 错误 0 警告。桌面视口需满足不溢出,禁止用 overflow: hidden、裁剪、内滚动或缩小字号伪装通过。非零退出码不得声称成功。更新检查 v0.1 不会下载或安装更新。其他功能与收费信息暂未提供。