Resolução de problemas
Reproduzir com nota descartável, fornecedor/modelo exatos e os mesmos ajustes. Ler progresso e destino. Separar autenticação, geração, análise e escrita; conexão válida não verifica todo o fluxo.
Visão geral
Registar versões Notemd/Obsidian, sistema, ação, protocolo, modelo e passos mínimos. Esperar pela conclusão do cancelamento antes de outra tarefa. Preservar saídas e recuperação até saber a sua origem.
Diagnósticos
Conexão
Testar ligação verifica lista ou pequena geração conforme perfil. Depois executar tarefa real para verificar modelo e formato.
Progresso e modo de desenvolvimento
O progresso mostra estado, erros e destinos. Atividade API distingue pedidos pendentes e concluídos. Ativar depuração apenas quando necessária; diagnósticos longos podem consumir quota.
Relatórios podem conter notas, respostas parciais, endpoints ou credenciais. Rever e remover dados sensíveis localmente; mesmo perfis com chaves ocultas exigem revisão dos metadados.
Erros frequentes
Chave ausente ou inválida
401: chave do fornecedor/endpoint corretos e sem espaços. 403: permissões, projeto, modelo e cobrança. Repetir não corrige credenciais.
Rede
Verificar host, porta, protocolo e acesso a partir do dispositivo Obsidian. Ollama/LM Studio precisam de servidor e modelo disponíveis. localhost é esse dispositivo. Escolher perfil correto; alternativas de transporte são automáticas, não seletor de interface.
Quota 429
Reduzir concorrência e verificar quotas de pedidos/tokens e outros clientes da mesma chave. Novas tentativas podem resolver falhas transitórias, não garantem vencer limites.
Modelo não encontrado
Usar descoberta ou nome conhecido de modelo/deployment. Verificar versão API e região; padrões históricos podem desaparecer. Azure exige nome de deployment; Ark pode exigir endpoint ID.
Sem links ou conceitos
Abrir a saída efetiva e verificar conteúdo útil, formato exigido e pasta conceptual não vazia ativa. Extração independente começa com títulos sem backlinks. Repor prompt integrado para comparação quando marcadores tiverem sido retirados.
Saída ausente ou inesperada
Consultar caminho comunicado: _processed.md, _<language>.md ou complete conforme tarefa. Falha da pasta de tradução pode usar a origem como alternativa. Verificar colisões e permissões antes de repetir.
Documentos após cancelar
Escritas concluídas permanecem e as já aceites podem terminar. Verificar resultados individuais e conflitos antes de apagar ou reiniciar a pasta completa.
Diagrama ou exportação nativa
Os tipos são gerados em sequência. Uma falha não bloqueia os restantes; cancelar interrompe os pendentes e preserva os ficheiros concluídos. Repita exportações pela pré-visualização ou histórico sem outro pedido ao modelo. Uma falha de geração exige gerar novamente esse tipo. Os registos v1/v2 continuam legíveis.
O HTML de diagrama contém um gráfico com zoom; o HTML de resumo estruturado contém texto, estrutura e referências. HTML/SVG editável designa um renderizador, não um editor web. Para editar, utilize a fonte nativa. A exportação de apresentações, incluindo PPTX e MP4, mantém definições e dependências separadas. Manual de diagramas.
Relatar uma falha
- Reproduzir com nota sintética e pasta dedicada.
- Indicar versões, ação, modelo, ajustes e esperado/observado.
- Anexar mínimos relatórios e artefactos sem segredos, notas privadas ou metadados desnecessários.
- Dizer se ocorre numa só nota e com prompts padrão.
- Abrir GitHub Issues.
Uma imagem de ecrã raramente prova falha de formato ou cancelamento. Incluir origem/saída ou sequência mínima quando possível.