Настройка контекста чата SourceCraft Code Assistant в Visual Studio Code

Важно

На странице описана функциональность контекста чата в Visual Studio Code. Описание функциональности контекста чата для IDE от JetBrains см. на странице Настройка контекста чата SourceCraft Code Assistant в IDE от JetBrains.

Упоминания контекста — это мощный способ предоставить Code Assistant конкретную информацию о вашем проекте, что позволяет выполнять задачи более точно и эффективно. Вы можете использовать упоминания для ссылок на файлы, папки, проблемы и коммиты git. Упоминания контекста начинаются с символа @.

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

Тип упоминания Формат Описание Пример использования
File @/путь/к/файлу.ts Включает содержимое файла в контекст запроса Объясни функцию в @/src/utils.ts
Folder @/путь/к/папке Включает содержимое всех файлов непосредственно в папке (не рекурсивно) Проанализируй код в @/src/components
Problems @problems Включает диагностику панели проблем VS Code @problems Исправь все ошибки в моем коде
Terminal @terminal Включает недавнюю команду терминала и вывод Исправь ошибки, показанные в @terminal
Git Commits @a1b2c3d Ссылается на конкретный коммит по хэшу Что изменилось в коммите @a1b2c3d?
URL @https://example.com Импортирует содержимое веб-сайта Перескажи кратко @https://sourcecraft.dev/portal/code-assistant/

Особенности упоминания файлов

Возможность Подробности
Формат @/path/to/file.ts
Всегда начинайте с / от корня рабочей папки.
Извлекаемые данные Полное содержимое файла с номерами строк.
Поддерживаемые файлы Текстовые файлы, PDF и DOCX с возможностью извлечения текста.
Допустимое использование В начальных запросах, уточняющих ответах и последующих сообщениях.
Ограничения Очень большие файлы могут быть обрезаны. Бинарные файлы не поддерживаются.

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

  1. Чтобы вызвать выпадающее меню предложений, в поле чата введите @.

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

  3. Выберите нужный тип упоминания с помощью клавиши Enter или мышью.

    Вы можете комбинировать несколько упоминаний в запросе, например исправь @problems в @/src/component.ts.

    Выпадающее меню автоматически предлагает:

    • Недавно открытые файлы.
    • Видимые папки.
    • Недавние коммиты git.
    • Специальные ключевые слова problems, terminal, git-changes.
    • Все текущие открытые файлы, независимо от настроек игнорирования или фильтров каталогов.

Игнорирование файлов

Поведение Описание
Обход .codeassistantignore Упоминания файлов и папок обходят проверки .codeassistantignore при извлечении содержимого для контекста. Содержимое игнорируемых файлов будет включено, если они упомянуты напрямую.
Обход .gitignore Аналогично, упоминания файлов и папок не учитывают правила .gitignore при извлечении содержимого.
Учет команд git Упоминания, связанные с git, например @git-changes, @commit-hash, учитывают .gitignore, так как они зависят от команд git.

См. также