“这张图是从哪个目录读进来的?”
问出这句话的人是我自己。那天深夜,实验室的顶灯关了一半,只有我面前的显示器还亮着。屏幕上铺开一张橘红色的眼底彩照,血管纹理间叠着规整的检测框和醒目的热力色块,旁边跟着一行精确到小数点后两位的概率值。盯着这张图看久了,人很容易生出一种大功告成的错觉。
可当我随手关掉演示页面、切回编辑器翻看代码时,心里那点踏实感忽然漏了一半:刚才那张图到底是从哪个目录读进来的?远端的模型推理是真的完整跑通了,还是走了本地的兜底数据?要是待会儿上台演示时遇上网络抖动或者跨域报错,操作者眼前的屏幕会停在哪一帧?
我答不上来。
周末,我把“眼智医”前后端的公开仓库从头到尾重翻了一遍。
顺着后端那串歪歪扭扭的提交记录往下读,一路折腾的轨迹历历在目:最开始只是急着搭起 AI Studio 的代理接口,接着满头大汗地修补参数兼容和 CORS 跨域配置;再往后,为了让现场展示好看,我甚至往代码里塞进了一段从两组眼底图像里随机抽取素材的逻辑。
把这些零散的 commit 串在一起回看,我自己都笑了。调通模型接口其实只算得上热身;真正磨人的功夫,是怎么把一场原本靠运气撑住的现场演示,拆解成经得起反复推敲、随时能从头跑通的几道工序。
把模型当成普通的外部服务
刚接手模型接口那会儿,我总觉得它带着点高深莫测的算法光环,连传参都小心翼翼。后来踩过几次坑才想明白:不妨就把它当成最普通不过的第三方外部服务来对待。
既然是外部调用,该立的规矩一样都不能少:请求参数用 TypeScript 把结构定义得严丝合缝;超时和网络抖动给出让人一眼看懂的中文提示;上游吐回来的原始 JSON,更不能图省事直接塞进前端组件里。
在原始响应和页面视图之间留一层薄薄的数据转换,平时写着好像多此一举。可一旦哪天上游悄悄改了字段名,或者远端平台升级了模型版本,故障就能稳稳当当地停在适配层里报警,不至于毫无征兆地一路穿透到前端,变成用户眼前的一片白屏。
那次“随机抽样”的提交
翻到那次“从不同数据集随机抽样”的提交记录时,我脸有点发红。
当时为了在演示时多挣一点印象分,我让页面每次刷新都随机换一张眼底照片和识别结果。朋友凑过来看,直夸这系统反应敏捷、动态十足;只有写代码的我自己心里发虚——“每次刷新看着不一样”和“模型真能稳定识别病灶”,完完全全是两码事。
拿预设的示例样本去理顺页面交互和接口链路固然无可厚非,可要是连自己都被这层热闹糊弄过去,未免太本末倒置。
做医学影像相关的界面,哪怕只是课程项目或原型 Demo,也得把“辅助”二字老老实实摆在明面上。拍摄时的光照角度、样本分布的偏差,甚至后处理阈值的一丁点拨动,都会让最终的概率数字上下摇摆。页面上绝不该把冷冰冰的百分比排成板上钉钉的诊断结论,更要在角落里清清楚楚地标明哪些是内置示例、哪些是实时推理,给看图的人留出充分判断的余地。
被浏览器拦下来的那个傍晚
除了数据层面的严谨,跨域配置也结结实实地给我上过一课。
第一次联调前后端的那个傍晚,请求被浏览器拦在半路,控制台刷出一大片刺眼的红字。(说来好笑,当时我还一口咬定是 AI Studio 的模型接口挂了,抓着后端的黑框框翻了半个钟头日志,压根没往浏览器的同源策略上想。)
等到临近上台演示,为了图一时痛快,我又差点把后端允许的来源一股脑儿设成通配符 *——等于把本该收紧的代理服务直接敞开在公网上。
后来定下心来,我还是挑了个最笨也最踏实的办法:先把白名单里的前端域名一条条列进配置文件,再亲手把预检请求(OPTIONS)、异常报错和正常返回这三条路径各跑一遍。虽然多花了小半个晚上,但每一步踩在哪块石头上,心里总算有了底。
写文档时收着点
把这些细枝末节都理顺之后,再在文档里写下“准确率”三个字,我下笔谨慎了许多。
一个孤零零的百分比数字其实说不了多少话。它背后得跟着数据集的来源、训练集与测试集的切分方式、评估指标的口径,还有一行能让别人在自己机器上一键复现的脚本命令。如果测试脚本、样本说明和版本记录还没收拾利落,在写文档时就得收着点性子,老老实实写“目前已跑通图像上传与异步推理的交互链路”,也不去夸海口说系统已经能独当一面。
折腾这类医疗交叉项目,最熬人的活儿往往都藏在台面底下:枯燥的输入格式校验,克制温和的报错提示,锁死版本的依赖清单,还有洗去患者敏感信息的日志脱敏。把这些不起眼的齿轮一颗颗拧进流程里,演示界面并不会因此变得更炫酷,但我终于敢大大方方地把仓库链接发给队友和朋友去本地跑跑看。哪怕隔上大半年自己重新点开项目想改一行逻辑,也能很快摸清是哪颗螺丝松了扣。
合上电脑前,我给这个仓库的下一轮修整记了三件事:
- 整理一套彻底脱敏的标准输入样本;
- 给每次推理的请求和响应加上结构化的摘要记录;
- 把模型超时或返回空数据时前端降级页面的真实模样截几张图存好。
那些识别失败的坏样本、预处理参数和模型版本号,也该一并妥帖地收进文档里。
这些带着泥土气的记录大概永远上不了答辩路演的幻灯片。可当某一天页面再次报错或者结果发生漂移时,顺着它们往回找,总比对着一张漂亮的热力图发呆要踏实得多。