Wink Pings

AI写代码慢,是因为它在等自己

Turnpack把AI编程agent的搜索、读取、编辑、测试折进三个工具调用。实测往返从6轮降到3轮,成本降36%,测试失败能按字节回滚。但数据库迁移是另一回事,文件回滚救不了它。

AI编程agent的慢,有一个很具体的原因:它在等自己。

搜索、等结果、读文件、等读取、编辑、等写入、跑测试、等输出。每一步都要一个完整的模型回合,先等第一个token出来,再等剩下的token一个个吐完。

其中一些等待本来能省掉。如果agent已经知道要读哪些文件,并行读取可以解决一部分。但有些步骤天然依赖前一步的结果:搜索不返回,agent就不知道该打开哪个文件;编辑不落地,测试就跑不了。测试失败之后更麻烦,repo已经被改了一半,agent还得花额外的回合把修改退回去。

Turnpack的做法是把这些互相依赖的步骤折叠进一次工具调用。它是一个本地MCP服务器,给agent三个工具。

Turnpack: edits that are tested before they stay.

pack:一次调用拿到上下文

一次调用里完成正则搜索(带上下文代码)、读多个文件(整个文件、按行范围、或者只读一个函数)、列glob、跑git status。回复有大小上限,.env和密钥文件会被替换成占位符。

这解决的是搜索和读取之间的依赖。agent不需要先看到搜索结果,再决定读哪个文件,一次pack就都给了。

how it works

ship:编辑、测试、失败就回滚

这是最核心的一个。一次调用里跨多个文件做修改,然后运行你指定的验证命令。如果验证失败,每个文件按字节恢复到修改前的状态,agent拿到失败输出。

每个编辑在写之前就检查。第五个文件有问题,前四个文件根本不会动。所有问题一次性返回,附带文件里最接近的文本、行号和第一个不同的地方,下一次尝试不用重新读文件。

回复的开头直接告诉你磁盘上的真实状态:SHIPPED_AND_VERIFIED、ABORTED_BEFORE_WRITE、FAILED_AND_ROLLED_BACK,等等。

batch:一个脚本代替四十次读取

在repo上跑一段只读脚本。“这40个文件里哪些导出了X?”一次调用,十行答案,而不是四十次读取。

实测数据

一个任务:重命名一个被五个文件引用的函数,然后让测试通过。Claude Code 2.1.280,Claude Sonnet 5,每个实验组跑三次,取中位数。

measured

内置工具组:6轮往返,13次工具调用,23.4秒,2044个输出token,$0.131。

Turnpack组:3轮往返,2次工具调用,12.7秒,873个输出token,$0.084。

三次都用了同样三个回合:一次pack,一次ship做了五个文件里的九处修改并跑了npm test,一条收尾消息。模型在三次运行里都主动选了这个工具,prompt里没有任何提示。

36%的成本节省从哪来

有人问作者Terp,是更少调用还是更短上下文。他的回答是更少调用。上下文大小差不多,大约45k tokens,但每次调用都要重新读一遍。3次调用而不是6次,重新读取的量减半,这部分占节省的60%。另外25%来自模型输出更少,15%来自更少的新上下文。

这个拆解值得留意。收益主要来自减少回合数,而不是压缩上下文。如果你的agent本来就不擅长并行读取,pack的收益更大;如果它已经会批量读取,ship带来的感受会更明显,因为内置工具里没有哪个能一次完成编辑、测试、失败回滚。

但有一个边界

dust在推荐里画了一条线:如果测试运行了数据库迁移,那个迁移会留下来。文件恢复到修改前,数据库结构已经变了。他的建议是给agent一个一次性的数据库来跑检查,即使文件编辑可以回滚。

下面有人补充了Java服务的做法:用Testcontainers给每次运行建一个Postgres,Flyway或Liquibase的迁移落在那个临时库里,跑完就丢。文件回滚撤不掉schema变更,所以数据库也得是一次性的。

这个提醒很实际。ship的回滚文档里也写明了:验证命令本身的副作用,比如迁移过的数据库、生成的文件,不会被撤销。

安全设计

workspace jail:工作目录由服务器定,模型不能随便换。符号链接在检查前解析,包括目标还不存在的。

secret shield:.env、私钥、.npmrc、云凭据这些文件在pack和batch里被涂掉,ship拒绝写入。它匹配的是文件名不是内容,agent可以显式传allow_secrets绕过。防意外,不是保险箱。

只读batch:脚本在Node权限模型下的独立进程里跑,不能写文件、不能起子进程、不能读workspace之外的东西。

回滚:第一次写入之前做字节精确快照,验证失败或超时的时候恢复。SIGINT或SIGTERM中途到达也会恢复。如果是kill -9或者断电,下次服务器启动时从磁盘上的日志恢复。

零依赖:dependencies是空的。整个服务器就是src/里的TypeScript。Apache 2.0许可。

怎么用

需要Node.js 22或更新版本。

十秒试用:npx turnpack demo。在临时目录建一个一次性repo,跑三个工具,然后删掉。不碰你自己的项目。

demo

安装:npx turnpack init。它会找到你装的AI应用,先展示要改什么再问你。默认支持Claude Code、Claude Desktop、Codex、OMP、Grok Build。跑完用npx turnpack doctor检查每个应用的配置能不能真的启动服务器。

支持Claude Code、Codex CLI、ChatGPT桌面版、Cursor、Gemini CLI、OpenCode,以及任何走stdio的MCP客户端。

什么情况下不需要

一行修复,文件已经在agent手里开着。一次编辑就是一次编辑,没什么可折叠的。

把整个repo贴进聊天窗口。那是Repomix干的事。

项目没有快速检查。ship的价值在测试、类型检查或构建只要几秒钟的时候。没有verify,它就是个带校验的多文件编辑。

项目地址:https://github.com/OnlyTerp/turnpack

发布时间: 2026-11-16 11:29