<!-- title: 图解赛道横评：画图件的六种方言 -->

# 图解赛道横评：画图件的六种方言

## 概述

Skills 生态里最卷的从来不是写码件，而是「画图件」——让 Claude 把一段文字或一份数据变成一张图的技能。本期拆解一台装机机器上的图解赛道存量：chart-craft、chart-craft-plus、mermaid-generator、excalidraw、excalidraw-diagram、article-to-excalidraw、architecture-diagram-zh、text-logic-diagram，共八件，外加 obsidian 系的 json-canvas 作参照。核心发现有三条：第一，这个赛道早已不按「画什么图」分家，而按「输出契约」分家——给你渲染好的图、给你可编辑的源文件、还是给你一份图代码，是三种完全不同的产品；第二，命名后缀（-plus、-zh）暴露了清晰的代际更替痕迹，chart-craft 到 chart-craft-plus 就是一次完整的接棒；第三，本 wiki 生产线的配图管线本身就是 mermaid 路线的活证据，输出目录里成排的 mermaid 渲染 PNG 说明这条路线经过了真实量产检验。

需要说明的是，本期为装机环境离线拆解：评分依据是装机清单、版本迭代痕迹与 SKILL.md 设计学分析，不引用未经核验的仓库数据；榜单类平台（skills.sh、skillsmp.com）本期未能在线核验，仅在文末列为生态入口。

## 评测对比表

| Skill | 功能完整度 | 设计质量 | 实战效果 | 上手难度 | 迭代活跃* | 综合 |
|-------|-----------|---------|---------|---------|----------|------|
| chart-craft-plus | ★★★★½ | ★★★★½ | ★★★★ | ★★★★½ | ★★★★½ | **4.4** |
| mermaid-generator | ★★★★½ | ★★★★ | ★★★★½ | ★★★★½ | ★★★★ | **4.3** |
| article-to-excalidraw | ★★★★½ | ★★★★½ | ★★★★ | ★★★★½ | ★★★★ | **4.3** |
| excalidraw | ★★★★ | ★★★★½ | ★★★★ | ★★★★ | ★★★★ | **4.1** |
| architecture-diagram-zh | ★★★★ | ★★★★ | ★★★★ | ★★★★½ | ★★★½ | **4.0** |
| text-logic-diagram | ★★★★ | ★★★★½ | ★★★½ | ★★★★½ | ★★★½ | **4.0** |
| chart-craft | ★★★★ | ★★★★ | ★★★★ | ★★★★½ | ★★★½ | **4.0** |
| excalidraw-diagram | ★★★½ | ★★★½ | ★★★½ | ★★★★ | ★★★½ | **3.6** |

*迭代活跃维度说明：因本期未接入榜单数据，此维度不评 Star 与下载量，改按装机版本内的代际痕迹评估——是否有二代件接棒（-plus）、是否有同门竞品分走职责、是否做了本地化分叉（-zh）。痕迹越多，说明作者越在持续经营。这一指标虽然粗糙，但比无法核验的数字诚实。

## 赛道地图：三种输出契约

先上结构。八件东西看似都在「画图」，实际分属三个完全不同的产品品类：

```mermaid
flowchart TD
    subgraph C1["契约一：直接出渲染图"]
        CC["chart-craft"]
        CCP["chart-craft-plus"]
        MG["mermaid-generator"]
    end
    subgraph C2["契约二：出可编辑源文件"]
        EX["excalidraw"]
        EXD["excalidraw-diagram"]
        ATE["article-to-excalidraw"]
    end
    subgraph C3["契约三：出中文语义图"]
        ADZ["architecture-diagram-zh"]
        TLD["text-logic-diagram"]
    end
    CC --> CCP
    EX --> ATE
```

三个契约对应三种使用姿势。契约一最省事：跑完直接拿到 PNG 或 SVG，但图一旦不满意，你只能重新生成。契约二给的是 `.excalidraw` 这类源文件，生成之后人可以上手拖拽修改——AI 打底、人工修边，这是目前人机协作画图最舒服的分工。契约三不太在乎像素，它在乎的是把论证结构本身画清楚，图是思维的检验工具而不是交付物。

