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.startparams:{ mode?: "local"|"remote", workspace?: string }wizard.nextparametrar:{ sessionId, svara?: { stepId, värde? } }wizard.cancelparams:{ sessionId }wizard.statusparams:{ sessionId }config.schemaparams:{}
- Wizard:
{ sessionId, klar, steg?, status?, fel? } - Konfigschema:
{ schema, uiHints, version, generatedAt }
UI-ledtrådar
uiHintsnycklade 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.