​

Онбординг + Протокол конфигурации

​

Компоненты

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

​

RPC шлюза Gateway

• wizard.start params: { mode?: "local"|"remote", workspace?: string }
• wizard.next params: { sessionId, answer?: { stepId, value? } }
• wizard.cancel params: { sessionId }
• wizard.status params: { sessionId }
• config.schema params: {}

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

​

Подсказки UI

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

​

Примечания

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