我是小兵，一个动手派AI架构师。“AI工程化实战”系列收官篇（第 18 篇）。

先讲个让我语塞的事

前阵子一个做技术负责人的朋友，微信上甩来一个问题：“系统上线半年，最近用户投诉变多了，我该先动哪一块？”

我手里握着十七篇，每一篇都站得住。可盯着这句话，我一时答不利索——投诉变多，是幻觉多、是检索烂，还是成本把某条链悄悄降级了？脑子里十七篇同时在闪，哪篇都对，就是拼不成一句“先看哪篇、抓这个决策、抄那段代码”。

那一刻我想通了：这十七篇缺的不是内容，是一张图。

十七篇缺的不是内容，是一张图

我复盘了自己和身边人用这个专栏的方式，三个误区，一个比一个耽误事。

误区一，把专栏当线性教程，从头读到尾。可你不是“从零开始学”，你是“手里有一套系统、卡在某处”。线性读法按我的写作顺序排，不按你的处境排；真出问题，脑子里是一团糊，不是一张图。

误区二，收藏夹吃灰。十七篇点过收藏、存过书签，真要查的时候，是在收藏夹里从头翻——把“检索”退化成“翻找”。

误区三，每篇都读懂了，就是拼不起来。单看第 8 篇《OTel + LangFuse 全链路 Trace》，你懂了；单看第 2 篇《Golden Set + CI 评测》，你也懂了。可“幻觉变多”这四个字进来，你并不知道它该先去第 8 篇定位根因、再回第 2 篇看评测报没报警。单篇成立 ≠ 十七篇能拼。

一张图，三种用法

收官要做的不是把十七篇再讲一遍，是编一张图——输入一句大实话处境（“幻觉变多”“成本月月涨”“不敢发版”），直接吐出“看哪篇 + 抓哪个决策 + 抄哪段代码”。

三层图共用同一份数据，这是它和“十七篇串讲”最大的不同：

全息地图（一层数据、三种用法）      ├─ ① 骨架网格    —— 给决策层：十七篇各在哪      ├─ ② 症状检索    —— 给执行层：遇到这个看哪篇      └─ ③ 覆盖度自查  —— 补症状轴覆盖不到的能力空白

• 骨架网格：给架构层、决策层看“全貌长什么样、十七篇各在哪”。横轴关注面、纵轴系统阶段，一篇一格。
• 症状检索：给执行层、新人查“遇到这个，看哪篇”。输入一句大实话处境，输出主篇 + 关联篇 + 核心决策 + 代码落点。
• 覆盖度自查：补症状轴覆盖不到的“能力空白”。拿自检 10 问逐格打勾，报缺口、该回哪篇补——这 10 问是：评测集、自动对基线、灰度熔断、Prompt 版本化、网关、护栏、强约束、Trace、成本账本、反馈闭环 + 知识库巡检。

举个例子。你手里攥着那句“用户投诉变多了”：

第一步，进症状检索。“幻觉变多”这条，主篇是第 8 篇《OTel + LangFuse 全链路 Trace》——先要有 Trace，才定位得了根因到底是知识库、检索、路由还是模型；关联第 2 篇《Golden Set + CI 评测》和第 11 篇《知识库防腐坏》。一句话症状，直接落到篇。

第二步，抓主篇的核心决策。第 8 篇那句“可观测不是加监控面板，是把每个裁决点变成结构化 span、用 trace_id 串成链”，就是你这一步要抓的决策。图只给入口，不替你走完。

第三步，回覆盖度自查确认根子。症状轴只回答了“有征兆了看哪篇”，它答不了“你根本没有这个能力”。拿自检 10 问逐格打勾——如果“Trace”这一格本来就是空的，那第一步指到第 8 篇，其实是在指一个你还没建的底座。

顺序很重要：先症状定位“看哪篇”，再自查确认“补哪块”，最后回原篇抄代码。跳过自查，你会拿着第 8 篇的方案，却不知道自己连评测集都没有。

三个判断，每个都是踩坑踩出来的

这张图怎么编出来的？三个判断，背后各有一跤。

判断一，能查到，比讲全重要。我一开始想把十七篇的精华都塞进图里，结果图越编越厚、越厚越查不动。第一版我按写作顺序排成一张表，一个新人问我一句：“我卡在‘成本月月涨’，从哪一行开始看？”——他得从第 1 行扫到第 17 行。按写作顺序排，是目录；按处境排，才是图。后来翻过来：一篇只占一个主格 + 一句核心决策，细节一律回原篇。全集查不动，不如索引查得动。

判断二，地图会烂，别做死也别做满。工具会换、评测框架会升级、监管口径会变，写死结论的图，三个月后就在骗人；我一度还把它做满——网格切得太细、切成迷宫，比目录还难用。图的本事在收，也在留活口。所以只焊结构（处境→篇→决策→落点这条链），细节标复核日期、不编死数字；图烂了，改数据就行，导航逻辑一行不动。

判断三，图不能悬空。索引指向空处，比没索引更坏——读者照着抄，会一头撞进空里。这一条我对自己最狠：盘点时我把专栏前十七篇的落点逐条对了一遍磁盘，4 处对不上——第 2、3、4、11 篇正文都写着有成品 demo，磁盘上其实什么都没有，demo 全嵌在正文里。根因很扎心：我早期写作时在正文里“描述”了一套理想的工程结构，它们从没真正落盘。正文声称的落点，和磁盘上真实有的东西，是两回事，我当时没意识到中间有条沟。修复做了两件事：一是如实记成“代码嵌于正文”，绝不去编一个看起来像路径的假落点；二是把这条纪律落成函数 check_references()，以后任何一篇落点填错，跑一遍就报悬空。我先拿自己开刀，再说“图不许悬空”——自己墙上有裂缝，才有资格要求你把索引钉牢。

一句收口

十七篇造零件，这一篇把零件合回开篇那副骨架，再叠一个“拿处境一查”的入口。图不是第十七篇的续、也不靠新题撑场——它是这 18 篇的另一种读法：遇到这个，看那篇。

收官篇没有“下一篇预告”，因为它就是终点。但它给你留了三条起步线：

• 今天就动手：拿自检 10 问给自己系统逐格打勾，补最短的那块板，别贪多。
• 每年复核一次：地图会烂——工具、框架、口径都在变；结构不用动，把落点、复核日期和结论重新核一遍。
• 格子补透了，回来聊：哪一格你补通了、或者发现图上少了一条该有的线，欢迎回来告诉我——这张图的下一版，靠的是用过它的人。

往后再遇到问题，不用再从第一行扫到最后一行。

这篇是脱水版。完整版里有十八篇全息索引、三层图的全部字段、一张“症状→主篇→关联篇”完整表，还有一个纯标准库、离线可跑、带 9 个断言的全息地图导航器 demo——输入处境直接命中的那种。想看能查、能自证的完整图，点“阅读原文”直达 CSDN 完整版。

我是小兵，一个动手派AI架构师。这里只写自己跑过、摔过、复盘过的AI工程化案例。如果你想持续收到这类实战内容，点击关注。