# RTK-AI Token Saver

> 把智能体连接到它，它的 git、ls、grep 和测试命令的输出就会被压缩——token 更少，事实不变。

Source: https://docs.neurosquad.ai/zh/plugins/rtk-ai-token-saver

智能体会读取大量命令输出：每一次 `git status`、`git log`、目录列表和测试运行都会进入它们的上下文。
**RTK-AI Token Saver** 插件让智能体的 shell 命令经过 [RTK](https://github.com/rtk-ai/rtk)——一个开源工具，
保留事实、去掉噪音：`git status` 变成简洁的已修改文件列表，全部通过的测试变成一行。

## 如何使用

1. 在添加卡片菜单中选择 **插件…**，在 **插件** 标签页打开 **RTK-AI Token Saver**，点击 **添加到画布**。
2. 如果尚未安装 RTK，点击 **下载 RTK**。NeuroSquad 会从 GitHub 下载官方构建（约 4.5 MB），
并与 GitHub 公布的校验和核对；没有校验和就不会下载。已经装了 RTK（`winget install rtk-ai.rtk`、
`brew install rtk`）？它会被自动找到。
3. 从智能体向卡片画一条[箭头](https://docs.neurosquad.ai/zh/canvas/arrows)。

就这样——智能体的**下一条**命令就会经过 RTK，无需重启。删除箭头后，下一条命令又会照常运行。

## 卡片显示什么

- 已连接的智能体少读了**多少输出**（百分比），以及大约节省了多少 token。
- 每个已连接的智能体：它自己的节省量和最近一次被压缩的命令，例如 `git status → rtk git status`。
- 正在使用的 RTK 版本，以及它是你自己的安装还是下载的版本。

每条被压缩的命令也会在箭头上闪现，并记录在箭头日志中。

> RTK 按字节 ÷ 4 估算 token，因此百分比准确，token 数为近似值。RTK 只压缩 shell 命令的输出——
> 你的提示词、智能体自己读取的文件以及它的回答都不会改变。

## 支持哪些智能体

实时支持 **Claude Code**、**Cursor CLI**、**OpenCode** 和 **Kilo Code**。其他智能体也可以连接，
但卡片会标记为 **不支持**——它们的 CLI 目前还无法在命令运行前改写命令。

- **危险模式**——压缩每一条受支持的命令。
- **普通模式（Claude Code）**——只读命令（`git status`、`git log`、`ls`、`cat`、`grep`）会被压缩且
不弹出确认，和以前一样直接运行。本来就会询问的命令（`git push`、`cargo test`…）仍只询问一次——
你批准的是 `rtk` 版本。其他命令原样运行。RTK 不会增加确认，也不会批准任何本应询问的命令。
- **普通模式（Cursor、OpenCode、Kilo）**——无法从外部预测它们的权限确认，因此 RTK 仅在危险模式下
对它们生效。
- **画布模式**——智能体没有自己的 shell，没有可压缩的内容。

如果 RTK 不存在、出错或不认识某条命令，原始命令会原样运行。需要某条命令完整输出的智能体，
只需在命令前加上 `RTK_DISABLED=1`。

## 隐私

RTK 在你的电脑上运行。NeuroSquad 会为它启动的每个智能体关闭 RTK 自带的（需主动开启的）遥测，
并把 RTK 的历史按智能体分别保存在 NeuroSquad 的数据文件夹中。你的 RTK 设置保持不变。

RTK 由 rtk-ai 开发，采用 Apache 2.0 许可证发布。