开工第一天上午，知乎连发的两篇同题专栏、GitHub 当日还在推的提交、加上我中午实测 API 时的 45,205 颗星快照，都指向同一个仓库——cathrynlavery/diagram-design。它在 README 里把自己干的事写得毫不客气：“No shadows. No Mermaid slop.”——直接点名所有用 AI 画过图的人都忍过的那口槽：圆角矩形套圆角矩形、连线随机、配色像随机数生成器。GitHub
先把最容易被带节奏的数字分清口径。10 月 7 日一篇知乎专栏写它 4.3 万星、登上了 GitHub 日榜冠军。 同一天的另一份 GitHub 热门项目周报按当日总星数排序，把它列在榜内第 12 名。 两个说法都对：一个看的是当日新增星数，一个看的是存量，“日榜冠军"不等于"全网第一”。知乎知乎
增势也是真的：9 月 6 日它还是 3.2 万星、38 种图型，10 月 7 日变 4.4 万星、42 种，两个月涨了 1.2 万。 今年 8 月 13 日它还有过单日 +4,504 星的记录，看热榜先分清增量口径和存量口径，是老规矩了。知乎
装之前，先分清三层
第一层：它卖的不是"画图功能"，是"画图规矩"。 diagram-design 不是独立软件，是给编码 Agent 用的一个开源技能（MIT 协议，2026 年 4 月 16 日建库）。它把一套编辑级设计规范硬编码给 AI：一张图只留一个强调色，且只给最该先看的一两处；1px 细边框、禁阴影、圆角最大 10px；所有坐标、宽度、间距必须能被 4 整除——README 原话，这是图"看起来不像 AI 生成"的关键；信息密度目标十分之四；规范第一条是"最高质量的动作通常是删除"，每个元素都得挣到自己的位置。GitHub
出厂 42 种图型（架构图、时序图、ER 图、甘特、鱼骨图、沃德利地图、泳道图，甚至有轴向爆炸图和楼层平面图），每种带浅色/深色/完整编辑风三档，外加 87 个图标和 127 张官方示例，在线画廊能逐张翻。知乎
第二层：你用什么宿主，决定装不装得上、装得全不全。 它是给 Claude Code、Codex、GitHub Copilot CLI、Factory Droid、Pi、OpenCode，以及 Cursor、Cline、Gemini CLI 这些 Agent Skills 宿主用的——不是给网页版 ChatGPT 或豆包用的。安装路径还分档：走各家官方插件市场装，会带齐 /export-diagram、/import-mermaid、/profile、/doctor 这些命令面；用 `npx skills add cathrynlavery/diagram-design` 一条命令装的只有技能本体，之后想导出 PNG、导入旧图，命令不在。 Claude Code 装完默认关闭第三方市场的自动更新，要手动开一次开关；Windows 没开开发者模式的，符号链接降级为复制，以后每次更新都得重装。GitHub
第三层：导出链，这是此刻中文用户最容易踩的坑。 这个项目的验收标准是"渲染出来的像素"——CI 里有个 lint-render 用无头 Chromium 把示例真渲染出来量排版，官方 issue 流里热力图文字透明度要压在单元格真实底色上算、瀑布图守恒校验改用精确有理数、极坐标标签可见性要穿透父分组判断，全是这种毫米级修复；仅 10 月 6 日一天，20 多条 fix 开头的修复就被合入。 但你自己导出 PNG 需要装 Playwright，README 写明了那两行一次性准备：`pip install playwright && playwright install chromium`。 下面这张官方泳道流程示例，就是按这套渲染验收出来的成品——流程图画成"能直接进正式文档"的样子，正是它相对 Mermaid 默认输出的差异所在。知乎GitHub
更要命的是字体：从 9 月 24 日开到现在还没合入的 issue #249 明说，繁体中文和韩文字体已经进了公共字体链接，简体中文 Noto 的四款字重还"没有 shipped"——简体标签在别人机器上靠浏览器的本地字体，导出的 PNG/SVG 靠导出机器的字体。 把 SVG 原图发给领导或客户、到对面机器上字体变一套，是中文场景最容易翻车的姿势。现阶段解法很朴素：自己机器导出 PNG 发图，别发 SVG 源文件。GitHub
三笔账：token、兼容、返工
token/时间账：42 种图型不会一次性全塞进上下文，Agent 启动只见技能名，你说要画流程图它才加载流程图那本说明书，仓库里专门有"SKILL.md 为什么设字节上限"的架构决策记录——按 token 付费的人，这个设计比选哪个模型更省钱。 真正的时间成本在第一张中文测试图和一次 PNG 导出。知乎
兼容账：简体字体没内嵌（#249）、导出要 Playwright、Windows 复制不软链——三条有没有卡你环境，决定现在装还是再等等。
返工账：存量的 draw.io、Mermaid、Excalidraw 源文件可以按指定格式、尺寸、详略重画。官方样例是一个 12 节点的 draw.io 图：原图 6 个马卡龙填充色归成 1 个强调色、手拖的坐标归到 4px 网格。 wiki 里堆着几百张老图的团队，值得先拿 3 张试点，别一键全改。GitHub
四类人对号入座
公众号/技术文档作者：最对口。作者自述的动机就是她自己的场景——问 AI 要张图，拿到圆角框，要么跟 Figma 搏斗 30 分钟，要么干脆不放图。GitHub
老图成堆的团队 wiki 负责人：重绘功能是为你准备的，但先测导出、看简体字体在你机器上到底塌不塌。
PPT/咨询交付党：onboard 命令是最大卖点——对着你的官网说一句 onboard，它 60 秒抓主色板和字体栈、映射成语义角色，先给你看 diff 再写入。 之后每张图天然长在你家设计系统里；配置文件存本地，包更新也冲不掉。知乎
纯网页聊天用户：装不上，别追教程。同题文章里今天还夹着"下载汇总"——14MB 的仓库被切成 5 个百度网盘分卷、配了提取码。 仓库重打包本身就是老毛病：网盘版不跟更新，而且你没有终端宿主，下回来也只是占地方。知乎
装前 60 秒自查清单，直接抄走
① 你常用的 CLI 宿主在不在官方支持列表里；② 要导出/导入就走市场安装，npx 单装只有技能本体；③ Claude Code 记得开自动更新开关；④ 先画一张全中文标签的测试图，导成 PNG 看字体塌不塌；⑤ 只从官方仓库和官方画廊拉，不接网盘重打包；⑥ 老图重绘先拿 3 张试点。
装完之后，继续盯这几个信号
#249 合没合：简体 Noto 四款字重进了字体链接那天，中文用户才算"即装即用"。
#62：社区在提 treemap、sankey、slopegraph 三种数据图型。 #254：阿拉伯语 RTL 支持在路上。 它从日榜冠军掉回"毫米级修复"的节奏能不能维持，看这批 issue 的处理速度。知乎GitHub
星数与马甲：9 月 6 日 3.2 万、10 月 8 日 4.5 万，日榜冠军之后两周，模仿者和"一键安装包"会集中出现，凡是让你加群、下网盘的，直接绕开。
最后说人：作者 Cathryn Lavery，BestSelf.co 创始人，GitHub 简介里写着自己的品牌靠自举做到 5500 万美元以上营收、2022 年卖给私募、2024 年又买了回来，现在转型 AI 并公开记录过程。 一个卖效率手册的人，把"品味"翻译成了能被 CI 校验的硬规则——这不像是蹭流量的玩法，更像开工第一周，值得你花 60 秒自查完再动手装的那类工具。GitHub
