# Yujin Forge -- Manuale utente

Assistente di sviluppo a voce per costruire applicazioni React + NAC-3. Pensato perche un accompagnatore o un bambino che impara a programmare possa usarlo senza terminale.

## Benvenuto

- Legge documenti ad alta voce (PDF, Word, HTML, MD, EPUB, CSV, Excel, codice sorgente, txt, RTF).
- Prende una specifica di design e genera il codice dell'applicazione automaticamente.
- Chatta con un assistente IA che conosce il tuo progetto: legge il manifest, cerca nello SPEC, modifica componenti, fa commit.

## Installazione

1. Installa Node.js 18.17+ da nodejs.org.
2. Nel terminale:

       npm install -g @yujin/forge-cli@alpha

3. Verifica con `yf --version`.
4. Esegui `yf doctor`.

## Primo avvio

    yf chat

Il browser apre il pannello Yujin. Clicca su Chiavi e carica le chiavi API. Ogni chiave si vede UNA SOLA VOLTA.

## Comandi vocali

Yujin capisce spagnolo, inglese, portoghese, francese, tedesco, italiano, giapponese, cinese, hindi e arabo.

Dici | Cosa succede
--- | ---
"Apri file" | Apre il documento.
"Prossimo" / "Continua" | Avanza al prossimo blocco.
"Cerca parola" | Cerca e legge la prima coincidenza.
"Segnalibro qui come nome" | Mette un segnalibro.
"Torna al segnalibro nome" | Torna al segnalibro.
"Riassunto" | Rilegge gli ultimi blocchi.
"Apri il manuale" | Apre questo manuale nella tua lingua.

## Acquisizione di specifiche

Trascina un file di specifica sul pannello. Appare una schermata viola con un kanji. Rilascia il file.

1. Yujin legge il documento.
2. Claude estrae requisiti, entita, endpoint, componenti.
3. Claude propone un piano di file da creare.
4. Yujin ti mostra il piano. Dici "approva".
5. Crea i file nel tuo progetto.
6. Se qualcosa va storto, dici "annulla".

## Risoluzione dei problemi

Il microfono non funziona
  Il browser chiede il permesso la prima volta. Clicca sul lucchetto vicino all'URL e cambia il permesso.
Non capisce
  Carica la chiave OpenAI nello slot `openai`.
La voce suona male
  Carica la chiave ElevenLabs.
Voglio ricominciare
  Chiudi Yujin. Cancella `~/.yujin-forge/`. Esegui `yf chat` di nuovo.

## Supporto

Supporto: pablo@rpaforce.com.