Hoppa till huvudinnehåll

Introduktion + konfigprotokoll

Syfte: delade ytor för introduktion och konfiguration över CLI, macOS-app och webbgränssnitt.

Komponenter

  • Guide-motor (delad session + uppmaningar + introduktionstillstånd).
  • CLI-introduktion använder samma guideflöde som UI-klienterna.
  • Gateway-RPC exponerar endpoints för guide och konfigschema.
  • macOS-introduktion använder modellen för guidesteg.
  • Webbgränssnittet renderar konfigformulär från JSON Schema + UI-ledtrådar.

Gateway RPC

  • wizard.start params: { mode?: "local"|"remote", workspace?: string }
  • wizard.next parametrar: { sessionId, svara?: { stepId, värde? } }
  • wizard.cancel params: { sessionId }
  • wizard.status params: { sessionId }
  • config.schema params: {}
Svar (form)
  • Wizard: { sessionId, klar, steg?, status?, fel? }
  • Konfigschema: { schema, uiHints, version, generatedAt }

UI-ledtrådar

  • uiHints nycklade efter sökväg; valfri metadata (label/help/group/order/advanced/sensitive/placeholder).
  • Känsliga fält renderas som lösenordsinmatningar; inget maskeringslager.
  • Schema-noder som inte stöds faller tillbaka till rå JSON-redigerare.

Noteringar

  • Detta dokument är den enda platsen för att följa protokollrefaktoreringar för introduktion/konfiguration.