用途:Archify 依据小型类型化 JSON 规格生成自包含、可交互的 HTML 图表,覆盖架构、工作流、时序、数据流和生命周期五类。默认输出静态图,仅在用户要求演示或展示时启用动效。
主要能力:支持 architecture(组件、服务、云/安全边界、基础设施)、workflow(流程、审批门、工具调用、runbook、CI/CD)、sequence(API 调用链、请求生命周期、异步追踪、返回)、dataflow(管道、ETL/ELT、血缘、治理、消费方)、lifecycle(状态转换、重试、等待与终态)。生成的 HTML 已内置主题切换、平移缩放、搜索、聚焦、关系追踪、语义视图、演示和导出等阅读能力。
使用方式:从 schemas/ 读取一个匹配 schema 与 common.schema.json,并从 examples/ 读取一个匹配 JSON 示例;新工作流使用 schema_version: 2。先写候选文件,再校验: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 收集浏览器证据。可用 node bin/archify.mjs doctor 与 demo <output-directory> 验证。
适用场景:需要从结构化规格快速产出可交付、可校验的架构或流程类 HTML 图表时。
限制:showcase 通过须报告全部 9 项 artifact 检查且 0 组合错误、0 警告;非零退出不得描述为成功;交付失败会保留旧输出,不应再对旧路径做 visual-check;视觉感知审查需人工或具备图像能力的审查者,自动化测量不构成感知认可;更新检查仅提示,不下载、不安装、不执行更新。无 shell 时可手工将架构 SVG 放入 assets/template.html 并使用 CSS 语义类。