Устранение ошибок
Обзор
Запишите версии Notemd/Obsidian, ОС, действие, протокол, модель и минимальные шаги. Дождитесь окончания отмены, прежде чем начинать другую задачу. Сохраните результаты и восстановление, пока не понятен их источник.
Диагностика
Соединение
Проверить подключение может проверить лишь список моделей либо короткую генерацию. Затем выполните реальную маленькую задачу для нужной модели и формата.
Прогресс и диагностика разработчика
Прогресс показывает состояние, ошибки и назначения, активность API — ожидание/завершение запросов. Включайте debug при необходимости. Длинная диагностика провайдера расходует квоту. Её тела могут содержать заметки, частичные ответы, адреса и ключи: локально очистите их перед передачей. Даже очищенный экспорт профилей требует просмотра метаданных.
Частые ошибки
Ключ неверен или отсутствует
401: ключ именно этого провайдера/адреса, без лишних пробелов. 403: права аккаунта/проекта, доступ к модели и оплата. Повторы не исправляют неверные реквизиты.
Сеть
Проверьте host, порт, протокол и маршрут с устройства Obsidian. Ollama/LM Studio должны работать с готовой моделью. localhost — это текущее устройство. Выберите правильный профиль; fallback выбирается runtime автоматически, не отдельным UI-переключателем.
Ограничение 429
Снизьте параллелизм, проверьте квоты запросов/токенов и других клиентов ключа. Повторы помогают лишь некоторым временным сбоям.
Модель не найдена
Получите список или укажите известный аккаунту model/deployment ID. Проверьте регион и API-версию; исторические значения могли устареть. Azure требует deployment, Ark может требовать endpoint ID.
Нет ссылок или понятий
Откройте фактический результат. Проверьте исходный материал, формат ответа и непустую включённую папку понятий. Отдельное извлечение даёт заголовки без backlinks. Если собственный prompt удалил маркер, сравните со встроенным.
Файл отсутствует или не там
Читайте сообщённый путь: _processed.md, _<language>.md или complete. При сбое создания папки перевод может сохраниться рядом с оригиналом. Проверьте коллизии и права перед повтором.
После отмены остались файлы
Завершённые записи сохраняются, принятые запросы/записи могут закончиться. Проверьте пофайловые результаты и конфликты до удаления или повторения всей папки.
Диаграмма или нативный экспорт
Типы создаются последовательно. Ошибка одного не блокирует остальные; отмена останавливает ожидающие типы и сохраняет готовые файлы. Повторите экспорт из предпросмотра или истории без нового запроса к модели. Ошибка генерации требует повторной генерации этого типа. Записи v1/v2 остаются читаемыми.
HTML диаграммы содержит масштабируемую графику; HTML структурированного резюме — текст, структуру и ссылки на источники. Редактируемый HTML/SVG — название рендерера, а не веб-редактора. Для правок используйте родной исходный файл. Экспорт презентаций, включая PPTX и MP4, сохраняет отдельные настройки и зависимости. Руководство по диаграммам.
Сообщить об ошибке
- Воспроизведите на синтетической заметке в отдельной папке.
- Укажите версии, действие, модель, настройки, ожидаемое и фактическое.
- Приложите минимальный артефакт и журнал без секретов, частных данных и лишних адресов.
- Уточните повторяемость на одном файле и встроенных prompt.
- Откройте GitHub Issues.
Скриншот редко сам доказывает проблему формата или отмены. По возможности приложите пару источник/вывод или минимальную последовательность.