SuperAPI AI 工具集

dynamic-archify

通用与其它

查看项目

更新于 10-15 23:56

技能介绍

dynamic-archify 用于把技术信息绘制成自包含的 HTML 图表文件:内联 SVG 图形、深/浅色主题切换(状态存入 localStorage,并遵循 prefers-color-scheme)、内置导出菜单,以及保证两套主题一致的 CSS 变量配色系统。

支持的图表类型及用途:architecture(系统组件、云资源、服务、安全边界、基础设施)、workflow(技术流程、审批门禁、工具调用、runbook、CI/CD、事件响应)、sequence(API 调用链、请求生命周期、缓存回退、异步追踪、返回路径)、dataflow(管道、ETL/ELT、PII 隔离、血缘、数仓同步、消费方)、lifecycle(状态机、状态迁移、等待、重试、终态)。

使用方式:四种类型化渲染器用 ajv 校验 JSON schema,需在该技能目录下执行一次 npm install;未安装时渲染器仍可运行,但会打印警告并跳过 schema 校验,保留自身布局检查。流程为:先读对应 schema 与完整示例(examples/*.json),再写 <name>.<type>.json,然后运行 node renderers/<type>/render-<type>.mjs <input>.json <output>.html。渲染失败会指出 JSON 路径或需调整的参数,应修正 JSON 而非修改渲染器。无 shell 权限时可回退到 architecture 模式手工放置 SVG。

渲染器还会对布局问题快速失败:节点/状态重叠、标签与节点或标签相互碰撞、标签超宽、行列越界、边过短、图例超出 viewBox 等;CJK 文本按双倍宽度计算。各模式有布局预算(如 workflow 6 列、sequence 参与者与消息 y 范围、dataflow 2–5 阶段与 5 行、lifecycle 保留 lane 语义),并配有各自 README 说明设计语言。

输入 Mermaid 代码时,不机械解析,而是读取其结构后在对应模式中重新布局,只保留拓扑与含义。

限制:生成的 HTML 自身无依赖,只有渲染器需要依赖;导出含 PNG/JPEG/WebP/SVG、复制 PNG 到剪贴板,动画图可导出 GIF(gif.js 客户端编码,可选分辨率/帧率/时长)与 WebM(MediaRecorder,Chrome、Firefox、Edge 支持,Safari 支持有限)。其他未提及的细节暂未提供。