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

Instale Node.js 18.17 ou superior de nodejs.org.
Em um terminal:
```
npm install -g @yujin/forge-cli@alpha
```
Verifique com yf --version.
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.

O Yujin le o documento.
Pede ao Claude que extraia requisitos, entidades, endpoints, componentes e um resumo.
Pede ao Claude um plano de arquivos a criar.
Mostra o plano. Voce diz "aprovar" se estiver bom.
Cria os arquivos na pasta do projeto.
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.