Протокол настройки и конфигурации

Назначение: общие поверхности настройки + конфигурации для CLI, macOS приложения и веб-UI.

Компоненты

  • Движок мастера (общая сессия + промпты + состояние настройки).
  • CLI настройка использует тот же поток мастера, что и UI клиенты.
  • Gateway RPC предоставляет эндпоинты мастера + схемы конфигурации.
  • macOS настройка использует модель шагов мастера.
  • Веб-UI рендерит формы конфигурации из JSON Schema + подсказок UI.

Gateway RPC

  • wizard.start параметры: { mode?: "local"|"remote", workspace?: string }
  • wizard.next параметры: { sessionId, answer?: { stepId, value? } }
  • wizard.cancel параметры: { sessionId }
  • wizard.status параметры: { sessionId }
  • config.schema параметры: {}

Ответы (форма)

  • Мастер: { sessionId, done, step?, status?, error? }
  • Схема конфигурации: { schema, uiHints, version, generatedAt }

Подсказки UI

  • uiHints с ключами по пути; опциональные метаданные (label/help/group/order/advanced/sensitive/placeholder).
  • Чувствительные поля рендерятся как поля ввода пароля; нет слоя редактирования.
  • Неподдерживаемые узлы схемы откатываются к необработанному редактору JSON.

Примечания

  • Этот документ - единственное место для отслеживания рефакторингов протокола для настройки/конфигурации.