docs: atualiza documentacao do projeto

Atualiza guias de agentes, changelog e README do MCP com as novas funcionalidades.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Jean Avila

.github/copilot-instructions.md

@@ -68,8 +68,16 @@ PowerShell                    ← only whitelisted commands execute
 |---|---|---|
 | `MESTRE_BASE_URL` | `http://127.0.0.1:7777` | Launcher endpoint |
 | `MESTRE_PROJETO_PATH` | launcher directory | Project root for git/log tools |
-| `OLLAMA_URL` | `http://127.0.0.1:11434` | Ollama API |
+| `OLLAMA_URL` | `http://127.0.0.1:11434` | Ollama API (auto: `https://ollama.com/api` se `OLLAMA_API_KEY` definida) |
+| `OLLAMA_API_KEY` | *(vazio)* | API key para Ollama Cloud (ollama.com) — ativa modo cloud + auth header |
 | `OLLAMA_MODEL` | `qwen2.5-coder:1.5b` | Default model |
+| `OLLAMA_NUM_CTX` | `8192` | Context window (tokens) |
+| `OLLAMA_TEMPERATURE` | `0.7` | Creatividade (0=determinístico, 2=caótico) |
+| `OLLAMA_TOP_P` | `0.9` | Nucleus sampling |
+| `OLLAMA_TOP_K` | `40` | Top-K sampling |
+| `OLLAMA_NUM_PREDICT` | `0` (ilimitado) | Máximo de tokens na resposta |
+| `OLLAMA_SEED` | `0` (aleatório) | Seed para reprodutibilidade |
+| `OLLAMA_KEEP_ALIVE` | `5m` | Tempo que o modelo fica em memória após uso |
 | `MPC_PORT` | `7777` | Launcher port (used in tests) |
 | `MPC_HOST` | `127.0.0.1` | Launcher bind address |
 

AGENTS.md

@@ -7,6 +7,7 @@ Mestre do PC V10 é um aplicativo Windows de diagnóstico e manutenção:
 - `v10/index.html`: interface ativa, servida pelo launcher.
 - `MestreDoPC-Launcher.ps1`: backend elevado em `127.0.0.1:7777`.
 - `mcp-server/index.js`: servidor MCP por `stdio`.
+- `browser-extension/`: extensão Manifest V3 para integrar o navegador com o launcher.
 - Ollama: IA local/cloud em `127.0.0.1:11434`.
 - `legado/`: versões antigas; não altere para corrigir a V10.
 
@@ -30,11 +31,20 @@ com `X-Mestre-Client: mcp`; o launcher executa o comando em um job elevado e o
 MCP consulta `/run-status`.
 
 A interface abre em `http://127.0.0.1:7777/` e usa
-`X-Mestre-Client: v10-web`. Não volte a abrir a V10 por `file://`, não restaure
+`X-Mestre-Client: v10-web`. A extensão do navegador usa
+`X-Mestre-Client: browser-extension` e um token configurado via
+`MESTRE_EXTENSION_TOKEN`. Não volte a abrir a V10 por `file://`, não restaure
 CORS `*` e não remova a validação de origem dos endpoints POST.
 
 O modelo Ollama padrão é configurável por `OLLAMA_MODEL`, com
-`qwen2.5-coder:1.5b` como fallback local.
+`qwen2.5-coder:1.5b` como fallback local. Perfis de modelos locais para
+automação de desktop estão em `mcp-server/model-profiles.json` (fast,
+balanced, agent, coding, reasoning) e são selecionados pela env var
+`OLLAMA_MODEL_PROFILE`. A API key do Ollama Cloud (`OLLAMA_API_KEY`)
+ativa modo cloud com auth header e muda a base URL para
+`https://ollama.com/api` automaticamente. Opções de geração
+(temperature, top_p, top_k, seed, num_predict, keep_alive) são
+configuráveis por env vars `OLLAMA_*` e têm precedência sobre o perfil.
 
 ## Regras para mudanças
 

CHANGELOG.md

@@ -2,8 +2,18 @@
 
 ## [Unreleased]
 
+### feat
+- **Ollama Cloud**: suporte a `OLLAMA_API_KEY` para modelos cloud em `ollama.com/api` com auth header automático. Base URL muda automaticamente quando a key está definida.
+- **Opções de geração configuráveis**: `OLLAMA_TEMPERATURE`, `OLLAMA_TOP_P`, `OLLAMA_TOP_K`, `OLLAMA_NUM_PREDICT`, `OLLAMA_SEED`, `OLLAMA_KEEP_ALIVE` via env vars.
+- **Modo thinking**: parâmetro `pensar` em `perguntar_ia` ativa raciocínio (`think`) para modelos compatíveis (gpt-oss, deepseek-r1).
+- **Metadata de resposta**: respostas da IA agora incluem contagem de tokens e tempo de geração.
+- **Tratamento de erros HTTP**: parsing de respostas de erro estruturadas da API (400, 404, 429, 500, 502).
+- **Função centralizada `ollamaChat()`**: elimina duplicação de código entre `perguntar_ia` e `analisar_logs_sistema`.
+- **`verificar_modelo_ollama`**: detecta modo cloud, exibe tamanho do modelo, mensagens de erro contextuais.
+
 ### docs
 - Adicionada seção "Docker" ao guia `docs/INSTALACAO-CLIENTE.md` com instruções para rodar Ollama via container (CPU, NVIDIA GPU, AMD GPU e Vulkan).
