Налаштування SDK та керування розширеннями

Під час запуску sima-cli sdk setup виберіть додаткові служби SDK, розширення браузерного VS Code та джерело встановлення Model Compiler.

Довідка команди: sima-cli sdk setup

Явне ввімкнення Edgematic Studio

Типове налаштування не показує запит Edgematic Studio, не встановлює Studio та не публікує його порт. Це також стосується -y і --noninteractive.

Використовуйте --edgematic-studio, щоб встановити Studio та опублікувати його порт. Використовуйте --edgematic-studio-port, щоб опублікувати лише порт для подальшого ручного встановлення.

Вибір розширень браузерного VS Code

Інтерактивне налаштування пропонує розширення Neat, Codex і Claude. Вибирайте їх клавішею Space та підтверджуйте клавішею Enter. Спочатку жодне не вибране; відсутність вибору пропускає встановлення, а вже встановлені невибрані розширення залишаються.

Для автоматизації встановіть усі три без списку вибору:

sima-cli sdk setup --noninteractive --all-extensions

--all-extensions пропускає лише вибір розширень. Для пропуску інших запитань використовуйте --noninteractive. Він також встановлює розширення під час повторного використання наявного контейнера SDK. Без нього -y і --noninteractive пропускають додаткові розширення, якщо їх не запитує застаріле налаштування SIMA_CLI_INSTALL_CODEX_EXTENSION. --all-extensions не можна поєднувати з --minimal; він не вмикає Edgematic Studio та не змінює вибір Model Compiler.

Версії розширень браузерного VS Code

sima-cli встановлює точні версії Codex і Claude та закріплює їх від автоматичних оновлень. Повторне налаштування замінює іншу версію; відповідна версія зберігається та закріплюється без повторного завантаження. Образи SDK можуть оголошувати перевірені версії в /etc/sima-neat/vscode-extensions.json:

{
  "schema_version": 1,
  "extensions": {
    "openai.chatgpt": "26.5825.51511",
    "anthropic.claude-code": "2.1.266"
  }
}

Маніфест сам по собі не означає згоду користувача на встановлення. Схема версії 1 вимагає точних версій для обох ID. Старі образи без маніфесту використовують Codex 26.5825.51511 і Claude 2.1.266 як резервні версії сумісності. Нечитабельний або недійсний маніфест повідомляє про помилку та пропускає встановлення розширень, але решта налаштування продовжується. Невдалі команди встановлення Codex або Claude повторюються до трьох разів із тією самою точною версією та звичайною перевіркою TLS.

Перевизначення змінними середовища мають пріоритет:

Змінна	Поведінка
SIMA_CLI_CODEX_EXTENSION_ID	Перевизначає Codex через publisher.extension@exact-version; порожнє значення вимикає його, якщо не використано --all-extensions.
SIMA_CLI_CLAUDE_EXTENSION_ID	Перевизначає Claude через publisher.extension@exact-version; порожнє значення вимикає його, якщо не використано --all-extensions.
SIMA_CLI_INSTALL_CODEX_EXTENSION	Автоматично вибирає встановлення розширень без списку вибору.

Вбудований ID розширення без версії використовує закріплену версію SDK або типову версію. Інші ID потребують явної версії. --minimal пропускає встановлення додаткових розширень. Налаштування перевіряє встановлені версії, записує прапорець metadata.pinned для кожного вибраного розширення та перезапускає браузерний VS Code; після цього перезавантажте відкриту вкладку браузера.

Джерело встановлення Model Compiler

Налаштування шукає model-compiler-arm64.zip або model-compiler-amd64.zip лише в поточному робочому каталозі відповідно до архітектури контейнера SDK. Розпаковані теки, батьківські каталоги, ZIP у робочому просторі та інша архітектура не перевіряються.

За наявності дійсного локального ZIP налаштування пропонує локальне встановлення, онлайн-встановлення або пропуск. Без дійсного ZIP пропонується онлайн-встановлення або пропуск; типова дія Enter — пропуск.

Прапорці	Є локальний ZIP	Немає дійсного локального ZIP
--noninteractive	Локальне встановлення	Пропуск
--noninteractive -y	Локальне встановлення	Онлайн-встановлення
-y	Локальне встановлення	Онлайн-встановлення

Онлайн-встановлення без участі користувача потребує -y. Для застарілих джерел SDK автентифікуйтеся на хості через sima-cli login. --minimal, --no-model-compiler і --no-model-sdk завжди пропускають встановлення.

Офіційний ZIP має містити install_modelsdk_wheels.sh, source.json, manifest.txt і вміст пакетів у корені та відповідати версії компілятора, вибраній для SDK. Архів розпаковується в тимчасове сховище хоста та копіюється до тимчасового сховища Linux-контейнера, тож передбачте місце для обох копій. Тимчасові дані видаляються після успіху чи збою, а вихідний ZIP зберігається. Невдале локальне встановлення ніколи не переходить на онлайн-джерело. Системні пакети та передумови Python усе ще можуть потребувати доступу до мережі.