彩蛋与实验田
正经架构讲完了,最后一章看点轻松的。这份源码里有不少永远到不了正式版的功能,也有几个纯玩的系统,它们共同展示了同一个工程手段,构建期特性开关。feature 函数来自 bun 的 bundle 模块,开关在构建时求值,开着的功能进入产物读远程配置,关着的整段删除,产物里连字符串都搜不到。所以你手里的构建里没有 buddy,不代表源码里没有。
buddy 是藏在 src/buddy/ 里的电子宠物系统。抽卡用确定性随机数,种子取自用户 id,Mulberry32 算法,同人同卡,换号重来。物种十八档,从普通的卵石蟹到传说的星云猞猁。每只宠物有属性面板,调代码、混乱度、毒舌度,还配一段由模型写的小传。整套系统完整实现,渲染、状态、稀有度概率一应俱全,只等一个开关放到线上。
把宠物系统单独读完一遍就会发现它一点也不敷衍。属性怎么影响行为,稀有度怎么定概率,小传怎么生成,每个环节都有正经的模块,目录结构和其他正式功能没有区别。实验功能和非实验功能在代码质量上没有分界线,分界线只在构建配置里,这是翻完这份源码之后容易留下印象的一个事实。
undercover 模式有实际用途。Anthropic 员工也会用这个工具参与公开项目,这个模式防止模型在公开场合暴露内部信息,拦截内部代号是基本操作。从拦截清单能看到 Capybara 和 Tengu 两个名字,后者大概率就是这个项目自身的内部代号,源码里分析事件全部以 tengu 开头,互相印证。
Dream 系统让程序睡觉时整理记忆。autoDream 是个后台子代理,流程四步,读记忆索引,从日常记录里找新信号,合并进长期记忆文件,修剪保持紧凑。第 7 章的子代理机制在这里又一次被复用,连做梦都是派子代理去做的。它还有个近亲,压缩完成后的会话转录落盘同样挂在这个开关下,两处代码紧挨着。另外还有两个大件,KAIROS 是常驻的主动助手,盯着日志在用户开口之前就动手。ULTRAPLAN 把复杂规划任务整个外包给一个远程的深度会话,用更强的模型,最长跑三十分钟。
开关的密度比想象的高。前面各章其实反复碰见过它们,bash 命令的分类器审查、auto 模式的旁路裁决、历史的裁剪、工具搜索,全都有自己的开关名,源码里 feature 调用随处可见。运行期的远程配置负责开与关的取值,构建期的死代码消除负责把关掉的分支从产物里抹掉,两层配合,实验可以随时放量也随时收回。
这些实验田说明一个趋势。当 harness 本身成熟到一定程度,新功能大多长在既有机制上,宠物是工具加渲染,做梦是子代理,主动助手是事件挂点。区分一个功能是否实验,看的往往只是那个构建开关的值。读者翻源码遇到 feature 包裹的陌生代码块,不必疑惑,那是还没放出来的未来。
全部十二章到此结束。这份泄露源码的价值,在于把一个经过大规模生产验证的 agent 运行时摊开在桌面上,主循环、工具契约、权限分层、压缩体系,每一块都能对到真实代码去读。彩蛋这一章算是读源码的余兴节目,但它讲的构建开关贯穿全书,读到任何一段拿不准是不是正式功能的代码,回头看一眼开关就知道。书里讲错的地方,以源码为准。