选件之前先想清楚你要哪一种，这一步选错，后面所有评分对你都没有意义。

## 逐件拆解

### chart-craft-plus：同门接棒的二代件（综合 4.4）

chart-craft-plus 的存在本身就是本期最有意思的生态信号。一代 chart-craft 还在装机清单里，但作者（或社区）另外做了一个 plus 版，两件并存。这是 Skills 生态里标准的「二代接棒」模式：一代件验证了需求，二代件修复一代的边界问题后重新上架，而一代件往往因为已装用户懒得卸载而长期残留。

从命名可以读出 plus 的产品意图：不是换赛道，而是在原契约（数据出图）上加码。典型加码方向包括更多图表类型、更细的配色控制、对边界数据（缺失值、超长标签）的兜底。装机实侧建议很明确：新装直接 plus，老用户保留一代做对照组，跑同一份数据对比两代输出，差异就是作者的迭代日志。

短板也在命名里：plus 这个词毫无信息量，半年后没人记得它 plus 在哪。对比之下，用「-v2」或「-pro」之外的具体能力命名（比如 chart-craft-annotated）能让触发更精准。给作者的命名建议：门牌写能力，不写辈分。

### mermaid-generator：量产管线的基石件（综合 4.3）

如果只能留一件画图 skill，留它。理由不在功能而在工程可靠性：mermaid 是文本到图路线里生态最成熟的中间格式，渲染器遍地都是，版本兼容压力最小。装机环境里最硬的证据是：本 wiki 生产线的输出目录里躺着成排的 `*-mermaid-0.png`——文章配图管线就是「mermaid-generator 出码、render 脚本渲染、入库成图」这条链，且已在多篇文章上量产跑通。

它的设计亮点是把「生成」和「渲染」解耦：skill 只负责产出语法正确的 mermaid 代码，渲染交给外部脚本或 IDE 预览。这个解耦让它在无头环境（CI、定时任务）里照样能工作——本生产线的 `render_mermaid.sh` 就是配套的渲染末端。

短板是 mermaid 语法本身的天花板：流程图、时序图、甘特图之外，稍微复杂的视觉需求它就开始吃力，而且复杂图的语法报错对新手并不友好。深色主题下的配色塌陷也是常见抱怨点。这些都不是 skill 能修的，是契约一里这条技术路线的先天边界。

### article-to-excalidraw：转化入口的独门件（综合 4.3）

八件里定位最巧的一件。它不看数据、不看系统，只看文章：把一篇已有文章的结构抽出来，画成 excalidraw 画布。对于做内容复盘、写前大纲、给编辑讲文章骨架的人来说，这个入口独一无二——其他七件都要求你先想清楚图长什么样，只有它接受「先有一堆字，再倒推出图」。

设计上它踩中了 excalidraw 格式的最大优点：`.excalidraw` 是开放 JSON 格式，机器生成毫无负担，人接手修改也毫无负担。AI 负责把非结构化的文字整理成节点和连线，人负责后续的挪位、配色、美化，分工天然合理。

短板是「文章」这个输入太宽：三千字长文和三百字短评抽出来的图信息密度完全不同，skill 若不做长度分档，输出容易在两个极端之间摇摆——太碎（每段一个节点）或太粗（全文三个框）。实测建议从短文开始喂，摸清它的抽取粒度后再上长文。

### excalidraw：手绘风画布的正印件（综合 4.1）

excalidraw-diagram 的存在恰恰反证了正印件的江湖地位。excalidraw 作为白板工具的手绘风格自带「非正式感」，特别适合架构讨论草稿、头脑风暴现场、给同事发的示意图——正式度刚好低于流程图，沟通效率反而更高。

作为 skill，它的核心价值是把「说一句话就能得到一张手绘图」变成现实：描述系统组成，它出组件和箭头；描述用户流程，它出泳道草图。手绘风格还掩盖了 AI 布局算法的粗糙——歪一点的框反而显得自然，这是 excalidraw 路线独有的容错红利。

