@ упоминания

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

Введите @ в поле чата — появится меню доступных типов упоминаний. Сверху показываются недавно открытые файлы, затем папки и файлы рабочей области. Продолжайте вводить текст для поиска: поиск нечёткий (как в Quick Open), поэтому @conf найдёт папки config и файлы вроде vite.config.ts в любом месте рабочей области, а совпадающие недавно открытые файлы остаются закреплёнными над остальными результатами.

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

Файлы

Синтаксис: @/путь/к/файлу или @"/путь с пробелами/файл.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> в контексте. Файловые и папочные упоминания передаются с путями относительно рабочего пространства, при этом их тип сохраняется явно:

<user_mentions>
  <file>src/api/users.ts</file>
  <folder>src/components</folder>
  <terminal>npm run dev</terminal>
</user_mentions>

Это позволяет агенту отличать папки от файлов без расширения, не угадывая тип по пути, и сохраняет информацию о выбранном терминале. Файлы, заблокированные через .kodikignore, не попадают в контекст.

История выбранного терминала передаётся отдельно в <terminal_context>; в <user_mentions> сохраняется только его типизированный идентификатор.

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

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

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

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

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

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

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

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