大模型专栏（llm/）配图规范

本文件是大模型专栏（llm/ 下 intro/、app/、transformer/ 等所有子目录）画图时的专属补充规范。

通用规则（经典色板、drawio 样式、导出命令、pngquant 压缩、图床上传）见仓库根目录 CLAUDE.md 的「配图规范」一节，这里不重复，只写本专栏特有的约定。

一、最高原则：图要展现原理，不要堆文字

这是本专栏配图最重要的一条，也是最容易踩的坑。

• 图不是用来排版文字的。 一张图里如果全是文字框堆叠（比如对比表、要点罗列），那它本质是张表，应该用 markdown 表格，不要画 drawio。
• 图要展现「文字段落讲的那个原理」——结构、机制、流转、变化、层次。让读者一眼看懂「发生了什么」，而不是读完一堆方框里的字。
• 自检：把图里的文字全删掉，光看形状/颜色/箭头，还能不能看出这张图在讲什么？看不出来，就说明你在用图排版文字，重画。

举例（本专栏已落地的做法）：

• 讲「微调改参数、RAG 不改参数」→ 画模型权重的格子矩阵：RAG 侧格子全灰（冻结），微调侧格子由灰变蓝（被改写）。用颜色变化展现「参数动没动」，而不是写两段文字说明。
• 讲「成本 Prompt < RAG < 微调」→ 画一条从左到右的渐变箭头轴，而不是列三行字。
• 讲「混合架构」→ 用两条不同颜色的线（知识线 / 行为线）汇入模型，展现「两个来源各管各的」。

节点文字精简到关键词（如「缺知识」「RAG」），详细解释放在正文里，不要塞进图里。

二、每张图必带的三个品牌元素

本专栏所有 drawio 图，导出前必须包含以下三个元素（从已有图复制粘贴即可，不要漏）：

1. K logo 图片：shape=image;aspect=fixed;image=data:image/png,...，约 79×79，放标题附近的角落（右上或左上）。base64 较长，直接从任意一个已有的 llm/**/drawio/*.drawio 文件里复制整个 logo mxCell。
2. 旋转水印：text;...textOpacity=35;rotation=-20;fontColor=#666666; value 为 公众号：卡码大模型，斜放在画布中部偏下的留白处。
3. 站点署名：text;...fontColor=#666666;align=right; value 为 卡码笔记：https://notes.kamacoder.com/，放右下角。

最省事的做法：新图直接拿一个最近的同类 drawio 当模板改，三个元素自然带过来。

三、文件组织与命名

• drawio 源文件统一放在文章所在目录的 drawio/ 子目录下（如 llm/app/drawio/）。
• 命名：<文章英文名>_NN_<简短英文描述>.drawio，NN 为两位序号，如 finetuning_vs_rag_01_essence.drawio。
• 导出的 PNG 上传图床后删除本地文件（见根 CLAUDE.md），仓库里只保留 .drawio 源文件，不保留 PNG。

四、markdown 里的插图写法

每张图在正文里按这个模式插入：

<!-- drawio源文件: ./drawio/xxx_01_yyy.drawio -->

![能被搜索/无障碍读到的描述性 alt](图床返回的 url)

这张图回答的是：……（一句话点明图在讲什么，再展开 2-3 句解读，和正文呼应）

• <!-- drawio源文件 --> 注释必带，方便以后回找源文件改图。
• alt 文字写成「描述这张图内容」的完整短句，利于 SEO 和无障碍，不要写成「图1」这种。
• 图后紧跟「这张图回答的是……」的解读，把图和它对应的段落原理绑在一起。

五、改图后的流程

1. 改完 .drawio 后，先用 CLI 导出 PNG 自检能否正常打开、布局有没有错位（见根 CLAUDE.md 导出命令）。
2. 导出图先给用户确认效果，确认后再上传图床。
3. 上传成功后删除本地 PNG，把返回的 url 填进 markdown。