Repository navigation
v1.4.0
Correções encontradas no uso real. As tools passam a responder só em texto, porque em alguns clientes as proteções não chegavam ao modelo. Também passa a haver um servidor montando o índice de cada vez, e a busca por significado funciona sem internet depois do primeiro download.
Corrigido
- As proteções e as dicas não chegavam ao modelo no Claude Code, no VS Code e no Codex. Quando a resposta de uma tool traz JSON (
structuredContent), esses clientes mandam ao modelo só o JSON e descartam o texto.- O que estava no texto: a delimitação
<dados_nao_confiaveis>, o alerta de prompt injection, o aviso 🔒 e as dicas. - O que continuava funcionando: as credenciais seguiam mascaradas.
- Agora: as tools respondem só em texto.
- O que estava no texto: a delimitação
- A busca por significado não funcionava sem internet, mesmo com o modelo já baixado, e ficava parada quando o Hugging Face demorava a responder. Agora, depois do primeiro download, o modelo é lido da pasta local, sem acesso à rede.
Alterado
listar_arquivoscom mais de 100 arquivos mostra um panorama por subpasta, em vez dos 100 primeiros. Cada subpasta aparece com quantos arquivos tem de cada tipo, e com o título e o primeiro parágrafo do README.- Medido no Claude Code, com a mesma pergunta sobre um módulo de 634 arquivos: de 25 para 4 chamadas de tool e de ~842 mil para ~190–230 mil tokens de entrada.
- Nas duas rodadas medidas, o modelo não tentou usar o terminal (antes, foram 3 tentativas).
- Só um servidor monta o índice de cada vez quando há vários clientes abertos (VS Code, sessões do Claude Code, Codex). Os outros esperam sem carregar o modelo e depois usam o índice salvo.
- Medido com 3 clientes na primeira indexação de ~1.700 arquivos: de 26,2 para 5,8 min, e de 3,6 para 2,4 GB de memória somada.
- O modelo só é carregado quando há algo para calcular. Um servidor aberto que ainda não buscou nada fica com ~0,3 GB de memória, em vez de ~1,4 GB. Em troca, a primeira busca de cada sessão leva ~0,6 s a mais.
- O JSON (
structuredContent) não existe mais. Quem o lia num programa encontra os mesmos dados no texto. - O índice salvo continua valendo: atualizar não refaz o índice.
npm: npx -y study-notes-mcp@latest