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 conexã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 demais; cancelar interrompe os tipos pendentes e preserva arquivos concluídos. Tente exportar novamente pela prévia ou pelo histórico sem outra solicitação ao modelo. Falha de geração exige gerar aquele tipo de novo. Os registros v1/v2 continuam legíveis.
O HTML de diagrama contém uma imagem com zoom; o HTML de resumo estruturado contém texto, estrutura e referências. HTML/SVG editável é o nome de um renderizador, não de um editor web. Use a fonte nativa para editar. A exportação de apresentações, incluindo PPTX e MP4, mantém configuraçõ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.