Skip to main content

Диагностика конфигурации

Используйте эту страницу, если Veai не видит инструкцию, правило, навык, профиль модели или MCP-сервер либо продолжает учитывать старую конфигурацию.

Сначала определите источник​

Откройте чек-лист активной конфигурации и проверьте только механизм, связанный с симптомом. Настройки нужно сверять по нескольким экранам и файлам.

Veai пока не показывает единый список всей effective configuration. В интерфейсе также нет полного журнала, который объясняет, какой путь проверялся и почему каждый Rule совпал или не совпал. Поэтому проверяйте источники по одному и не считайте отсутствие видимого индикатора доказательством загрузки.

AGENTS.md​

  1. Проверьте имя AGENTS.md и расположение строго в корне проекта.
  2. Сохраните файл. Veai отслеживает его через VFS и автоматически перечитывает после изменения.
  3. Если новая инструкция не проявилась, начните новый чат, чтобы исключить старый контекст.

Размещайте AGENTS.md в корне проекта. Файлы с таким именем во вложенных каталогах Veai не загружает по этой схеме. Отдельного индикатора со списком фактически загруженных AGENTS.md нет.

Rules​

  1. Проверьте каталог: проектные правила находятся в .veai/rules, глобальные — в ~/.veai/rules.
  2. Убедитесь, что в метаданных задан обязательный filePattern.
  3. Сверьте шаблон с текущим открытым файлом. Veai использует glob-сопоставление Java NIO; шаблон должен соответствовать пути в его синтаксисе.
  4. Проверьте, что правило не отключено в чате.

Veai сопоставляет filePattern с путём текущего файла через Java NIO glob. Если файл в редакторе не выбран, срабатывают только общие шаблоны ** и **/*.

filePatternТекущий путьРезультат
**/*src/main/App.ktсовпадает
src/**/*.ktsrc/main/App.ktсовпадает
src/**/*.kttest/AppTest.ktне совпадает
*.mdREADME.mdсовпадает
*.mddocs/guide.mdне совпадает: шаблон не включает каталог
docs/**docs/guide.mdсовпадает

Используйте в шаблоне / как разделитель пути и проверяйте его на фактическом относительном пути проекта. Несколько совпавших правил могут применяться одновременно, но интерфейс не показывает полный match trace и нормализованный путь проверки.

После изменения правил конфигурация перечитывается наблюдателем. Для проверки оставьте одно правило с короткой однозначной инструкцией, откройте подходящий файл и начните новый чат. Отсутствующий обязательный filePattern подсвечивается инспекцией IDE; полного пользовательского отчёта для всех ошибок front matter нет.

Skills​

Используйте структуру skills/<имя>/SKILL.md внутри распознаваемого корня конфигурации, например .veai/skills/<имя>/SKILL.md. После изменения Skills перечитываются автоматически.

Если навык не загружается, откройте группу Error в списке навыков и наведите указатель на ошибку: подробность доступна во всплывающей подсказке. Ошибка может указывать на отсутствие front matter, некорректный YAML, обязательное поле или путь поля; для синтаксических ошибок также могут быть показаны строка и столбец. Исправьте структуру или метаданные и повторите ручной вызов через /имя-навыка.

Model Routing​

В текущей реализации проектный .veai/model-routing.yaml целиком заменяет глобальный ~/.veai/model-routing.yaml. Профили из двух файлов не объединяются по alias. Если проектный файл существует, добавьте в него все профили, которые нужны проекту. После обновления Veai проверьте это поведение на установленной версии.

Файлы Model Routing перечитываются после изменения. Если профиль не появился, проверьте YAML, выбранную область Project/Global и доступность закреплённой модели. Подробнее: профили моделей.

Memory Bank​

Проверьте главный переключатель Settings → Tools → Veai → Memory Bank. Когда он выключен, индекс памяти не добавляется в контекст и инструменты памяти недоступны. Затем проверьте .veai/memory/MEMORY.md и нужную запись. Начните новый чат после исправления устаревшей записи.

MCP​

Глобальные серверы находятся в ~/.veai/mcp_servers.json, проектные — в .veai/mcp_servers.json. В текущей реализации проектный сервер с тем же именем перекрывает глобальный. После обновления Veai проверьте это поведение на установленной версии.

  1. После ручного изменения файла обновите серверы доступным в установленной версии действием интерфейса.
  2. Если соединение было потеряно, выполните Reconnect. При переподключении Veai заново получает список инструментов.
  3. Прочитайте структурированную ошибку подключения или вызова: она отделяет тип ошибки от её сообщения и дополнительных данных.
  4. Проверьте URL или команду, переменные окружения, права учётной записи и наличие инструмента в Tools.

Подробный разбор соединения: MCP и внешние инструменты.

Если источники конфликтуют​

Если инструкции из текущего запроса, AGENTS.md, Rules, Skills, Memory Bank и пользовательского режима конфликтуют, локализуйте источник по шагам:

  1. оставьте проверяемую инструкцию в одном источнике;
  2. отключите необязательные Rules, Skills и Memory;
  3. начните новый чат;
  4. возвращайте источники по одному.

Если причина не найдена, соберите данные по инструкции «Обращение в поддержку».