Repository navigation
Atualização principalmente de polimento e documentação sobre a v1.2.0. Todos os bugs reportados em uso real foram resolvidos. Sem mudanças nos pesos do modelo — continue usando o mesmo .gguf da v1.1.
Há também algumas features pequenas (modo pensador, hint animado, manual completo) que tecnicamente justificariam um MINOR bump (v1.3.0); mantivemos como v1.2.1 por opção de packaging.
📖 Documentação (nova)
- Manual completo bilíngue (pt-BR + EN) — 17 seções por idioma cobrindo instalação, todas as funções (memória, upload, RAG, voz, multilíngue, modo pensador, OCR), configurações avançadas, troubleshooting completo, privacidade e licenças. Com 4 prints reais e PDF de exemplo para testar o upload.
- README ganhou seção "📖 Documentação" linkando todos os docs do projeto.
- Model card no HuggingFace atualizado para refletir a plataforma v1.2 e linkar o manual.
✨ Pequenas features
- 💭 Modo pensador (toggle em Configurações) — mostra o raciocínio do Qwen3 num bloco colapsável "💭 Pensamento". Desligado por padrão (deixa as respostas mais lentas na CPU).
- 🌀 Hint animado de "pensando" — em vez de "Assistente" com bolha vazia, frases rotativas como "Arandu está filosofando…", "Ouvindo o conselho dos antigos…", "Pensando offline, na CPU mesmo…". Visualmente discreto (cor muted, itálico).
- 🌐 Multilíngue ampliado — captura de memória ("meu nome é…", "lembre-se que…") agora reconhece em pt/en/es/fr/de.
- 🎓 Script
regenerar_nano_1.2.ps1para gerar uma "Arandu Nano 1.2" com corpus de calibração 3× maior (juntandotreino/imatrix/calibracao_pt.txt+rag/docs/*.txt).
🐛 Correções
Voz (TTS — Piper)
- Voz lia letras isoladas como caos (
D.virava "QUÊ"): agora pronuncia o nome da letra em pt-BR (D.→"dê,",B.→"bê,"etc.). - Voz mais rápida:
ttsFeedagora agrupa sentenças curtas em lotes de ~80 chars antes de enviar ao Piper. Resposta de 3 sentenças que gerava 3 spawns (~900ms de overhead) agora gera 1 spawn (~300ms). ~3× menos overhead. - Sílabas perdidas em palavras como "direito" → "direto": o
[D001]da memória vazava no texto cru e deformava palavras vizinhas. Agora a limpeza acontece também no caminho da voz. - Quebra de buffer segura: se uma frase muito longa não tem pontuação final, agora a quebra sempre cai em espaço entre palavras (nunca dentro de palavra).
Saída do modelo
[D001],[M001]na resposta: códigos internos da memória apareciam para o usuário. Agora removidos automaticamente (e o prompt foi reforçado para o modelo nem gerar).- Maiúsculas no meio da palavra (
edITAL,vencIDO): saída crua do Qwen3-1.7B agora normalizada. Conservador o suficiente para não afetar siglas legítimas (iPhone,macOS,HTML5,RAG,CPU). - Code-switching — palavras em outros idiomas vazavam no português:
habilitación,después,any,however,aprèsetc. Adicionado dicionário curto de correções (~20 palavras dos casos confirmados), preservando caixa. Não afeta palavras pt-BR legítimas como "mais" (que num bug anterior estava sendo trocado por "mas" — corrigido aqui). - Caracteres com macron (
recuperaçāocom ā): o modelo às vezes cospe macron no lugar do til pt-BR. Normalizado (ā→ã,ē→ê,ō→õ, etc.).
Memória
- CORS preflight no ajudante 8099: POST JSON de
file://falhava com "Failed to fetch". Agora oOPTIONSresponde corretamente. - Memória injetada mas modelo dizia "não sei": o bloco
=== DETALHES ===ia no system sem instrução de uso, e a regra "não invente" do prompt default prevalecia. Agora o cabeçalho diz claramente "use estes trechos como fonte". - Seleção de trecho ruim em pergunta genérica: num documento grande onde a palavra-chave aparece em todo parágrafo, todos os blocos empatavam e a escolha virava loteria. Agora detecta pergunta genérica (>70% dos blocos casam) e pega a introdução do documento (parte que costuma explicar o tema).
📦 Como atualizar
Substitua os arquivos do pendrive pelos desta versão e reabra com Iniciar_Arandu.vbs. Seus dados (memoria/) e modelos (*.gguf) não são tocados — ambos estão fora do Git por padrão.
🔗 Links úteis
- 📘 Manual completo (pt-BR + EN)
- 🚀 GUIA_DO_TESTADOR.md — quick-start de 3 minutos
- 🤗 Modelo no Hugging Face
- 🛠️ Diff completo desde a v1.2.0