用途:把系统架构、技术流程、API 调用链、数据管道和状态机绘制成独立 HTML 技术图,带内联 SVG、主题切换和导出菜单。每张图自带明暗主题切换(写入 localStorage,并遵循 prefers-color-scheme)、导出菜单(复制 PNG、原生最高 4× 分辨率下载 PNG/JPEG/WebP、下载随宿主主题变化的双主题 SVG)以及统一两套主题的 CSS 变量色彩系统。
主要能力:五种图形模式。architecture 用于系统组件、云资源、服务与安全边界;workflow 用于技术流程、审批闸门、CI/CD 与故障响应;sequence 用于 API 调用链与请求生命周期;dataflow 用于 ETL/ELT、PII 隔离与血缘;lifecycle 用于状态机、重试与终态。也支持把 Mermaid 代码作为输入方言,按结构重画而非机械解析。
使用方式:在技能目录执行一次 npm install(仅四个类型化渲染器需要 ajv 校验 JSON schema;生成物无依赖)。先读 schemas/<type>.schema.json 和 examples/ 完整示例,再写 <name>.<type>.json,然后运行 node renderers/<type>/render-<type>.mjs <input>.json <output>.html。渲染失败会报出 JSON 路径或阈值问题,应改 JSON 而非改渲染器。无 shell 权限时退化为 architecture 模式,手写 SVG 放入 assets/template.html。
限制:不得用内联颜色,必须使用 c-mask/c-<type> 等 CSS 类,否则主题切换失效;箭头须在组件之前绘制;需遵守各模式的列/行与坐标预算(如 workflow 仅 6 列、sequence 最多 8 个参与者);CJK 文本按双宽测量。GIF/WebM 动画导出为客户端编码,文件可能达 1–10MB,WebM 在 Safari 支持有限。未提供独立网页服务、收费与定价信息。