+- Tabelas de env vars atualizadas em `CLAUDE.md`, `AGENTS.md`, `.github/copilot-instructions.md`, `mcp-server/README.md`.
 
 ## 10.0.0 - Base inicial
 

CLAUDE.md

@@ -7,6 +7,7 @@ Mestre do PC V10 é um aplicativo Windows de diagnóstico e manutenção:
 - `v10/index.html`: interface ativa, servida pelo launcher.
 - `MestreDoPC-Launcher.ps1`: backend elevado em `127.0.0.1:7777`.
 - `mcp-server/index.js`: servidor MCP por `stdio`.
+- `browser-extension/`: extensão Manifest V3 para integrar o navegador com o launcher.
 - Ollama: IA local/cloud em `127.0.0.1:11434`.
 - `legado/`: versões antigas; não altere para corrigir a V10.
 
@@ -30,11 +31,20 @@ com `X-Mestre-Client: mcp`; o launcher executa o comando em um job elevado e o
 MCP consulta `/run-status`.
 
 A interface abre em `http://127.0.0.1:7777/` e usa
-`X-Mestre-Client: v10-web`. Não volte a abrir a V10 por `file://`, não restaure
+`X-Mestre-Client: v10-web`. A extensão do navegador usa
+`X-Mestre-Client: browser-extension` e um token configurado via
+`MESTRE_EXTENSION_TOKEN`. Não volte a abrir a V10 por `file://`, não restaure
 CORS `*` e não remova a validação de origem dos endpoints POST.
 
 O modelo Ollama padrão é configurável por `OLLAMA_MODEL`, com
-`qwen2.5-coder:1.5b` como fallback local.
+`qwen2.5-coder:1.5b` como fallback local. Perfis de modelos locais para
+automação de desktop estão em `mcp-server/model-profiles.json` (fast,
+balanced, agent, coding, reasoning) e são selecionados pela env var
+`OLLAMA_MODEL_PROFILE`. A API key do Ollama Cloud (`OLLAMA_API_KEY`)
+ativa modo cloud com auth header e muda a base URL para
+`https://ollama.com/api` automaticamente. Opções de geração
+(temperature, top_p, top_k, seed, num_predict, keep_alive) são
+configuráveis por env vars `OLLAMA_*` e têm precedência sobre o perfil.
 
 ## Regras para mudanças
 

mcp-server/README.md

@@ -25,17 +25,24 @@ Normalmente o Claude Desktop ou Codex inicia `index.js`; não é necessário man
 - `buscar_na_web` — busca no DuckDuckGo e retorna título, URL e trecho.
 - `analisar_logs_sistema` — coleta erros do Event Viewer e resume com IA.
 - `verificar_prompt` — detecta prompt injection/jailbreak.
-- `verificar_modelo_ollama` — checa se o modelo padrão está instalado.
+- `verificar_modelo_ollama` — checa se o modelo padrão está disponível (local ou cloud).
 
 ## Variáveis de ambiente
 
 | Variável | Padrão | Uso |
 |---|---|---|
 | `MESTRE_BASE_URL` | `http://127.0.0.1:7777` | Launcher administrativo |
 | `MESTRE_PROJETO_PATH` | Diretório do launcher | Diretório usado pelas ferramentas Git/logs |
-| `OLLAMA_URL` | `http://127.0.0.1:11434` | API do Ollama |
+| `OLLAMA_URL` | `http://127.0.0.1:11434` | API do Ollama (auto: `https://ollama.com/api` se `OLLAMA_API_KEY` definida) |
+| `OLLAMA_API_KEY` | *(vazio)* | API key para Ollama Cloud — ativa modo cloud + auth |
 | `OLLAMA_MODEL` | `qwen2.5-coder:3b-instruct` | Modelo padrão |
 | `OLLAMA_NUM_CTX` | `8192` | Contexto máximo (tokens) enviado ao Ollama |
+| `OLLAMA_TEMPERATURE` | `0.7` | Creatividade (0=determinístico, 2=caótico) |
+| `OLLAMA_TOP_P` | `0.9` | Nucleus sampling |
+| `OLLAMA_TOP_K` | `40` | Top-K sampling |
+| `OLLAMA_NUM_PREDICT` | `0` (ilimitado) | Máximo de tokens na resposta |
+| `OLLAMA_SEED` | `0` (aleatório) | Seed para reprodutibilidade |
+| `OLLAMA_KEEP_ALIVE` | `5m` | Tempo que o modelo fica em memória após uso |
 
 ## Claude Desktop
 
@@ -47,7 +54,8 @@ Normalmente o Claude Desktop ou Codex inicia `index.js`; não é necessário man
       "args": ["C:\\Users\\Jeanc\\Mestre-do-PC-V10-clean\\mcp-server\\index.js"],
       "env": {
         "MESTRE_PROJETO_PATH": "C:\\Users\\Jeanc\\Mestre-do-PC-V10-clean",
-        "OLLAMA_NUM_CTX": "8192"
+        "OLLAMA_NUM_CTX": "8192",
+        "OLLAMA_API_KEY": "sua_api_key_aqui"
       }
     }
   }