# 功能特性与对比

[← 返回 README](../README_CN.md)

## 功能说明

- 根据自然语言描述生成 `.tldr` JSON 文件
- 使用 `@kitschpatrol/tldraw-cli` 将图表导出为 PNG 或 SVG
- **6 种图表类型预设**:架构图、流程图、时序图、ML/深度学习模型图、ER 图、UML 类图 —— 每种类型都有预设的形状词汇和布局规范
- **自检循环**:使用视觉能力读取导出的 PNG,自动修复重叠、文字截断和缺失箭头等问题
- **迭代评审循环**:收集反馈,应用精准 JSON 编辑,重新导出直至确认(最多 5 轮安全阀)
- **复杂度自适应布局**:间距随节点数自动放大,防止重叠
- **自定义输出目录**:支持任意输出路径(如 `./artifacts/`),自动创建目录
- 当图表有助于解释复杂系统时自动触发
- 默认手绘白板风格,可切换为干净字体

## 对比

### vs 原生 Agent(无 skill)

| 特性 | 原生 Agent | 本 skill |
|------|-----------|---------|
| 生成 `.tldr` JSON | 部分 —— LLM 经常产出 schema 不合规的记录 | schema 正确的骨架 + 记录模板 |
| 导出后自检 | 否 | 读取 PNG 自动修复 6 类问题 |
| 迭代评审循环 | 否 —— 需手动反复 prompt | 精准编辑,5 轮安全阀 |
| 主动触发 | 否 —— 只有显式要求才触发 | 检测到 3+ 组件自动建议 |
| 布局规范 | 无 —— 每次结果不一致 | 复杂度自适应间距、路由走廊、枢纽节点居中 |
| 图表类型预设 | 否 | 6 种(架构、流程、时序、ML/DL、ERD、UML) |
| 配色方案 | 随机 / 不一致 | 13 色语义系统(蓝=服务,绿=DB,紫=认证……) |
| 箭头分布规则 | 基础 | `normalizedAnchor` 在形状边缘均匀分布,避免堆叠 |
| Index 排序规则 | 经常错误(用 `b1`、`c1`) | 严格 `a*` 格式,含 z-order 约定 |
| 多平台元数据 | 否 | OpenClaw、Hermes、SkillsMP 命名空间 |

### vs 其他图表 skill

| 特性 | tldraw-skill | drawio-skill | mermaid-skill | excalidraw-skill |
|------|--------------|--------------|---------------|------------------|
| **风格** | 手绘白板 | 干净专业 | 自动布局文字 | 草图非正式 |
| **格式** | `.tldr` JSON | `.drawio` XML | 文本 DSL | `.excalidraw` JSON |
| **导出格式** | PNG, SVG | PNG, SVG, PDF, JPG | PNG, SVG, PDF | PNG, SVG |
| **手动布局控制** | x/y 坐标 | x/y 坐标 | 仅自动布局 | x/y 坐标 |
| **自检循环** | 基于视觉 | 基于视觉 | 部分 | 部分 |
| **图表预设** | 6 种 | 6 种 | 由文本语法驱动 | 无 |
| **样式预设** | — | 用户可学习 | — | — |
| **适合场景** | 白板草图、轻量解释、内部文档 | 商务/学术正式图 | 文档中的快速文转图 | 手绘风格演示 |

## 支持的图表类型

- **架构图**:微服务、云架构、部署 —— 按层着色、枢纽节点居中
- **流程图**:业务流程、决策树、状态机 —— 语义化形状类型
- **时序图**:用矩形 + 水平箭头近似演员消息流
- **ML/深度学习**:按层类型着色、张量形状标注
- **ERD**:实体用多行文本矩形,箭头标注基数
- **UML 类图**:类用多行文本矩形,关系用不同箭头