Усунення несправностей

💡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. Натисніть "Отримати список моделей", щоб побачити всі доступні моделі для вашого постачальника
2. Деякі назви моделей змінюються з часом — перевірте поточну назву в документації постачальника
3. Для Ollama: запустіть ollama list, щоб побачити завантажені моделі; доступні лише завантажені моделі

Жодних посилань / жодних концепцій не створено

Симптом: Команда виконується, але не виводить жодного результату

Причина: LLM повернув порожню або непарсовану відповідь.

Виправлення:

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

Відсутній ID кінцевої точки Doubao

Симптом: Помилка під час використання постачальника ByteDance Doubao

Причина: Doubao вимагає ID кінцевої точки Ark (формат: ep-xxxxxxxx-xxxx-xxxx) замість назви моделі.

Виправлення: Замініть стандартну модель-замінник на ваш справжній ідентифікатор кінцевої точки з консолі Volcengine.

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

Налаштування діагностики	Місцезнаходження	Мета
Перевірка з’єднання	Розділ Налаштування --> Постачальник	Перевірити ключ API та наявність з’єднання
Отримати список моделей	Розділ Налаштування --> Постачальник	Підтвердити, які моделі є доступними
enableStableApiCall	Розділ Налаштування --> Розширені налаштування	Увімкнути повторні спроби з затримкою
batchConcurrency	Розділ Налаштування --> Пакетна обробка	Керувати паралелізмом, щоб уникнути обмежень швидкості

Як повідомляти про проблеми

Якщо ваша проблема не описана вище:

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

---

Наступні кроки

• LLM Постачальники -- Повний посібник з налаштування постачальника
• Пакетна обробка -- Налаштування паралелізму та повторних спроб для великих операцій
• Складні запити -- Виправлення непередбачуваної поведінки LLM шляхом коригування запитів