名词解释教学工作区 · 课程 0028 · 形态 单概念 · 约 6 分钟 · 前置:0022 · LLM · 2026-10-06
rtk rewrite:让命令回话短一点再交给模型
你能做到:说清「命令改写」改的不是命令在干什么,而是它回话的方式,
以及为什么压缩输出省下来的量并不等于账单打折。
1 | 定义
rtk rewrite(命令改写):在命令真正执行之前,由一层钩子把它换成等价的另一种写法(例如 git status → rtk git status),由改写后的程序去跑同一条命令,并把输出压成一份更短的摘要再交出去。
像给跑腿的人换一副眼镜:活儿还是那件活儿,回来只挑要紧的说。
输出压缩(output compaction):在一条命令的输出进入模型的上下文(context)之前,按这条命令的语义删掉噪音 —— 空行、注释、逐行的重复条目,只留下判断需要的那几行。
像把一整页流水账折成一张便签:数字一个不少,废话全省了。
2 | 它解决什么麻烦
- ① 命令的输出是给「人」看的。
git status 会老老实实把每个文件的完整路径都列出来,ls -l 会把权限、属主、时间、大小全摆上 —— 人扫一眼就知道该看哪行,模型得逐字读完。
- ② 这些字都要算钱,还占地方。一次几百行的清单原样进上下文,既抬高了输入量,也把真正关键的那几行挤到噪音里(rtk 官方自述把它算成「最多砍掉 bash 输出的一大截」)。
- ③ 人肉限制很啰嗦。靠
head / tail / grep 一条条手工剪输出,每条命令都得重新想一遍该怎么剪,还容易把需要的行一起剪掉。
- ④ 反直觉的地方:对人来说「输出越全越保险」,对模型来说恰恰相反 —— 无关行越多,越难抓住重点。
3 | 它怎么解决
按命令类型换不同的压缩策略 —— 这是它和「一刀切截断」最大的区别:
| 命令 | 输出被换成什么 |
ls / tree | 树形 + 每个目录的文件数,不再一行一个文件名 |
cat / 读文件 | 结构、函数签名优先,不必把整篇正文灌进去 |
grep / rg | 长行截断,命中按文件归组 |
git status | 紧凑的状态摘要 |
git commit / push | 一行确认,替代全过程输出 |
cargo test | 只留失败用例,通过的收成一个计数 |
docker ps | 只留关键列 |
- ① 改写发生在执行前。靠钩子的工具在调用 shell 之前把命令换成
rtk 原命令;靠插件的工具走插件接口做同一件事。模型看到的是压缩后的结果,全程不必显式喊 rtk。
- ② 只覆盖走 shell 的那部分。钩子挂在命令执行这一层,所以「内置的文件读取 / 搜索」这类不走 shell 的调用不会被改;要吃到同样处理,得改用
cat / rg / find 这类命令。
- ③ 顺手记账。它带一个「省了多少」的面板;这些数字是按「字节数除以四」估的,没有内置分词器,所以百分比可信、绝对数只是近似。
4 | 用它的代价
- ① 覆盖有边界。不走 shell 的调用不经过钩子;要它生效只能走命令,或者显式用它的读 / 搜 / 找子命令。
- ② 输出是被动过的。排错时你想要的恰恰可能是被压掉的那几行 —— 所以得知道怎么拿原始输出(直接跑不带前缀的原命令)。
- ③ 数字是估算值。百分比可靠,绝对值不准;拿它去对账会失望。
- ④ 省的是输入的一部分,不是账单。输入里还有提示词、系统提示、历史对话;账单里还有输出。越往后稀释越多 —— 这就是官方特意写一页说明「省 90% 的输出」和「省 90% 的钱」不是一回事的原因。
- ⑤ 多一层依赖。钩子没装就完全没效果;二进制装不上、版本对不上,得到的只是一条报错。
<10ms 的开销本身可忽略,可它毕竟是链路里多出来的一环。
- ⑥ 压缩策略可能不合你的口味。「只留失败用例」很好用,但当你要数到底跑了多少条、哪几条慢时,就得回到原始输出。
5 | 真实使用场景
- ① 让 agent 频繁跑的那几条命令安静下来。改完代码看一眼状态、翻一下目录、跑一遍测试 —— 这类调用一天几十次,每次都在灌一样的清单。
- ② 长会话的省流。同一件事来回几十轮时,每一条命令的输出都在累加;先压再进上下文,后面的每一步都省。
- ③ 验证是否生效。查版本、看它的「省了多少」面板 —— 两个命令就能确认钩子有没有真的装进你用的那个工具。
- ④ 网络受限的机器上安装。官方给了 Homebrew / winget 这类现成渠道,也给了预编译二进制这条直路;下载源不通时,从发布页取对应平台的压缩包更稳。
6 | 和相近的东西怎么分
| 名称 | 它是什么 | 和本词什么关系 |
分页与截断(head / tail / 分页器) | 人工限定一次只看多少行 | 按行数砍,不懂这条命令在说什么;改写是按语义砍,留下的仍是可判断的信息 |
行过滤(grep / rg) | 按文本模式挑出或剔除行 | 它按你写的模式过滤,改写按命令类型换成摘要 —— 两者常配合,但职责不同 |
结构化输出(--format=json + jq) | 让命令自己吐结构化数据,再由你取需要的字段 | 最治本的一路,但要改命令用法、也要会写取值表达式;改写不用你改任何习惯 |
| 巡检器 | 不运行内容就按规则挑出代码里的毛病,用退出码给流水线报结果 | 改的是代码本身的问题;改写不动代码,只动「回话」的形态 |
| 模型侧上下文压缩 | 在模型这一边把长对话或长材料摘要掉 | 压的是已经进了上下文的东西;改写在命令这一边先压,更早、更省 |
7 | 常见误解
- ① 「省 90% 的 token,账单就打一折。」省的只是输入里「命令输出」那一份,而账单还含提示词、历史与输出 —— 官方专门写了一页来说明这个换算为什么不能直接乘。
- ② 「它把所有工具的输出都压了。」只有走 shell 的调用会被钩子改;内置的文件读写与搜索不走这条路。
- ③ 「压过的输出可以当原始记录用。」它是摘要,不是日志;要留证据就得自己另存原始输出。
- ④ 「装上就自动生效。」要针对你用的那个工具初始化一次钩子,并重启它;改完不重启,钩子还没进内存。
- ⑤ 「改写会改变命令的效果。」命令做的事一模一样 —— 同一条
git status,只是换了个程序去跑、换了个方式回话。
8 | 练习
三题自测,每题只有一个正确选项;选完立刻看到解释。
1. 「命令改写」到底改了哪一样东西?
对。改写把 git status 换成 rtk git status,同一条命令、同一份结果,只是交回来的东西被压短了。
2. 为什么「砍掉 90% 的命令输出」不等于「省下 90% 的费用」?
对。输入里还有提示词、系统提示与历史对话,修正值又被输出再次稀释 —— 越往后,最初那一截的占比越小。选项 d 说的是另一个真问题(绝对值不准),但它解释的是数字精度,不是占比。
3. 下面哪种调用吃不到「命令改写」的好处?
对。钩子挂在「执行 shell 命令」这一层,内置的文件读取不走 shell,自然不会经过它 —— 想吃到同样的压缩,得改用 shell 里的读取命令或它的子命令。