"All tasks completed."
夜里十一点,Coding Agent 跑完了一长串任务,终端里每一行前面都挂着一个绿油油的对勾。我端起桌上半凉的水喝了一口,盯着那句收尾的话看了几秒,心里忽然有点恍惚。顺手拉开手机备忘录,敲了几行关于“停顿”的话。
我想起的是大模型还老老实实待在浏览器对话框里的那段日子。碰到棘手的报错,得先把终端里的红字和代码片段复制进去,盯着光标闪烁等它吐出一段建议,再手动搬回编辑器;哪一行又报错了,就重新组织语言给它描述现场。哪句逻辑我没看懂,往往就在这一来一回的选中、粘贴、保存里自己露了馅。
说句公道话,早期模型那种动不动就忘了前文的局促,我半点不怀念。(谁会怀念刚贴完第三段代码它就开始胡言乱语的古早对话框呢?)靠双手在窗口之间搬上下文实在太累,重构稍微大一点,对话就顾此失彼。让我时常回味的,是夹在那些笨拙步骤之间的自然停顿:模型说完了,接下来什么时候动手,由我决定;每一行代码落进项目之前,都得先经过我的眼睛和手指;一次回答能推动的步子很小,我的目光就不得不一遍遍扫过那些夹在中间的枝节和褶皱。
Coding Agent 一普及,几乎在一夜之间把这些自然的停顿压缩到了极致。它自己会顺藤摸瓜地翻找文件、跨模块改写代码、在后台跑完一轮验证检查,末了整整齐齐地递回来一份完成报告。工程推进的速度肉眼可见地快了起来,可人读代码、消化代码的速度并没有跟着升级。那天夜里备忘录里记下的,就是这点微妙的落差:事情已经漂漂亮亮办完了,坐在屏幕前的我却好像还没来得及到场。
为了让自己落回地面,我从公开仓库 poboll/thus-note(AGPL-3.0 许可证)里翻出一次很小的历史提交,打算放慢点,像从前那样顺着代码的纹理重新走一遍。
我怀念的是停顿
Agent 的完成报告大多数时候确实省心。任务的波及面一旦扩大,没有一份提纲挈领的摘要,几分钟内根本搞不清它动了哪些模块、跑了什么测试、还留着什么尾巴。麻烦恰恰出在报告太顺滑了:一屏绿灯亮起来,人很容易顺水推舟地以为,代码跑通了,自己的理解也一并到了终点。
早些时候工具一次只够改一小段函数,我在复制、运行、微调的缝隙里,不得不反复穿过同一片代码;而在自动化代理接管流程之后,一个任务可以一口气跨过好几个文件,最终呈现在眼前的只剩下开头的简短指令与结尾的漂亮结果,中间经历过哪些取舍、绕开过哪些岔路,全折进了黑盒里。读代码这件事,悄悄从绕不开的必经之路,变成了得自己额外腾出心力去安排的选择。
我当然不想退回手工搬代码的苦日子。只是用得越久越觉得:任务结束时,我能不能撇开那份现成的摘要,用自己的话把来龙去脉讲明白,决定了我是这片代码的主人,还是在自己的项目里当了一回游客。
提交说明和补丁是两码事
我点开了 poboll/thus-note 里的 6502121c24b312dbed83989de1bab8a35aaa8380(简写 6502121c),把它的父提交 62c61f3c39c89d0f3c45bccd284e847645d82b53 也一起拉出来对照。整份补丁小得不能再小:一个文件,新增 6 行,删除 9 行,围绕图片处理链路上的异步等待和异常的数量上限。
提交说明写得相当丰满:给函数调用补上 await,处理离线模式下的 NaN,用 blob URL 立即插入图片预览,清掉残留的调试日志,还记下了 Playwright 端到端测试、离线模式验证和生产构建全部通过。只看这段文字,前因后果严丝合缝,挑不出什么要追问的地方。可视线挪到底下的补丁,核心改动只有这么几行:
把这份补丁和它的父提交放在一起逐行比对,一处有意思的细节立刻浮出了水面:说明里特意提到的“使用 blob URL 立即插入图片预览”,其实早在父提交 62c61f3c39c89d0f3c45bccd284e847645d82b53 里就已经原封不动地写好了,并不是由眼下这几行 diff 新加上的。调试日志确实在这一次被删掉了,异步等待的顺序和兜底条件也的的确确发生了改动,但平时不管是我们自己深夜写提交说明,还是让 Agent 自动生成总结报告,都极容易把“这段代码周围原本具备什么能力”和“当前这次补丁真正改动了哪几行”混在一块儿叙述。
把提交说明当成一张寻宝图的引子就好,至于宝藏埋在哪儿,还得亲自俯下身子去翻看那几行红红绿绿的代码。
顺着 await 往下摸
把目光落回变动行上,最显眼的两处修改都和 await 有关。一处落在 onImageChange 函数上,原本它触发 handleFiles 之后便径直结束,修改之后则被声明为异步函数,老老实实等待 handleFiles 执行返回;另一处藏在 handleFiles 内部,当分支逻辑检测到传入的是图片文件时,会先等待 handleImages 处理完毕,随后再去判断要不要接着往下处理其余类型的文件。
要是只扫一眼差异高亮,这两处改动三言两语就能被概括成一句轻巧的“补齐 await”;可只要顺着 onImageChange -> handleFiles -> handleImages 的调用链往上下文里多看几眼,画卷就变得鲜活起来。就在同一个文件紧挨着的不远处,文件拖放的监听器里原本就写着 await handleFiles(...),而处理剪贴板粘贴的入口却依旧孤零零地直接调用着 handleFiles(...);再看 handleFiles 内部,图片分支固然加上了等待 handleImages 的逻辑,可紧随其后的非图片分支,却依然不带任何等待地直接触发了同为异步函数的 handleOtherFiles。
看到这种写法上的不对称,我忍不住在屏幕前笑了出来。当时的情形一下子在脑海里还原了:3 月初改这几行代码的时候,注意力全被“通过文件选择器挑中图片”这一条路径上的时序毛病勾走了,顺着报错一路把 onImageChange 和 handleImages 补齐了等待,压根没顾得上旁边粘贴入口和非图片分支的兄弟们。浏览器的事件回调本就允许后台异步动作各自往前跑,这种局部的不一致并不会立刻惹出乱子,但唯有真正点开源文件通读上下文,才能看见当时修 bug 时留下的真实笔触,也顺手在心里记下一笔:下回重构文件上传模块时,可以把这几个入口的异步完成语义彻底统一一下。
躲在暗处的 NaN 与行尾空格
除去异步等待之外,补丁里的另一处核心改动只有短短一行,却藏着一个挺经典的 JavaScript 小陷阱。旧代码在判断图片数量上限时,只写了一句 if(max_pic_num <= 0) max_pic_num = 9;偏偏在离线模式下,配置项有时候会阴差阳错解析出一个 NaN。按照 JavaScript 的脾气,NaN <= 0 的求值结果永远是 false,这行看似稳妥的兜底赋值便会直接失效,紧接着算出来的可插入数量 canPushNum 也会顺理成章地被污染成 NaN,等到进入循环第一次判断 i < canPushNum 时同样返回 false,整条图片处理流程就会悄无声息地直接跳过循环、什么也不做,连个报错都不会往控制台吐。
新换上去的条件表达式 if(!max_pic_num || max_pic_num <= 0 || isNaN(max_pic_num)) max_pic_num = 9,一口气把空值、非正数以及 isNaN(max_pic_num) 的显式判断全补齐了,把这个哑巴亏堵得严严实实。
读完这几行逻辑,我又习惯性地在终端里对着父提交与目标提交敲了一行 git diff --check。结果屏幕上还真抓出了一处遗留的行尾空格,命令以退出码 2 结束。看着那个小小的红色空格提示,反倒有种久违的亲切感——哪怕测试脚本和生产构建在当时都已经顺利跑通,静态的补丁字里行间依然留着人工与工具匆忙交手时的细微毛刺。
留一点时间给 diff
合上这段小小的 diff 时,夜色已经更深了一些。我发现自己并不需要去背诵每一行代码的拼写,也没有必要把 Agent 写好的逻辑推倒重来,却已经能够彻底撇开那份笼统的摘要,像跟老朋友聊天一样把这次改动的底细交代得清清楚楚:它实打实地改写了图片处理链上的两处异步等待,堵上了 NaN 导致循环静默跳过的漏洞,顺手抹掉了调试日志,同时也留下了粘贴入口等待语义尚未统一的小尾巴。
7 月 2 日夜里写下的那条备忘录,终究只是给自己提了个醒。到了今天,我依然由衷地喜欢 Coding Agent 带来的畅快效率,看着它在终端里飞快地穿梭依旧觉得过瘾;只是我更愿意在它替我省下来的大把时间里,耐心地匀出十几分钟来,安安静静地读完手头这份 diff。