Le app sono interfacce HTML locali che si aprono in finestre Kucedr dedicate. Importa una cartella già compilata da Impostazioni → App, poi usa Apri sulla sua scheda. Le app possono usare l’SDK di Kucedr per accedere alle funzioni host esposte e ai dati della singola app.

L'attuale versione desktop non contiene cartelle sorgente di app incluse. Crea un'app in un progetto separato, poi importa la cartella compilata o registrala come app esterna di debug. Kucedr non offre un marketplace di app.

Workspace è una vista integrata nella finestra principale di Kucedr, non un'app installata da Impostazioni → App. Aprila dalla navigazione o da Impostazioni → Workspace per sfogliare i file dell'agente in un albero accanto a un visualizzatore ridimensionabile. Dal menu contestuale puoi creare, rinominare o eliminare elementi. I file Markdown si aprono nelle viste Text e Raw modificabili e si salvano automaticamente; gli altri file di testo e codice sono in sola lettura. Immagini, audio, video e PDF hanno visualizzatori dedicati. La voce Coding è contrassegnata come Soon e rimanda a Workspace.

Pacchetto Dell’App

Ogni app è una cartella con un entry point HTML locale. Il formato manifest.json consigliato è:

{
  "title": "Dashboard del progetto",
  "description": "Una dashboard dedicata al progetto attivo.",
  "metadata": {
    "version": "1.0.0",
    "category": "utility",
    "entry": "dist/index.html"
  }
}

Tutti i campi sono obbligatori e metadata.entry deve puntare a un file interno alla cartella dell’app. Kucedr può leggere anche un package.json standard con name, description e version non vuoti e un entry point HTML locale in main o exports.

Installare E Gestire Le App

Da Impostazioni → App puoi:

  • Importare una o più cartelle di app.
  • Sfogliare le app installate per titolo, descrizione e categoria.
  • Aprire un’app nella propria finestra con l’azione separata Apri.
  • Usare Dettagli per esaminare metadati, percorso locale e impostazioni della finestra. La scheda non è un collegamento.
  • Aggiornare il catalogo o aprire la directory delle app.
  • Eliminare un’app installata dopo una conferma.

I dettagli della finestra comprendono dimensioni, dimensioni minime, possibilità di ridimensionarla e ingrandirla. Le modifiche hanno effetto alla successiva apertura della finestra.

L’importazione copia la cartella in ~/.kucedr/apps/<id> escludendo node_modules. Una nuova importazione dello stesso ID sostituisce i file dell’app e conserva la directory data esistente. L’eliminazione di un’app installata rimuove definitivamente sia i file gestiti sia i dati associati.

Cartella Esterna Di Debug

La sezione Debug di Impostazioni → App può registrare una cartella esistente tramite il selettore nativo. Kucedr esegue direttamente l’entry point compilato senza copiare il sorgente nell’archivio gestito.

  • Compila l’app prima di registrarla; Kucedr non avvia un server di sviluppo.
  • Manifest ed entry point devono rimanere nella cartella selezionata.
  • L’ID non può coincidere con quello di un’app installata o di un’altra registrazione di debug.
  • La rimozione annulla la registrazione senza eliminare la cartella sorgente.
  • I dati dell’SDK rimangono in ~/.kucedr/apps/<id>/data e non vengono rimossi quando annulli la registrazione.

Parziale. Le Impostazioni non offrono ancora un controllo per abilitare o disabilitare le app installate.

Creare Un’App

Usa @kucedr/sdk per accedere in modo tipizzato alle API host esposte alle app, tra cui tema, spazio dati dell'app, funzionalità dei modelli e controlli della finestra. Segui Crea La Tua Prima App e consulta il Riferimento API Dell’SDK.

Puoi usare qualsiasi tecnologia browser che produca un file HTML locale, incluso HTML e TypeScript senza framework.

Sicurezza

Le app vengono eseguite nel runtime web sandboxed di Electron, ma il codice installato può comunque accedere ad API potenti di Kucedr. Installa solo app provenienti da fonti affidabili.

Lo stato e i file di ogni app sono isolati, ma vengono salvati in chiaro. Non inserire password o chiavi API nello spazio dati dell’app. Kucedr non espone le credenziali dei provider alle app.