@ упоминания

@ Упоминания позволяют напрямую включать файлы, папки и вывод терминала в контекст разговора, не прибегая к копированию и вставке.

Введите @ в поле чата — появится меню доступных типов упоминаний.

Типы упоминаний

Файлы

Синтаксис: @/путь/к/файлу или @"/путь с пробелами/файл.ts"

Kodik включит полное содержимое файла в контекст. Пути указываются относительно корня рабочего пространства.

Папки

Синтаксис: @/путь/к/папке

Kodik включит список файлов в папке. Папочные упоминания обрабатываются отдельно от файловых (внутренний тег @folder:): при клике в панели проводника открывается папка, а не файл.

Диапазоны строк

К файловому упоминанию можно добавить диапазон строк:

• Одна строка: @/src/index.ts#L42
• Диапазон строк: @/src/index.ts#L10-L50

Суффикс #L... указывает агенту, какая часть файла наиболее релевантна, и используется при навигации (файл открывается на нужной строке).

Терминал

Синтаксис: @terminal:<имя терминала>

Прикрепляет вывод активного терминала с указанным именем. Kodik получает до 200 последних строк из буфера терминала. Если терминал с таким именем не найден или буфер пуст, это явно указывается в контексте.

Пример: @terminal:bash, @terminal:npm run dev

Как используются упоминания

При отправке сообщения Kodik обрабатывает все упоминания и формирует раздел <user_mentions> в контексте. Файловые и папочные упоминания передаются с путями относительно рабочего пространства. Файлы, заблокированные через .kodikignore, не попадают в контекст.

Терминальные упоминания передаются в отдельном разделе <terminal_context> и не смешиваются с файловыми.

Примеры использования

Я получаю ошибку в @/src/api/users.ts#L34-L56

Вот конфигурация: @/vite.config.ts

Вывод сборки: @terminal:npm run build

Проверь всю структуру: @/src/components

Начало работы

1. Введите @ в поле чата.
2. Выберите тип упоминания из меню или продолжайте вводить путь.
3. Отправьте сообщение как обычно.

Kodik автоматически обработает упоминания и включит указанный контент перед вызовом модели.