# Yujin Forge -- Benutzerhandbuch

Sprachgesteuerter Entwicklungsassistent fuer React + NAC-3 Anwendungen. Entwickelt, damit ein Betreuer oder ein Kind, das programmieren lernt, ihn ohne Terminal bedienen kann.

## Willkommen

Yujin Forge macht drei einfache Dinge:

- Liest Dokumente vor (PDF, Word, HTML, MD, EPUB, CSV, Excel, Quellcode, txt, RTF).
- Nimmt eine Design-Spezifikation und generiert automatisch den Anwendungscode.
- Chattet mit einem KI-Assistenten, der dein Projekt kennt: Manifest lesen, SPEC durchsuchen, Komponenten bearbeiten, Commits machen.

## Installation

1. Installiere Node.js 18.17+ von nodejs.org.
2. Im Terminal:

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

3. Pruefe mit `yf --version`.
4. Fuehre `yf doctor` aus.

## Erste Ausfuehrung

    yf chat

Der Browser oeffnet das Yujin-Panel. Klicke auf Schluessel und lade die API-Schluessel. Jeder Schluessel wird EINMAL beim Eintragen angezeigt.

## Sprachbefehle

Yujin versteht Spanisch, Englisch, Portugiesisch, Franzoesisch, Deutsch, Italienisch, Japanisch, Chinesisch, Hindi und Arabisch.

Du sagst | Was passiert
--- | ---
"Oeffne Datei" | Oeffnet das Dokument.
"Weiter" / "Naechste" | Naechster Block.
"Suche Wort" | Sucht und liest den ersten Treffer.
"Lesezeichen hier als Name" | Setzt ein Lesezeichen.
"Zurueck zum Lesezeichen Name" | Kehrt zum Lesezeichen zurueck.
"Zusammenfassung" | Liest die letzten Bloecke nochmal.
"Oeffne die Anleitung" | Oeffnet dieses Handbuch in deiner Sprache.

## Spezifikations-Ingestion

Ziehe eine Spezifikationsdatei in das Panel. Ein violetter Bildschirm mit einem Kanji erscheint. Lass die Datei darauf fallen.

1. Yujin liest das Dokument.
2. Claude extrahiert Anforderungen, Entitaeten, Endpoints, Komponenten und eine Zusammenfassung.
3. Claude erstellt einen Datei-Plan.
4. Yujin zeigt dir den Plan. Sage "genehmigen".
5. Erstellt die Dateien in deinem Projekt.
6. Wenn etwas schiefgeht, sage "rueckgaengig".

## Fehlerbehebung

Das Mikrofon funktioniert nicht
  Der Browser fragt beim ersten Mal nach Erlaubnis. Klicke auf das Schloss neben der URL und aendere die Berechtigung.
Er versteht mich nicht
  Lade den OpenAI-Schluessel im Slot `openai`; Whisper handhabt Akzente besser.
Die Stimme klingt schlecht
  Lade den ElevenLabs-Schluessel fuer eine natuerlichere Stimme.
Ich will von vorne anfangen
  Schliesse Yujin. Loesche `~/.yujin-forge/`. Fuehre `yf chat` erneut aus.

## Support

Fuer Support: pablo@rpaforce.com.