Оптимизация производительности и токенов

Используйте RTK для сокращения количества токенов, расходуемых на разовые команды разработки.

AIKraft Agents может маршрутизировать вывод Bash-инструмента через RTK, локальную утилиту командной строки, которая сжимает типичный вывод команд разработки перед отправкой его обратно в модель.

Это полезно, когда сессия выполняет команды, которые создают много повторяющегося текста: диффы, списки каталогов, результаты поиска, логи тестов, вывод менеджера пакетов и вывод сборки. RTK не ускоряет выполнение команд; он сокращает количество токенов вывода, которые модель должна прочитать и обработать.

AIKraft Agents проверяет и запрашивает разрешения на исходную команду. RTK изменяет только путь вывода, используемый для контекста модели.

Почему включать RTK?

Многословный вывод инструментов — один из самых простых способов истощить контекст. Например:

git diff
rg "TODO|FIXME" .
bun test
npm install
ls -R

Без RTK весь сырой вывод добавляется в диалог. При включённом RTK AIKraft Agents вызывает локальный исполняемый файл rtk, чтобы переписать подходящие Bash-команды так, чтобы их вывод был сжат перед доставкой до модели.

Типичные преимущества:

• Меньшее количество токенов для типичных команд разработки
• Более удобный контекст, оставшийся для кода и рассуждений
• Меньше шума от повторяющихся логов, больших диффов и длинных списков файлов
• Видимость в настройках благодаря статистике сохранённых токенов / эффективности RTK

RTK наиболее полезен для сессий программирования и обслуживания репозитория. Он меньше помогает для команд, которые уже выводят краткий, целенаправленный результат.

Требования

• RTK установлен локально как rtk в системном PATH
• Версия RTK 0.23.0 или новее
• AIKraft Agents версии 0.9.4 или новее

AIKraft Agents не включает RTK в комплектацию. Он обнаруживает исполняемый файл rtk в PATH и вызывает его локально с отключённой телеметрией для вызовов перезаписи и статистики RTK.

Вам не нужно выполнять rtk init для AIKraft Agents. rtk init устанавливает хуки для других инструментов; AIKraft Agents вызывает rtk rewrite напрямую, когда включена опция Производительность.

Включение RTK в AIKraft Agents

1. Установите RTK для вашей операционной системы.
2. Откройте Настройки → ИИ → Производительность и нажмите Повторная проверка. Если вы редактировали переменные окружения PATH, перезапустите AIKraft Agents, чтобы процесс настольного приложения увидел новый PATH.
3. Включите Оптимизация токенов.
4. Запустите сессию с интенсивным использованием команд.
5. Вернитесь в Настройки → ИИ → Производительность, чтобы просмотреть статистику сохранённых токенов после обработки команд RTK.

Если AIKraft Agents всё ещё отображает Получить RTK, исполняемый файл rtk отсутствует, имеет версию ниже требуемой или недоступен в PATH, используемом приложением.

Установка RTK

macOS

Самый простой вариант — Homebrew:

brew install rtk-ai/tap/rtk

Или используйте установочный скрипт RTK:

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh

Проверьте:

which rtk
rtk --version
rtk gain

Linux

Homebrew на Linux:

brew install rtk-ai/tap/rtk

Или используйте установочный скрипт RTK:

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh

Если вы предпочитаете Cargo:

cargo install --git https://github.com/rtk-ai/rtk rtk

Проверьте:

which rtk
rtk --version
rtk gain

Windows

Загрузите архив Windows с страницы релизов RTK, извлеките rtk.exe и скопируйте его в каталог, находящийся в Windows PATH.

Вариант без прав администратора и без изменения окружения — использовать папку WindowsApps для конкретного пользователя. Она обычно уже находится в Windows PATH, поэтому избегает необходимости прав администратора и глобальных системных папок:

Copy-Item "C:\Users\<you>\bin\rtk.exe" "$env:LOCALAPPDATA\Microsoft\WindowsApps\rtk.exe" -Force

Проверьте из нового окна PowerShell:

Get-Command rtk
rtk --version
rtk gain

Если вы предпочитаете выделенную папку bin для пользователя, добавьте её в Windows PATH пользователя один раз:

[Environment]::SetEnvironmentVariable(
  "Path",
  [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Users\<you>\bin",
  "User"
)

Затем повторно откройте PowerShell и проверьте ещё раз. Если AIKraft Agents уже был запущен, когда вы редактировали PATH, перезапустите его перед нажатием Повторная проверка.

PATH Git Bash/MSYS и PATH Windows/PowerShell — это не одно и то же. rtk может работать в Git Bash из C:\Users\<you>\bin, тогда как AIKraft Agents или PowerShell всё ещё не могут его найти. Поместите rtk.exe в каталог, находящийся в Windows PATH, например %LOCALAPPDATA%\Microsoft\WindowsApps, или добавьте свою папку bin в Windows PATH пользователя.

Примечания по Windows PowerShell

Если вы проверяете из Windows PowerShell 5.1:

• Используйте Get-Command rtk или where.exe rtk; which не является командой PowerShell.
• Используйте ; между командами вместо Bash-стиля &&.

Пример:

Get-Command rtk; rtk --version; rtk gain

Устранение неполадок

AIKraft Agents всё ещё говорит, что RTK не установлен

Нажмите Повторная проверка в Настройки → ИИ → Производительность. Если это всё ещё не работает, проверьте rtk из того же системного shell, который видит AIKraft Agents:

• macOS/Linux: which rtk && rtk --version
• Windows: Get-Command rtk; rtk --version

В Windows убедитесь, что папка находится в Windows PATH, а не только в Git Bash/MSYS PATH.

rtk --version работает, но AIKraft Agents не включает его

Проверьте версию. AIKraft Agents требует RTK 0.23.0 или новее, так как он зависит от rtk rewrite.

rtk gain завершается ошибкой или выглядит неправильно

Убедитесь, что вы установили Rust Token Killer (rtk-ai/rtk), а не несвязанный пакет Rust Type Kit с тем же именем исполняемого файла. Правильный RTK поддерживает rtk gain.

Мне нужно инициализировать каждый проект?

Нет. AIKraft Agents не требует rtk init; он использует установленный исполняемый файл rtk напрямую. Вам нужно только rtk init, если вы также хотите хуки RTK для другого инструмента, который использует RTK таким образом.