CodeNomad/docs/help/ru/opencode.md
Pascal André 7292e4e3b1
chore(opencode): recommend qualified runtime 2.2.6 (#1379)
## Summary

Recommend OpenCode **2.2.6** after the scheduled-wake correction (#1350)
and split assistant storage support (#1359) were qualified together and
merged. Keep the technical minimum and client/schema/plugin pins at
**2.2.3**. This changes the displayed qualification target, not the
service, user configuration or capability-based admission policy.

Update the runtime/update-status regressions, server guide, architecture
references and installation/setup/server/troubleshooting help in all ten
locales. Describe the host-provided Effect/Schema runtime independently
of a release number.

## Qualification provenance

The exact integrated source `735a9714c0d2bf0227dbb19871064f11df9a894b`
passed the final campaign. After merging #1350, `git diff
735a9714c0d2bf0227dbb19871064f11df9a894b
4d6a517602` was empty: actual merged dev
is byte-identical to the tested tree. Detailed gatekeeper evidence:
https://github.com/NeuralNomadsAI/CodeNomad/pull/1350#issuecomment-6712960223.

- **335/335** combined pruning/wake/affected Missions regressions;
server/UI typechecks; server and all plugin builds.
- **18 isolated native invocations**, all successful: context, full
foundation and retained-product cold at/in on **2.2.6 and minimum
2.2.3**; default pruning; split pruning with real UI and reload; split
Design gallery; native migrations **2.2.3 → 2.2.6** and **2.2.5 →
2.2.6**; host plugin bindings, Code Mode, automation, memory, Goal,
Missions contract and recursive/parallel trajectory.
- The original exact-tag/API/package review and its unchanged-contract
evidence remain applicable to the same official 2.2.6 CLI (SHA256
`98cb0aa854c7c015cf6febafa7afb872c359bfe5a823a526f3b4fd347a9e9677`).
Previously reproduced cross-version baseline fixture failures are not
claimed fixed; optional third-party MCP pooling and the broader
experimental VM remain outside these native journeys.
- This recommendation change passes **32/32** runtime/update-status
tests, server typecheck and **31/31** help checks over ten locales.
Verified exact recommendation-only substitutions across all 40
translated help pages and the four guide/reference files; package
manifests and lockfile are unchanged.

All native checks used private synthetic state, isolated official CLIs
and local providers. No shared daemon, user database, user configuration
or production provider account was changed.
2026-11-07 22:06:31 +01:00

19 KiB
Raw Permalink Blame History

Настройка OpenCode

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

Выбор или установка CLI

  1. Откройте Настройки → OpenCode и используйте карточку Бинарник OpenCode под Версия OpenCode для выбора исполняемого файла.
  2. Оставьте выбранной автоматическую запись, чтобы предпочитать PATH сервера (если там не старый OpenCode), затем его пользовательскую установку OpenCode 2 через npm; либо используйте Выбрать бинарник… или введите путь и нажмите Добавить.
  3. Нажмите Проверить состояние и обновления. Если OpenCode отсутствует, выберите Установить и запустить OpenCode; сначала проверьте хост и область установки.
  4. Если настройка предлагает Подключиться и продолжить, используйте после устранения указанной проблемы.

Установка использует среду Node, на которой работает сервер CodeNomad, и её npm (на компьютере — встроенный Node Electron или Node из комплекта Tauri) для стандартной пользовательской установки, общей с другими клиентами. Установить для пользователя и настроить PATH меняет настройку терминала этого пользователя; после этого откройте новый терминал. Браузер подключается к серверу CodeNomad: выбор файла и исполняемого файла относится к серверу, не к устройству просмотра.

Когда первым в PATH стоит более старый OpenCode, предлагаемое действие зависит от способа его установки. Для OpenCode 1.x, установленного через npm, Заменить OpenCode {version} на OpenCode 2 запрашивает подтверждение, удаляет этот пакет npm и устанавливает OpenCode 2 в ту же папку npm; папка данных OpenCode сохраняется, а OpenCode 2 сам импортирует беседы 1.x. Старый или неработоспособный OpenCode, установленный иначе (winget, Homebrew, вручную), никогда не изменяется: Установить OpenCode 2 для CodeNomad устанавливает OpenCode 2 в пользовательскую папку npm рядом с ним, и затем CodeNomad использует эту копию. Если сама эта старая команда находится в пользовательской папке npm (например, ссылка в ~/.local/bin) или эта папка недоступна для записи, настройка вместо этого действия объясняет причину: переместите или переименуйте команду либо исправьте права на папку, затем выберите Проверить состояние и обновления. Команда opencode в терминале может по-прежнему запускать старую версию. Явно выбранный пользовательский исполняемый файл никогда не заменяется.

Установленный исполняемый файл и работающая служба могут иметь разные версии. Сравните Установленная версия с Работающая служба в карточке Версия OpenCode, не предполагая, что выбор другого файла заменил живой демон; Сведения о версиях перечисляет минимальную и рекомендуемую версии. Если установка занята или файл заблокирован, дождитесь освобождения установщиком или процессом и проверьте состояние перед повтором; не запускайте конкурирующие установщики.

Требуемые, рекомендуемые и непроверенные версии

Классификация Текущее требование Значение
Минимум OpenCode 2.2.3 Инструмент генерации изображений, который используют настройки Изображения и расширение Design, а также правильный порядок выполнения задач JavaScript в Code Mode и нативный формат воспроизведения и сжатия; беседы, сохранённые более ранними версиями, остаются доступными после обновления.
Рекомендуемая OpenCode 2.2.6 Проверенная цель, отличная от технического минимума.
Непроверенная Новая или пользовательская версия, не прошедшая полную проверку Не отклоняется лишь из-за отсутствия тестирования; проверяются реальные API-контракты подключённой службы.

Подключённая служба должна предоставлять необходимые контракты сессий, разрешений, форм, входящих и окружения сессий. Нативное расписание Миссий также проверяет API расписаний, комплект плагина/провайдера и действующую настройку experimental.schedules. Доступность определяется этими используемыми возможностями, включая совместимые будущие версии. Если настройка сообщает о неподдерживаемой работающей службе, выберите/установите поддерживаемый CLI и выполните явный перезапуск общей службы, когда будете готовы.

Хост, WSL и общая служба

В Windows выбранный исполняемый файл WSL работает в своём дистрибутиве. Устанавливайте/обновляйте его там и используйте пути этого дистрибутива. Подключение WSL зависит от перенаправления localhost Windows. Windows CLI и WSL CLI — не взаимозаменяемые среды выполнения.

OpenCode владеет глобальной регистрацией службы, сессиями, сообщениями и базой данных. CodeNomad не создаёт отдельную базу OpenCode для окна или проекта. Закрытие вкладки проекта закрывает этот проект в CodeNomad; сессии продолжают работать в OpenCode и снова появляются при повторном открытии проекта. CodeNomad никогда не выгружает нативные Location. Закрытие всего окна, выход или перезагрузка сохраняют подключения проектов для восстановления; ни эти действия, ни завершение серверной части не останавливают общий демон. См. проекты.

Запускать OpenCode при старте системы

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

Система Что запускает OpenCode После сбоя
Windows Скрытая запланированная задача для вашей учётной записи, без пароля и прав администратора. Исполняемый файл WSL запускается в своём дистрибутиве. Не перезапускается.
macOS LaunchAgent. Перезапускается macOS.
Linux Пользовательская служба systemd, запускаемая при входе, без включения linger. Перезапускается systemd.

Выключение удаляет только эту задачу, LaunchAgent или службу; работающий OpenCode продолжает работать. Если параметр не удаётся изменить, под ним появляется ошибка: выберите нативную программу OpenCode, а не скрипт-обёртку, или проверьте планировщик заданий или пользовательские службы системы и повторите попытку. Недоступно в этой системе отображается, когда сервер CodeNomad работает внутри WSL или в другой системе без запуска при входе.

Обновление, перезапуск и перезагрузка

  1. В Настройки → OpenCode выберите Проверить состояние и обновления.
  2. Для замены установленных файлов CLI выберите Обновить до OpenCode {version}, когда предложено. Дождитесь завершения.
  3. Проверьте статус работающей службы. Используйте Перезапустить общую службу, только если хотите активировать выбранную установку для всех подключённых клиентов.
  4. Для перезапуска процесса без установки раскройте Устранение неполадок, выберите Перезапустить службу OpenCode и подтвердите.
Действие Область и эффект Безопасное восстановление
Обновить CLI Меняет поддерживаемый установленный исполняемый файл; не перезапускает работающий демон неявно. После сбоя проверьте установленную и работающую версии; повторяйте явно только после устранения ошибки.
Перезапустить службу Заменяет общий процесс и прерывает активную работу всех подключённых клиентов OpenCode; история сессий остаётся. Исправные работающие нативные расписания Миссий восстанавливаются автоматически; проверьте ожидающие проходы и любую паузу, ошибку или неопределённость. Существующие ежедневные записи требуют действия Возобновить. Разовые разговоры и их элементы восстановления проверяйте отдельно; см. Миссии.
Перезагрузить конфигурацию OpenCode Сохраняет процесс, но пересоздаёт все загруженные Location для всех клиентов. Отменяет ожидающие разрешения/формы и закрывает терминалы/фоновые команды; активная работа может прерваться. Перепроверьте ресурсы и ожидающую работу после перезагрузки. Не повторяйте запрос или изменение лишь из-за потерянного ответа.

Используйте Перезагрузить конфигурацию OpenCode (в Устранение неполадок, если работающая служба это поддерживает) явно, если сохранённая конфигурация или установленный плагин остаются недоступны и прерывание допустимо. Это не безобидное обновление отображения. CodeNomad не использует старый выбранный CLI для понижения версии нового работающего демона.

Окружение сессии

  1. Откройте Настройки → Расширенные и раскройте Переменные окружения.
  2. Добавьте, измените или удалите переопределения профиля; каждое изменение сохраняется сразу.
  3. Отправьте следующий запрос, пользовательскую команду или запрос оболочки сессии через CodeNomad для применения текущего окружения к разговору.

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

Окружение управляет последующими локальными запусками оболочки в нативной сессии. Уже работающие процессы сохраняют окружение. Оно не перенастраивает провайдеров, MCP/LSP-серверы, независимые терминалы или фоновые оболочки только Location. Каждый запрос очереди не фиксирует собственное окружение, а другой клиент OpenCode может заменить окружение той же сессии. Не предполагайте, что дочерние сессии, полностью созданные внутри OpenCode, получают обновление CodeNomad при отправке.

Разрешённые переменные также передаются при запуске остановленной службы; подключение к существующему демону не меняет окружение его процесса. В WSL значения объединяются с Linux-окружением, а не Windows PATH/HOME. Изменение переопределений не перемещает базу OpenCode или регистрацию службы.

Редактирование нативных файлов конфигурации

  1. Откройте Настройки → Файлы конфигурации и выберите Файл.
  2. Проверьте показанный путь, внесите правки и нажмите Сохранить.
  3. Используйте Перезагрузить для повторного чтения файла; это не Перезагрузить конфигурацию OpenCode.

Этот редактор предоставляет только перечисленные глобальные файлы opencode.json и opencode.jsonc в каталоге .config/opencode пользователя сервера CodeNomad. Это не редактор произвольных файлов, не выбор проектной конфигурации и не гарантия чтения файла демоном WSL/с пользовательскими путями обнаружения. Проверьте цель по показанному пути; для других корней используйте инструменты самого демона.

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

Специальные процедуры настройки описаны в разделах Интеграции, Провайдеры, Миссии и документации OpenCode.