Нативные интеграции

CodeNomad предоставляет нативные подключения MCP, активацию плагинов, навыки и пользовательские команды OpenCode. Они работают на хосте выполнения. Это отдельно от изолированных расширений панели и SideCars.

Выбор нужного управления

Сначала настройте/установите интеграцию поддерживаемыми средствами конфигурации и CLI OpenCode. Установка пакета, объявление источника, включение правила, подключение службы и доступность инструментов — отдельные шаги. Нативные интеграции имеют привилегии своего процесса с учётом разрешений OpenCode; это не изолированные HTML-панели.

Подключение и отключение MCP

1. Настройте MCP-сервер на хосте выполнения OpenCode по документации OpenCode MCP.
2. Откройте Статус → MCP-серверы для проекта.
3. Используйте переключатель у сервера для подключения или отключения. Дождитесь установившегося индикатора соединения.

Переключатель вызывает нативный API подключения для указанной Location, а не локальный установщик устройства или настройку видимости окна. Другие клиенты этой Location могут наблюдать изменение подключения. Отключение не удаляет объявление сервера и не деинсталлирует исполняемый файл.

Если сервер не виден, проверьте активную Location и её нативную конфигурацию. При сбое подключения изучите конфигурацию сервера, необходимое окружение и нативную процедуру аутентификации; не предполагайте, что переключатель завершает OAuth. Перепроверьте статус после переподключения. Используйте явную перезагрузку конфигурации только при необходимости с учётом прерываний, описанных в настройке OpenCode.

Активация плагинов глобально или для проекта

1. Установите/объявите нативный плагин в OpenCode; затем откройте Статус → Плагины.
2. Наведите указатель на имя или установите фокус для просмотра источника, сбоя выполнения и целевой конфигурации.
3. Осознанно переключите Глобально или Проект. Дождитесь записи и используйте Обновить управление плагинами, если состояние неясно.
4. Для плагина, установленного из пакета, используйте значок рядом с его именем. Его меню называет точную операцию: Проверить обновления пакета или Обновить его, когда найдена более новая версия.

Глобальная область — обнаруженная глобальная конфигурация подключённого демона. Проектная — конфигурация внутри активной Location, а не унаследованный родительский файл. Более позднее правило проекта может переопределить глобальное; глобальный переключатель всё равно показывает глобальное правило, не выдавая его за итоговое состояние проекта. Без проектного правила проект наследует разрешённое глобальное состояние.

Переключатели добавляют точные правила активации с сохранением объявлений источников и остальной конфигурации. Они не редактируют параметры плагина, не устанавливают пакеты и не удаляют файлы. Встроенные плагины OpenCode не предлагаются как пользовательские переключатели активации. Проект недоступен, если его цель нельзя безопасно отделить от глобальной или она вышла бы за активную Location.

Обновление пакета меняет этот пакет в общем кэше OpenCode для каждой Location, где он используется, как указано в его подсказке; оно не меняет правила активации, не перезапускает OpenCode и не перезагружает конфигурацию. У локальных, встроенных и предоставленных SDK плагинов нет действия с пакетом. Пакет, давший сбой до сообщения ID своего плагина, показывается по имени пакета: сбой описан в подсказке, действия проверки/обновления есть, а переключателей активации нет. О неудачной проверке или обновлении сообщается, и они никогда не повторяются автоматически.

Поверхность сохраняет последний снимок, пока скрыта, и перепроверяет его при показе, нативных изменениях/переподключении и явном обновлении. Сохранённое правило и фактическая доступность выполнения могут кратко различаться. Если плагин недоступен, изучите подсказку и нативную конфигурацию перед Перезагрузить конфигурацию OpenCode; действие влияет на все загруженные Location, не только этот плагин. Некорректная конфигурация или конкурентная правка не перезаписывается молча: устраните проблему, обновите и явно повторите.

Прикрепление навыков

1. Введите @ в поле ввода, найдите доступные навыки Location и выберите один.
2. Проверьте удаляемое вложение рядом с файлами/агентами; удалите до отправки, если оно не нужно.
3. Отправьте запрос. Названия навыков остаются с отправленным сообщением.

Выбор прикрепляет нативный ID навыка и удаляет токен @query; инструкции не вставляются в видимый черновик. Отправка очищает выбор поля ввода, не инструкции, уже сохранённые OpenCode с сообщением. Удаление вложения не отменяет прежнюю отправку.

Доступность навыков определяется Location разговора, не глобальным каталогом CodeNomad. Если список не загружается, закройте и снова откройте выбор для повтора; если пуст, проверьте нативное обнаружение/конфигурацию. См. документацию навыков OpenCode и разговоры.

Выполнение пользовательских команд

1. Введите / в поле ввода и выберите доступную нативную команду.
2. Укажите аргументы и проверьте Агент, Модель и Мышление перед отправкой, насколько применимо к команде.
3. Если подтверждение неясно, проверьте итоговый разговор вместо многократной отправки.

Команды обнаруживаются в OpenCode для активной Location. Их собственное нативное определение может выбирать поведение выполнения; меню — не установщик пакетов и не неограниченный редактор конфигурации. CodeNomad применяет окружение сессии профиля перед отправкой нативной пользовательской команды; сбой обновления окружения блокирует отправку. /btw — отдельная временная процедура вопроса CodeNomad, а не обычная пользовательская команда.

Определения команд и наследование нативной конфигурации см. в документации команд OpenCode. После изменений конфигурации сначала обновите/снова откройте нужную поверхность; используйте явную перезагрузку конфигурации только при необходимости для среды выполнения. Никогда не повторяйте возможно допущенную команду лишь для обновления её отображения.