@kucedr/sdk è il ponte tipizzato tra il tuo codice e Kucedr. Puoi usarlo per creare un’app con un’interfaccia dedicata che si apre in una finestra di Kucedr, oppure per collegare un processo Node.js separato all’API locale.
L’SDK non dipende da un framework. Un’app integrata può usare HTML e TypeScript, React, Vue, Svelte o qualsiasi tecnologia browser che produca un file HTML locale.
Scegli Una Modalità Di Integrazione
| Modalità | Ideale per | Connessione |
|---|---|---|
| App integrata | Dashboard, editor, studi creativi e flussi ripetibili con un’interfaccia dedicata | Kucedr inserisce un bridge preload tipizzato nella finestra dell’app. |
| Client Node.js esterno | Script, strumenti da riga di comando e altre app desktop locali | connect() usa l’API autenticata su http://127.0.0.1:8765. |
Le app integrate possono usare funzioni dell’host come tema, spazio dati isolato, generazione di immagini configurata e controlli nativi della finestra. Le API protette restano soggette all’autorizzazione dell’host: per esempio, Coder e terminale sono disponibili solo alle app Kucedr registrate.
Il client esterno espone intenzionalmente una superficie più piccola: impostazioni supportate, operazioni sui file del workspace, eventi di modifica, ping() e close(). Non espone le API integrate per finestre, modelli, Coder o terminale.
Stato Del Pacchetto
Il codice sorgente e le dichiarazioni TypeScript dell’SDK si trovano nel repository di Kucedr in packages/sdk. Il pacchetto è predisposto come @kucedr/sdk, richiede Node.js 18 o successivo e non è ancora disponibile nel registro npm pubblico. Fino alla pubblicazione, installalo da un checkout locale di Kucedr:
npm install /percorso/assoluto/kucedr/packages/sdk
Le app sviluppate nel repository di Kucedr usano invece una dipendenza workspace locale:
{
"dependencies": {
"@kucedr/sdk": "file:../../../packages/sdk"
}
}
Cosa Puoi Creare
- Una dashboard di progetto che segue il tema chiaro o scuro di Kucedr.
- Uno studio multimediale che usa il modello immagini configurato senza ricevere le credenziali del provider.
- Un visualizzatore per i file di testo e multimediali supportati nel workspace.
- Uno strumento locale di automazione o reportistica che legge il workspace tramite il bridge HTTP autenticato.
- Un’interfaccia dedicata con stato JSON isolato e file di proprietà dell’app.
Inizia A Sviluppare
Segui Crea La Tua Prima App per vedere app browser minima, manifest, build e importazione. Consulta il Riferimento API Dell’SDK per scegliere il namespace giusto e capire quali funzioni sono disponibili solo in modalità integrata.
Le app Kucedr vengono eseguite nel runtime web sandboxed di Electron, ma il codice installato può comunque accedere ad API potenti dell’host. Installa solo cartelle provenienti da fonti affidabili e non salvare password o chiavi API nello spazio dati dell’app.