SuperAPI AI 工具集

archify

前端与建站

查看项目

更新于 10-15 16:45

技能介绍

用途:根据小型类型化 JSON 规格生成自包含、可交互的独立 HTML 图表,类型涵盖架构(architecture)、工作流(workflow)、序列(sequence)、数据流(dataflow)和生命周期(lifecycle)。静态输出为默认,仅在用户要求演示或汇报时启用动效。

主要能力:生成带内联 SVG 的独立 HTML;生成的页面自带主题切换、平移缩放、搜索、聚焦、关系追踪、语义视图、演示和导出等阅读器能力;交付时报告规格与产物的 SHA-256 及字节数。

使用方式:先依问题选择图表类型,读取 schemas/ 中对应 schema 与 common.schema.json,以及 examples/ 中一个 JSON 示例,仅读这些文件。作者化时使用新的稳定 ID、领域措辞与布局:新工作流用 schema_version: 2,仅在保留既有固定几何时用 1。候选文件写好后执行校验:node bin/archify.mjs validate <type> <candidate.json> --quality showcase --json,showcase 通过须报告全部 9 项检查且 0 组合错误、0 警告。最终交付用 node bin/archify.mjs deliver <type> <candidate.json> <output.html> --quality showcase --json;非零退出不得称为成功。可选预览用 node bin/archify.mjs preview <type> <input>.json <output.html> --quality showcase。类型不明确可运行 node bin/archify.mjs guide "<scenario>" --json。品牌可用 node bin/archify.mjs brands "<name>" --json 查询,未知品牌需用户提供官方 URL 时用 node bin/archify.mjs brands capture "<url>" --json。自检与示例用 node bin/archify.mjs doctor 与 node bin/archify.mjs demo <output-directory>。交付后可用 node bin/archify.mjs visual-check <output.html> --json 收集浏览器证据,仅当用户要本地预览时加 --open。

适用场景:架构组件与服务边界、审批流程与 CI/CD、API 调用链、ETL/ELT 与数据血缘、状态流转等。

限制:规格未提供安装、收费、价格与平台信息;无 shell 权限时改为手工将架构 SVG 放入 assets/template.html,用 CSS 语义类而非内联颜色。交付校验、浏览器证据与人工视觉审查属三类独立结论,不得混淆;更新检查仅在首个候选文件存在后运行,本 v0.1 工作流不会下载、安装或执行更新。