短板是与 excalidraw-diagram 的职责边界模糊。两件并存时，触发词打架是大概率事件：你说「画个 excalidraw 图」，装机环境里到底该谁接活？本期把 diagram 分件压到 3.6 分，主要就压在这——它不是不好，而是不知道什么时候该用它而不是正印件。装机建议：两件都装的话，在各自的描述里写清分工（比如一个管「白板草稿」、一个管「结构化图表」），否则删掉一个。

### architecture-diagram-zh：中文本地化的垂直件（综合 4.0）

后缀 -zh 说明了一切：这是给中文架构图做的垂直优化。别小看这个后缀——通用画图件画中文架构图时的常见翻车点包括中英混排的字体宽度错乱、中文术语翻译走样（「网关」变 gateway、「限流」变 rate limit）、以及默认布局对长中文标签的不友好。垂直件的存在就是把这些坑预先填掉。

对国内技术团队，它的实用场景非常具体：写方案文档、画系统部署图、给非技术干系人讲架构。这些场景里图的读者全是中文使用者，术语一致性比视觉花哨重要得多。

短板是天花板明显：架构图只是图解世界的一个子集，它管不了业务流程图和数据流图之外的泛需求。而且「-zh」这类本地化分件往往由不同作者维护，与通用件的更新节奏不同步——通用件修了一个布局算法，中文件未必跟得上。用它可以，把它当唯一画图件不行。

### text-logic-diagram：窄而深的论证件（综合 4.0）

八件里最「 thinker 」的一件：它画的不是系统、不是数据，是论证本身。一段论述里的前提、推理、结论，被它抽成节点和有向边，逻辑漏洞在图上无处遁形。这个定位让它在赛道里几乎没有直接竞品——chart 系不管逻辑，excalidraw 系不管对错，只有它专门干「把话说清楚」这件事。

实战价值集中在写作自查和批判性阅读两头：写议论文时把自己的论证画出来，断链一目了然；读别人文章时画对方的论证，偷换概念直接现形。它是典型的「低频高价值」件——一周用不上三次，但每次用都在干别的件干不了的活。

短板同样来自定位：窄。输入必须是有明确逻辑结构的文字，散文、叙事、诗歌喂进去都是灾难。而且「逻辑图」的视觉表达力有限，三层以上的嵌套论证画出来就是蜘蛛网，可读性反而下降。它的 4.0 是「在自己的赛道里满分，赛道本身不宽」的 4.0。

### chart-craft：功成身退的一代件（综合 4.0）

把一代件放进横评不是为了凑数，而是因为它的处境本身就是生态教材。chart-craft 至今仍在装机清单里服役，说明基础功能完全能打；但 plus 版的出现等于官方盖章「这是旧款」。它的当代价值有三：一是给 plus 版当回归测试的对照组，二是 serving 那些已经依赖它输出风格的老管线，三是给想写自己第一个画图 skill 的人当解剖标本——一代件的 SKILL.md 往往比二代更朴素，更适合学习基础写法。

短板无须讳言：既然有 plus，新装用户没有任何理由选它。它的 4.0 分里有情怀分，也有「验证了数据出图这个契约确实有需求」的历史贡献分。生态规律如此：一代件最好的结局不是被记住，而是被接棒。

### excalidraw-diagram：边界不清的分身件（综合 3.6）

垫底不是因为它差，而是因为本期找不到它的不可替代场景。它和 excalidraw 输出同一种格式、服务相似的需求，差异大概只在触发词的侧重或子功能的取舍——这类「同一目标的第二实现」在 Skills 生态里大量存在，是社区多作者各写各的自然结果。

对装机者的启示比对作者更值钱：装机会带来「功能幻觉」，你以为多了选择，实际多了歧义。两个同门件并存时，Claude 的触发判断会在两者之间摇摆，输出质量反而不如只装一件稳定。本期的明确建议：正印件与分身件二选一，把另一件的名额让给契约三那种真差异件。

## 选件决策流

落到实操，一张图解决「我该装哪个」：

