# Yujin Forge -- Manual do usuario

Assistente de desenvolvimento por voz para construir aplicacoes React + NAC-3. Projetado para que um acompanhante ou uma crianca aprendendo a programar possa usa-lo sem tocar no terminal.

## Boas-vindas

O Yujin Forge faz tres coisas simples:

- Le documentos em voz alta (PDF, Word, HTML, MD, EPUB, CSV, Excel, codigo-fonte, txt, RTF).
- Pega uma especificacao de design e gera o codigo da aplicacao automaticamente.
- Conversa com um assistente de IA que conhece seu projeto: le manifest, busca no SPEC, edita componentes, faz commits.

## Instalacao

1. Instale Node.js 18.17 ou superior de nodejs.org.
2. Em um terminal:

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

3. Verifique com `yf --version`.
4. Execute `yf doctor` para revisar o ambiente.

## Primeira execucao

    yf chat

O navegador abre com o painel do Yujin. Clique em Chaves (canto superior direito) e carregue as chaves de API. Cada chave aparece UMA SO VEZ ao inseri-la; depois pode ser substituida mas nao lida.

## Comandos por voz

Clique no microfone e diga um destes comandos. O Yujin entende espanhol, ingles, portugues, frances, alemao, italiano, japones, chines, hindi e arabe.

Voce diz | O que acontece
--- | ---
"Abre o arquivo" | Abre o documento.
"Proximo" / "Continuar" | Avanca ao proximo bloco.
"Procurar palavra" | Busca e le a primeira coincidencia.
"Marca aqui como nome" | Coloca um marcador.
"Voltar a marca nome" | Volta a marca.
"Resumo" | Le os ultimos blocos.
"Abre o manual" | Abre este manual no seu idioma.

## Ingestao de especificacoes

Arraste um arquivo de especificacao para o painel. Uma tela roxa com um kanji aparece. Solte o arquivo nela.

1. O Yujin le o documento.
2. Pede ao Claude que extraia requisitos, entidades, endpoints, componentes e um resumo.
3. Pede ao Claude um plano de arquivos a criar.
4. Mostra o plano. Voce diz "aprovar" se estiver bom.
5. Cria os arquivos na pasta do projeto.
6. Se algo deu errado, diga "desfazer" e o Yujin reverte.

## Solucao de problemas

O microfone nao funciona
  O navegador pede permissao na primeira vez. Se voce rejeitou por engano, clique no cadeado ao lado da URL e mude a permissao.
Nao entende o que digo
  Tente outro provedor. Carregue a chave do OpenAI no slot `openai`; o Whisper lida melhor com sotaques sul-americanos.
A voz soa mal
  O Yujin usa a voz do Google por padrao. Para uma voz mais natural, carregue a chave do ElevenLabs.
Quero comecar do zero
  Feche o Yujin. Apague `~/.yujin-forge/`. Execute `yf chat` de novo e recarregue as chaves.

## Suporte

Para suporte, escreva para pablo@rpaforce.com.