2026-03-07 每章配图建议表

本表用于解决当前最现实的问题： 教程内容已经完整，但还缺少一套统一的配图策略。

你现在并不一定需要真实业务截图，也完全可以先用：

• Mermaid 图解
• SVG 占位图
• Showcase 页面截图
• 结构卡片图
• 表格型信息图

本建议表的目标是：

• 告诉你每章最适合用什么图
• 告诉你优先用“图解”还是“截图”
• 告诉你现有仓库里哪些素材已经能复用
• 告诉你后续如果要补真实图，应优先补哪些

使用原则

原则 1：先有“图的类型”，再补“真实素材”

不要一开始就纠结没有真实截图。 先确定本章最适合：

• 流程图
• 状态图
• 架构图
• 卡片图
• 截图

原则 2：优先用图解表达方法论

对这套偏工程教程的内容来说，很多章节本来就更适合图解，而不是产品截图。

原则 3：真实截图只补最值得补的地方

真实截图最值得补在：

• 示例页
• 项目成果页
• 工作流面板页
• 引用展开页
• 首页视觉页

每章配图建议表

章节	主题	推荐图类型	优先级	现有可复用素材	后续可补真实图
第1章	转型认知与岗位模型	能力地图 / 路线图	高	docs/examples/assets/diagrams/chapter-01-role-map.svg	可补一张“个人能力地图卡片”截图
第2章	大模型应用基础	结构卡片图 / 参数基线表	中	docs/examples/assets/samples/chapter-02-model-baseline.json	可补一张“参数基线展示页”截图
第3章	工具调用与单智能体	状态图 + 展示页截图	高	examples/showcase/example-01.html、截图占位图	可补单 Agent 运行页真实截图
第4章	检索增强入门（RAG）	RAG 链路图 + 引用卡片截图	高	docs/examples/assets/diagrams/chapter-04-rag-flow.svg、examples/showcase/example-02.html	可补引用展开与风险提示真实截图
第5章	检索增强进阶	实验矩阵图 / 指标对比图	中	docs/examples/assets/samples/chapter-05-rag-optimization-log.json	可补“优化结果对比表”截图
第6章	工作流编排	状态机图 + 任务面板截图	高	docs/examples/assets/diagrams/chapter-06-workflow-state.svg、examples/showcase/example-03.html	可补 Workflow 任务面板真实截图
第7章	多智能体协作	协作关系图 / 协议图	高	docs/examples/assets/samples/chapter-07-collaboration-protocol.json	可补多角色面板示意图
第8章	评测体系建设	Eval 闭环图 + 指标卡片图	高	docs/examples/assets/diagrams/chapter-08-eval-loop.svg	可补评测结果页真实截图
第9章	工程化上线能力	发布/监控/回滚流程图	高	docs/examples/assets/diagrams/chapter-09-release-loop.svg	可补部署面板或监控页截图
第10章	安全与合规治理	权限边界图 / 数据分级图	高	docs/examples/assets/diagrams/chapter-10-security-guardrails.svg	可补高风险确认弹窗截图
第11章	作品集构建方法	证据结构图 / 项目卡片图	高	docs/examples/assets/diagrams/chapter-11-portfolio-evidence.svg、docs/examples/assets/samples/example-11-portfolio-card.json	可补作品集首页截图
第12章	求职实战与面试表达	面试闭环图 / 题库结构图	高	docs/examples/assets/diagrams/chapter-12-interview-loop.svg、示例12 面试答题模板	可补题库页或模拟面试记录页截图

配图类型建议

A 类：必须优先补的图

这些图对阅读体验提升最大，而且当前已有大部分素材：

• 第 1 章：岗位能力地图
• 第 4 章：RAG 链路图
• 第 6 章：工作流状态图
• 第 8 章：评测闭环图
• 第 9 章：发布 / 监控 / 回滚图
• 第 10 章：安全边界图
• 第 11 章：作品集证据结构图
• 第 12 章：面试准备闭环图

B 类：建议补展示页截图的章节

这些章节如果补一张真实页面截图，会让教程更像“能落地的产品”：

• 第 3 章：单 Agent 页面截图
• 第 4 章：RAG 回答卡片 / 引用展开截图
• 第 6 章：Workflow 面板截图
• 第 8 章：评测结果页截图

C 类：可后补的图

这些图不是当前必须，但有余力可以继续增强：

• 第 2 章：参数基线表 / 输出结构卡片
• 第 5 章：实验矩阵与指标对比图
• 第 7 章：协作关系图 / 仲裁流程图

现成素材映射

已有图解素材

• 图解画廊

已有截图占位图

• 截图画廊

已有 Showcase 页面

• examples/showcase/example-01.html
• examples/showcase/example-02.html
• examples/showcase/example-03.html

已有结构样本

• docs/examples/assets/samples/README.md

推荐执行顺序

第一阶段：只补图解

先把这 8 张图正式挂到对应章节里：

• 第 1、4、6、8、9、10、11、12 章

第二阶段：补 Showcase 截图

从 examples/showcase/ 截出最值钱的 6 到 8 张图：

• 单 Agent 空态 / 完成态
• RAG 回答态 / 引用展开态
• Workflow 等待确认态 / 完成态
• Eval 结果态

第三阶段：补真实项目截图

如果后续有真实产品或真实项目页面，再逐步替换部分占位图。

当前建议

如果你问“现在最先该补哪些图”，我建议优先顺序是：

1. 第 4 章 RAG 链路图
2. 第 6 章 Workflow 状态图
3. 第 8 章 Eval 闭环图
4. 第 11 章 作品集证据结构图
5. 第 3 / 4 / 6 章的 Showcase 截图

这样做，整套教程的视觉完整度会最快提升，而且不依赖真实业务截图。