```mermaid
flowchart TD
    Q["手里是什么材料"]
    Q --> A["结构化数据"]
    Q --> B["一段论述"]
    Q --> C["系统设计"]
    Q --> D["整篇文章"]
    A --> E["chart-craft-plus"]
    B --> F["text-logic-diagram"]
    C --> G["architecture-diagram-zh"]
    D --> H["article-to-excalidraw"]
    E --> Z["都要可改"]
    F --> Z
    G --> Z
    H --> I["已到位"]
    Z --> J["换excalidraw系"]
```

决策原则一句话：先选输出契约，再选契约里的件。要交付图选契约一，要人机共改选契约二，要检验思维选契约三。图中最后一条分支是关键：如果发现每次生成后都想手动改图，说明你该从契约一迁移到契约二，这比在契约一里换件更能解决问题。

## 推荐排行榜

**总分榜**：chart-craft-plus（4.4）＞ mermaid-generator（4.3）＝ article-to-excalidraw（4.3）＞ excalidraw（4.1）＞ architecture-diagram-zh ＝ text-logic-diagram ＝ chart-craft（4.0）＞ excalidraw-diagram（3.6）

**量产管线之选**：mermaid-generator。唯一经过本环境多篇文章量产检验的件，无头渲染、CI 友好、语法生态成熟。

**人机协作之选**：article-to-excalidraw ＋ excalidraw 组合。AI 抽结构、人修细节，契约二路线的正确打开方式。

**新手第一件**：mermaid-generator。渲染链路最短，出结果最快，语法错误信息也最成熟，适合建立对「skill 画图」的正确预期。

**最被低估**：text-logic-diagram。使用频率最低，但功能不可替代率最高——论证可视化这件事，其他七件都不干。

**建议卸载**：excalidraw-diagram（若已装 excalidraw）。同门歧义的代价大于功能增益。

## 安装命令

以下以 skills CLI 为例（先 find 确认包名与来源，再 add 安装）：

```bash
# 查找并确认（注意核对作者与仓库再安装）
npx skills find chart-craft
npx skills find mermaid-generator
npx skills find excalidraw
npx skills find article-to-excalidraw
npx skills find architecture-diagram
npx skills find text-logic-diagram

# 确认后安装（<owner>/<repo> 以 find 结果为准）
npx skills add <owner>/chart-craft-plus
npx skills add <owner>/mermaid-generator

# 或手动安装：将 skill 目录放入
# ~/.claude/skills/<skill-name>/   （内含 SKILL.md）
```

## 生态观察：命名后缀里的代际史

最后把视角拉高。这八件的名字连起来读，就是一部微缩的赛道演化史：**原型名**（chart-craft、excalidraw）验证赛道，**能力后缀**（-plus）完成接棒，**语言后缀**（-zh）做本地化分叉，**转化前缀**（article-to-）开辟新入口，**格式后缀**（-diagram）制造同门分身。五种命名模式对应五种生态位，也对应五种命运——原型被接棒、plus 吃增量、本地化吃垂直、转化入口吃独门、分身最危险。

给想入场写画图 skill 的读者的建议藏在上面这五句里：别再写第四个 excalidraw 实现和第三个 chart 实现，契约一的坑位基本满了；「转化入口」和「语义垂直」两个方向还有空位——比如「会议记录转白板」「API 文档转架构图」「论文转逻辑图」，输入越具体的转化件，护城河越深。画图件的下一次洗牌，大概率不在「画得更好」，而在「从更多样的材料画起」。

## 参考来源

1. [skills.sh — Skills 生态站与热门榜单入口](https://skills.sh) — 本期榜单数据未能在线核验，列为生态热门追踪入口
2. [skillsmp.com — 2300+ Skills 可搜索目录](https://skillsmp.com) — Skill 包名与安装来源核验入口
3. [mcpservers.org/agent-skills — Claude Skills & Agent Skills Library](https://mcpservers.org/agent-skills) — 官方与社区 Skills 精选目录
4. [anthropics/skills — Anthropic 官方 Skills 仓库](https://github.com/anthropics/skills) — 官方件（canvas-design 等）的一手上游
5. 本机装机环境清单与生产线产物（output 目录 mermaid 渲染图、render_mermaid.sh、docs/claude-code/skills-review 栏目） — 本期评分的第一手依据

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
