SuperAPI AI 工具集

artifact-diagramming

通用与其它

查看项目

更新于 10-16 08:05

技能介绍

用途:帮助在 Artifacts 中决定何时该配图,以及如何画出能传达真实机制的图,而非装饰性插图。判断标准是:图应让不了解上下文的读者看到原本需从文字中拼凑的机制,如数据流向、组件通信、两个方案的差异、请求经过的状态。若一句话能说清,就写句子。

主要能力与原则:画机制而非名称,例如标“cache”的方框信息量不如请求路径、两侧存储及移除缓存后消失的箭头;只画论证所依赖的部分。比较方案时画差异,如并排架构、前后对比、各自增减的那条边,孤立方框不算比较。按决策权重匹配复杂度,一跳问题用三框图,迁移改道则需队列、写入方、读取方与顺序箭头。给箭头加标签,写清 writes、invalidates、polls every 30s 等信息;仅当同一编码反复出现时才用图例。

内联 SVG 机制:适用于原生渲染内联 SVG 的页面;markdown 渲染页面按其渲染器支持的围栏绘制,由所属技能的通道指定。手写 <svg>,使用 rect、circle、line、polyline、path 与 <text>,不用库、运行时或外部图片。用 viewBox="0 0 W H" 并按内容定尺寸,CSS 用 max-width:100%; height:auto 缩放。描边、文字、箭头用 currentColor 继承前景色,仅对承载含义的元素保留字面色。箭头用 defs/marker 配 marker-end="url(#arrow)",或末端小 polygon,不用图片。文字约 11-13px,短标签,解释放图注。对齐网格。一图一结论,外层 figure 配 figcaption,svg 加 role="img" 与等价 aria-label。SVG 内不加 script、style、foreignObject,渐变、图案、use 引用同片段 id。过长装饰路径说明应改用图形工具,需简化。

限制:仅适用于支持内联 SVG 的页面;markdown 页面需依渲染器选择围栏方式;不涉及编程库或运行时。具体平台、收费与效果信息暂未提供。