# Yujin Forge -- Manuel utilisateur

Assistant de developpement vocal pour construire des applications React + NAC-3. Concu pour qu'un accompagnant ou un enfant qui apprend a coder puisse l'utiliser sans toucher au terminal.

## Bienvenue

Yujin Forge fait trois choses simples :

- Lit des documents a voix haute (PDF, Word, HTML, MD, EPUB, CSV, Excel, code source, txt, RTF).
- Prend une specification de design et genere le code de l'application automatiquement.
- Discute avec un assistant IA qui connait ton projet : lit le manifest, cherche dans le SPEC, edite des composants, fait des commits.

## Installation

1. Installe Node.js 18.17 ou superieur depuis nodejs.org.
2. Dans un terminal :

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

3. Verifie avec `yf --version`.
4. Execute `yf doctor` pour verifier l'environnement.

## Premiere execution

    yf chat

Le navigateur ouvre le panneau Yujin. Clique sur Cles (coin superieur droit) et charge les cles d'API. Chaque cle apparait UNE SEULE FOIS ; ensuite tu peux la remplacer mais pas la relire.

## Commandes vocales

Clique sur le micro et dis une de ces commandes. Yujin comprend espagnol, anglais, portugais, francais, allemand, italien, japonais, chinois, hindi et arabe.

Tu dis | Ce qui se passe
--- | ---
"Ouvre le fichier" | Ouvre le document.
"Suivant" / "Continue" | Avance au bloc suivant.
"Cherche mot" | Cherche et lit la premiere coincidence.
"Marque ici comme nom" | Place un signet.
"Retourne au signet nom" | Revient au signet.
"Resume" | Relit les derniers blocs.
"Ouvre le manuel" | Ouvre ce manuel dans ta langue.

## Ingestion de specifications

Glisse un fichier de specification sur le panneau. Un ecran violet avec un kanji apparait. Depose le fichier dessus.

1. Yujin lit le document.
2. Demande a Claude d'extraire exigences, entites, endpoints, composants et un resume.
3. Demande a Claude un plan de fichiers a creer.
4. Te montre le plan. Tu dis "approuve" si c'est bon.
5. Cree les fichiers dans ton projet.
6. Si quelque chose a foire, dis "annuler" et Yujin revert.

## Depannage

Le micro ne marche pas
  Le navigateur demande la permission au premier essai. Si tu l'as refusee par erreur, clique sur le cadenas a cote de l'URL et change la permission.
Il ne me comprend pas
  Essaie un autre fournisseur. Charge la cle OpenAI dans le slot `openai`.
La voix sonne mal
  Yujin utilise la voix Google par defaut. Pour une voix plus naturelle, charge la cle ElevenLabs.
Je veux recommencer
  Ferme Yujin. Efface `~/.yujin-forge/`. Relance `yf chat` et recharge les cles.

## Support

Pour le support, ecris a pablo@rpaforce.com.