Устранение неполадок

💡TL;DR

Большинство Notemd проблем делятся на четыре категории: ключевые проблемы API, подключение к сети, ошибки аутентификации (401/403) и ограничения по скорости (429). Встроенный тест подключения и панель диагностики позволяют быстро определить корневую причину. На этой странице описаны все распространённые сообщения об ошибках, их причины и способы устранения. По проблемам, не указанным здесь, сообщайте о них в разделе GitHub Issues вместе с результатами диагностики.

Это часть Obsidian Руководства по управлению знаниями с ИИ.

Обзор

Notemd зависит от внешних сервисов — поставщиков LLM и сервисов поиска API, поэтому большинство проблем возникает не в самом плагине. Панель диагностики в настройках предоставляет структурированный обзор последнего API запроса, включая запрос URL, статус ответа и тело ошибки. Всегда сначала проверяйте её перед дальнейшим расследованием.

Как это работает: Диагностика

Тест подключения

В каждом разделе настроек поставщика есть кнопка "Проверить подключение". При нажатии на неё отправляется минимальный API запрос (обычно список моделей или краткое завершение) и сообщается о успехе или конкретной HTTP ошибке. Это самый быстрый способ проверить, правильны ли ваш ключ API и база URL.

Панель диагностики

Настройки --> Notemd --> Диагностика отображает следующее:

Поле	Содержимое
Последний поставщик	Какой поставщик был вызван в последний раз
Последняя модель	Какая модель была вызвана в последний раз
Последний статус	Код статуса HTTP или ошибка передачи данных
Последняя ошибка	Чистое сообщение об ошибке от API
Последний запрос URL	Полный URL последнего запроса (зашифрован ключ API)
Тело последнего ответа	Обрезанное тело ответа (первые 500 символов)

При сообщении о проблемах на GitHub скопируйте полный вывод диагностики.

Частые ошибки

Ключ API недействителен или отсутствует

Симптом: HTTP 401 или "Предоставлен неверный ключ API"

Причина: Ключ API отсутствует, содержит пробельные символы или принадлежит другому поставщику.

Решение:

1. Проверьте, что у ключа нет пробелов в начале и в конце
2. Убедитесь, что ключ соответствует выбранному поставщику (ключ OpenAI не будет работать с Anthropic)
3. Проверьте, есть ли у вас кредиты на счету или активная подписка
4. Нажмите "Test Connection", чтобы проверить это

Ошибки сети / соединения

Симптомы: ERR_CONNECTION_REFUSED, ERR_TIMED_OUT, Socket hang up, Network request failed

Причина: Конечная точка API недоступна с вашего устройства.

Решение:

1. Проверьте свое интернет-соединение
2. Если вы находитесь за прокси или брандмауэром, убедитесь, что домен API не заблокирован
3. Для Ollama: проверьте, запущен ли ollama serve (ollama list должен возвращать модели)
4. Для LMStudio: проверьте, запущен ли сервер на localhost:1234
5. Попробуйте другой способ передачи данных — пользователи мобильных устройств должны убедиться, что способ requestUrl активен
6. Включите enableStableApiCall для автоматической попытки повтора при временных ошибках

403 Forbidden

Симптомы: HTTP 403

Причина: Ваш ключ API действителен, но не имеет разрешений на запрашиваемый ресурс.

Решение:

1. Некоторые модели требуют специального доступа (например, GPT-4 через Azure требует указания имени развертывания)
2. Некоторые провайдеры ограничивают модели по уровню тарифа — проверьте свой аккаунт
3. Могут действовать региональные ограничения (некоторые китайские провайдеры блокируют международные IP, и наоборот)
4. Убедитесь, что имя модели написано правильно (например, gpt-4o, а не gpt-4o-mini, если мини‑модель — единственная, которую разрешает ваш тариф)

Ограничение скорости запросов (429)

Симптом: HTTP 429 или сообщение «Превышено ограничение скорости запросов»

Причина: слишком много запросов за короткий промежуток времени.

Решение:

1. Уменьшите batchConcurrency до 1 или 2
2. Подождите несколько минут перед повторной попыткой
3. Ознакомьтесь с документацией провайдера о лимитах скорости для вашего уровня тарифа
4. Включите enableStableApiCall для автоматической повторной попытки с задержками
5. Рассмотрите возможность перехода на провайдера с более высокими лимитами (DeepSeek, Ollama)

Модель не найдена

Симптом: сообщение «Модель не найдена» или HTTP 404

Причина: имя модели отсутствует у выбранного провайдера.

Решение:

1. Нажмите "Get Model List", чтобы увидеть все доступные модели для вашего поставщика
2. Названия некоторых моделей могут меняться со временем — проверьте текущее название в документации поставщика
3. Для Ollama: запустите ollama list, чтобы увидеть загруженные модели; доступны только те модели, которые были скачаны

Никаких ссылок / никаких концепций не генерируется

Симптом: команда выполняется, но не выводит ничего

Причина: LLM возвращает пустой или непарсируемый ответ.

Решение:

1. Проверьте панель диагностики на реальный ответ LLM
2. Попробуйте более мощную модель (некоторые небольшие модели плохо справляются со структурированным выводом)
3. Убедитесь, что заметка содержит достаточно информации (>50 слов)
4. Проверьте вашу пользовательскую инструкцию на наличие противоречивых указаний
5. Временно отключите подавление синонимов, чтобы узнать, не фильтрует ли оно слишком строго

Отсутствует ID конца Doubao

Симптом: ошибка при использовании поставщика ByteDance Doubao

Причина: Doubao требует ID конца Ark (формат: ep-xxxxxxxx-xxxx-xxxx) вместо названия модели.

Исправление: Замените стандартную модель-заглушку на реальный ID конечной точки из консоли Volcengine.

Конфигурация

Настройка диагностики	Местоположение	Цель
Проверка подключения	Раздел «Провайдер» в настройках	Проверьте ключ API и работоспособность подключения
** Получение списка моделей**	Раздел «Провайдер» в настройках	Убедитесь, какие модели доступны
enableStableApiCall	Раздел «Расширенные настройки»	Включите повторные попытки с задержками
batchConcurrency	Раздел «Пакетная обработка»	Контролируйте параллелизм, чтобы избежать ограничений по скорости

Как сообщать о проблемах

Если ваша проблема не описана выше:

1. Открыть Настройки --> Notemd --> Диагностика
2. Скопировать полный вывод диагностики
3. Открыть задачу в GitHub по адресу github.com/Jacobinwwey/obsidian-NotEMD/issues
4. Включить: версию Obsidian, версию Notemd, поставщика, модель, вывод диагностики и шаги для воспроизведения
5. Замаскировать ваш ключ API из любых общедоступных логов

---

Следующие шаги

• LLM Поставщики -- Полный справочник настроек поставщиков
• Пакетная обработка -- Настройки параллельной работы и повторных попыток для крупных операций
• Персонализированные промпты -- Исправление неожиданного поведения LLM путем настройки промптов