1. 从一张草图到一套视觉语言：diagram-design 到底在解决什么问题
第一次听到 “diagram-design” 这个词，很多人会以为它只是“画流程图”的另一种说法。但真正在项目里做过架构图、数据流图、部署拓扑图的人都知道，画出一张图不难，难的是让一整套图看起来像“同一个系统出来的”。我见过太多团队，架构师用一套配色，开发同学用另一套图标，产品经理再插进来一套字体，最后交付给客户的文档里，十几张图各说各话，视觉噪音大到读者根本抓不住重点。
diagram-design 的核心命题，就是把这件“看起来是审美问题、实际上是工程问题”的事情系统化。它不是一个具体的绘图工具，而是一套围绕图表视觉规范、组件复用、语义映射和输出一致性建立起来的设计方法。你可以把它理解成“给图表做设计系统”——就像前端有组件库，图表也需要自己的设计语言。
这套东西适合谁？如果你只是偶尔画一张示意图发在聊天窗口里，那确实用不上。但只要你符合下面任意一条，diagram-design 就值得你花时间研究：需要长期维护技术文档的工程师、要输出架构方案的技术负责人、做售前方案需要大量配图的支持人员、以及任何希望自己的图表“拿得出手、经得起放大看”的从业者。
我最初接触这套思路，是因为一个跨平台系统的文档项目。当时有二十多张架构图要统一风格，手工调了三天，改完第五版之后发现改漏了两张，字体和线宽全对不上。那次之后我才意识到，图表设计如果没有规范约束，返工成本会随着图的数量呈指数级上升。diagram-design 解决的正是这个痛点：让图表从“一次性手工作品”变成“可维护的视觉资产”。
2. 图表设计系统的整体架构与选型逻辑
2.1 为什么图表也需要“设计令牌”
前端领域有个成熟概念叫 design token，也就是把颜色、间距、字号这些基础视觉决策抽成变量。diagram-design 把这套思路搬到了图表场景。你可能会问，图表不就是几个框几条线吗，至于吗？我举个实际例子你就明白了。
假设你的系统里有三种类型的服务：核心服务、辅助服务、外部依赖。如果不用令牌，你每次画图都要临时决定“核心服务用什么颜色”。第一次用了深蓝，第二次可能用了靛蓝，第三次干脆用了紫色。单看每张图都没问题，但放在一起就露馅了。而如果你预先定义了service-core、service-aux、service-external三个语义令牌，每个令牌绑定具体的色值、边框样式、圆角半径，那么无论谁来画、画多少次，只要引用令牌，出来的效果就是一致的。
这就是 diagram-design 的第一层价值：用语义令牌替代临时决策。令牌的命名要基于“它代表什么”，而不是“它长什么样”。比如叫>
Android R SystemUI源码解析：Keyguard occluded状态流转全流程
在安卓R（Android 11）上啃SystemUI源码，有一个绕不开的状态机：Keyguard的occluded（被遮挡）变化流程。平时大家关注比较多的是Keyguard怎么显示、怎么dismiss，很少有人专门把occluded这条链路单独…
李华
C++多态深度解析：虚表、CRTP与std::variant实战对比
如果让我挑一个最能体现C性格的特性，我会选多态。同一个调用，在不同对象上走出完全不同的执行路径；同一份接口声明，背后藏着无数具体实现。教科书喜欢把它包装成“面向对象三大特征”之一，但在真实项目里，它…
李华
TCP/IP展厅智能中控：从串口到网络化控制的工程实践
简介：基于TCP/IP的展厅智能中控软件程序是一套面向展厅、会议及多媒体展项的集中控制方案，适用于集成商、运维人员或场馆管理者，用于统一管理灯光、投影、音响等设备。软件采用可视化、所见即所得的编辑方式，通过鼠标拖曳完成界面…
李华
Leecode第68题：x的平方根
mySqrt 解题思路（二分查找）题目求非负整数 x 的整数平方根（向下取整），即最大的整数 r 满足 r * r < x。不能使用内置 sqrt。例如：x 4 → 2x 8 → 2（因为 2*24 < 8，3*39 >…
李华
artcraft：从创意到成品的结构化工作流与个人资产库搭建指南
1. 从“artcraft”这个名字说起：它到底想解决什么问题第一次看到“artcraft”这个标题，我脑子里蹦出来的第一反应是：这大概率是一个把“艺术（art）”和“手工艺（craft）”揉在一起的工具或项目。事…
李华
diagram-design：用设计系统思维构建可复用图表模板
1. 从一张草图到一套系统：diagram-design 到底在解决什么问题第一次听到 diagram-design 这个词，很多人会下意识觉得它只是“画图”的另一种说法。但真正在项目里被图表折磨过的人知道，画图本身从来不是难点，难的是让图表在三个月…
李华