A.4 课程视觉使用规则

课程图片资产规划看板

从图片缺口检测到生成发布的流程图

图片是教学内容，不是装饰。只有当图片能降低学习者理解成本时，才值得添加或保留。

先检查学习深度

修改课程页面前，先把自己放到学习者视角，检查页面是否同时照顾三层读者：

学习者层级	页面必须提供	警讯
新人	一个可运行的小动作、白话解释、预期输出、失败后的恢复路径	页面只解释术语，但没有让人运行或检查的东西
实践者	判断规则、常见失败、需要保留的证据、下一步项目动作	页面有演示，但没有说明怎样判断结果好不好
有经验学习者	取舍、边界情况、调试信号、评估习惯或生产约束	页面像词汇表，没有更深入的问题可思考

如果页面太短，优先围绕学习者卡点加深，而不是堆更多定义。好页面应该让新人完成一个动作，也让有经验的人看到一个设计或评估问题。

核心课程页优先使用竖版教学图。9:16 或接近竖版的图片更适合移动端阅读、分步骤流程，以及需要上下展开解释的难点。如果一个教学目标开始拥挤，就拆成前后两张连续图片，不要靠缩小标签或把所有内容硬塞进一张海报。

根据学习需求选择图片风格：

需求	优先风格
抽象概念或难建立直觉的内容	类比图、手绘课堂笔记或竖版白板流程
精确模型结构、公式、指标或矩阵形状	偏专业教材图、SVG 或代码生成图
执行顺序、API 调用、RAG 链路、训练循环、Agent trace	带输入、动作、输出和调试检查点的竖版白板流程
重要历史转折或算法演进	多格手绘漫画，每格只突出一个容易记住的变化
一个密集概念包含两个不同卡点	拆成两张图：先讲直觉，再讲机制或调试

使用类比时，要把正式概念和画面绑在一起。例如，RAG 可以画成开卷查资料，梯度下降可以画成沿 loss 山坡下行，Attention 可以画成选择要听哪些前文 token，Agent 可以画成带工具箱和 trace 日志的助理。类比的目标是让下一段代码或公式更容易读懂，而不是替代技术解释。

图片方向要根据教学目的选择。分步骤教学、移动端优先阅读、需要上下展开解释的难点，适合竖版 9:16。时间线、左右对比、架构图、仪表盘或需要横向扫描的信息，适合横图。单个对象、模式或清单，可以用紧凑的方图或近方图。目标是让学习更清楚，而不是固定一种比例。

教学图片要按中文、英文、日文三语一组生成。三语版本应共享同一个场景、版式、教学目标、关键数值和视觉节奏，只替换面向学习者的标题、副标题、标签和 alt 文案。

同一组源文件使用这个命名模式，并用同样模式同步发布图：

topic-name.png
topic-name-en.png
topic-name-ja.png

topic-name.webp
topic-name-en.webp
topic-name-ja.webp

图片生成后，按项目目前做法发布：转换或同步为 WebP 后再在课程页面引用。可以缩小文件大小，但不要过度压缩。标题、标签、公式、代码片段、坐标轴、指标数值和箭头在移动端仍然必须清楚可识别。如果压缩后变糊或读不清，就保留更大的 WebP，或先简化图片再发布。

重构课程时，可以先放清晰占位，最后统一生成正式图片。占位也要记录教学目标、目标页面、图片方向和三语文件名组，这样后续批量生成时风格和目的不会跑偏。

不要只给某一个语言新增单语图片，除非它是明确的临时占位，并且有后续补齐计划。遇到精确数值输出、公式、代码顺序或指标值时，优先使用 SVG 或锁定同一批数据的实验结果图三语组。

有些旧 SVG 很准确，但像重复的幻灯片模板：彩色盒子、箭头和大段文字。章节入口页和大概念页，优先换成更有画面感的 image2 PNG。

这些情况保留 SVG：

这些情况优先换 image2：

教学页内部尽量按这个顺序：

不要因为页面空就加图。要因为下一步更好理解才加图。

学完这一页，至少保留这张证据卡：