obsidian-plugin/jacobinwwey_obsidian-NotEMD
1
0
Fork 0
mirror of https://github.com/jacobinwwey/obsidian-NotEMD.git synced 2026-07-22 05:48:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
jacobinwwey_obsidian-NotEMD/README_uk.md
Jacobinwwey 8a94b35f62 docs: refresh quarterly chronicle for 1.9.3
2026-06-24 08:17:41 +00:00

107 KiB
Raw Blame History

GitHub Release GitHub Downloads GitHub Repo stars

Discord QQ

Плагін Notemd для Obsidian

English | 简体中文 | Español | Français | Deutsch | Italiano | Português | 繁體中文 | 日本語 | 한국어 | Русский | العربية | हिन्दी | বাংলা | Nederlands | Svenska | Suomi | Dansk | Norsk | Polski | Türkçe | עברית | ไทย | Ελληνικά | Čeština | Magyar | Română | Українська | Tiếng Việt | Bahasa Indonesia | Bahasa Melayu

Читайте документацію іншими мовами: Мовний центр

==================================================
  _   _       _   _ ___    __  __ ___
 | \ | | ___ | |_| |___|  |  \/  |___ \
 |  \| |/ _ \| __| |___|  | |\/| |   | |
 | |\  | (_) | |_| |___   | |  | |___| |
 |_| \_|\___/ \__|_|___|  | |  | |____/
==================================================
 Багатомовне розширення бази знань за допомогою ШІ
==================================================

Простий спосіб створити власну базу знань.

Notemd покращує ваш робочий процес в Obsidian, інтегруючись з різними великими мовними моделями (LLM), щоб обробляти багатомовні нотатки, автоматично створювати wiki-link для ключових понять, формувати відповідні concept note, виконувати веб-дослідження та допомагати вам будувати потужні графи знань і не тільки.

Якщо вам подобається використовувати Notemd, будь ласка, ⭐ поставте зірку на GitHub або ☕️ купіть мені каву.

.9.0

show multi-langu NEW FEATURE

Зміст

Швидкий старт

  1. Встановіть і увімкніть: отримайте плагін з Obsidian Marketplace.
  2. Налаштуйте LLM: перейдіть до Settings -> Notemd, виберіть вашого провайдера LLM, наприклад OpenAI або локального провайдера на кшталт Ollama, і введіть API-ключ або URL.
  3. Відкрийте бічну панель: натисніть на значок чарівної палички Notemd у лівій стрічці, щоб відкрити бічну панель.
  4. Обробіть нотатку: відкрийте будь-яку нотатку й натисніть "Process File (Add Links)" на бічній панелі, щоб автоматично додати [[wiki-links]] до ключових понять.
  5. Запустіть швидкий робочий процес: використайте типову кнопку "One-Click Extract", щоб з одного місця послідовно запустити обробку, пакетну генерацію та очищення Mermaid.

Це все. Дослідіть налаштування, щоб увімкнути додаткові можливості, такі як веб-дослідження, переклад і генерація контенту.

Підтримка мов

Контракт мовної поведінки

Аспект Область Типово Примітки
Мова інтерфейсу Лише текст інтерфейсу плагіна, наприклад налаштування, бічна панель, сповіщення та діалоги auto Наслідує мову Obsidian; поточні каталоги UI: en, ar, de, es, fa, fr, id, it, ja, ko, nl, pl, pt, pt-BR, ru, th, tr, uk, vi, zh-CN, zh-TW.
Мова виводу задач Вивід завдань, згенерований LLM: посилання, підсумки, генерація, екстракція, ціль перекладу en Може бути глобальним або для кожного завдання окремо, якщо увімкнено Використовувати різні мови для задач.
Вимкнути автопереклад Завдання, що не є Translate, зберігають контекст мови джерела false Явні завдання Translate усе одно примусово використовують налаштовану цільову мову.
Резервна локаль Розв'язання відсутніх ключів UI locale -> en Підтримує стабільність UI, коли частина ключів ще не перекладена.
  • Підтримувані вихідні документи ведуться англійською та спрощеною китайською, а опубліковані переклади README наведені у шапці вище.
  • Поточне покриття UI locale у застосунку точно відповідає явному каталогу в коді: en, ar, de, es, fa, fr, id, it, ja, ko, nl, pl, pt, pt-BR, ru, th, tr, uk, vi, zh-CN, zh-TW.
  • Англійський fallback залишається страховкою реалізації, але підтримувані видимі поверхні покриті регресійними тестами й не повинні непомітно повертатися до англійської під час звичайного використання.
  • Подальші деталі та рекомендації для внеску зібрані в Мовному центрі.

Можливості

Обробка документів за допомогою ШІ

  • Підтримка Multi-LLM: підключення до різних хмарних і локальних провайдерів LLM. Див. Підтримувані провайдери LLM.
  • Розумне chunking: автоматично ділить великі документи на зручні частини за кількістю слів.
  • Збереження вмісту: намагається зберегти оригінальне форматування, одночасно додаючи структуру й посилання.
  • Відстеження прогресу: оновлення в реальному часі через бічну панель Notemd або модальне вікно прогресу.
  • Операції, які можна скасувати: скасуйте будь-яке завдання обробки, одиночне чи пакетне, запущене з бічної панелі, окремою кнопкою скасування. Операції з палітри команд використовують модальне вікно, яке також можна скасувати.
  • Налаштування кількох моделей: використовуйте різних провайдерів LLM і конкретні моделі для різних завдань, таких як Add Links, Research, Generate Title і Translate, або одного провайдера для всього.
  • Stable API Calls (Retry Logic): за потреби увімкніть автоматичні повторні спроби для невдалих викликів LLM API з налаштовуваними інтервалом і лімітом спроб.
  • Стійкіші тести з'єднання з провайдером: якщо перша перевірка провайдера стикається з тимчасовим мережевим розривом, Notemd тепер переходить на стабільну послідовність повторів перед остаточною помилкою. Це охоплює шляхи OpenAI-compatible, Anthropic, Google, Azure OpenAI та Ollama.
  • Резервний транспорт залежно від середовища виконання: якщо довгий запит до провайдера переривається всередині requestUrl через тимчасові мережеві помилки на кшталт ERR_CONNECTION_CLOSED, Notemd повторює ту саму спробу через резервний транспорт, залежний від середовища, ще до входу в налаштований цикл повторів. На desktop-збірках використовується Node http/https, а в не-desktop середовищах — браузерний fetch. Це зменшує кількість хибних збоїв на повільних gateway та reverse proxy.
  • Посилення ланцюжка стабільних довгих запитів для OpenAI-compatible: у stable mode виклики OpenAI-compatible тепер використовують явний 3-етапний порядок для кожної спроби: primary direct streaming transport, потім direct non-stream transport, потім requestUrl fallback, який за потреби все ще може перейти на streamed parsing. Це зменшує кількість хибнонегативних ситуацій, коли провайдер завершує buffered response, але streaming pipe нестабільний.
  • Protocol-aware streaming fallback для всіх LLM API: довгі fallback-спроби тепер переходять на streamed parsing з урахуванням протоколу в усіх вбудованих шляхах LLM, а не лише на OpenAI-compatible endpoint. Notemd тепер обробляє OpenAI/Azure-style SSE, Anthropic Messages streaming, відповіді Google Gemini SSE й Ollama NDJSON як на desktop http/https, так і на не-desktop fetch, а решта direct OpenAI-style provider entrypoint повторно використовують той самий спільний fallback-path.
  • Готові пресети для китайських провайдерів: вбудовані пресети тепер охоплюють Qwen, Qwen Code, Doubao, Moonshot, GLM, Z AI, MiniMax, Huawei Cloud MaaS, Baidu Qianfan і SiliconFlow на додачу до наявних глобальних і локальних провайдерів.
  • Надійна пакетна обробка: покращена логіка одночасної обробки завдяки рознесеним у часі API-викликам, щоб запобігати rate-limiting-помилкам і забезпечувати стабільну роботу під час великих пакетних задач. Нова реалізація гарантує, що завдання запускаються з різними інтервалами, а не всі одразу.
  • Точне звітування про прогрес: виправлено помилку, через яку progress bar міг зависати, тому UI тепер завжди відображає реальний стан операції.
  • Надійна паралельна пакетна обробка: усунуто проблему, через яку паралельні пакетні операції передчасно зупинялися, що забезпечує надійну й ефективну обробку всіх файлів.
  • Точність progress bar: виправлено помилку, через яку progress bar для команди "Create Wiki-Link & Generate Note" зависав на 95%; тепер після завершення коректно відображається 100%.
  • Покращене API-debugging: режим "API Error Debugging Mode" тепер захоплює повні response body від провайдерів LLM і пошукових сервісів, таких як Tavily і DuckDuckGo, а також записує transport timeline для кожної спроби з очищеними request URL, тривалістю, response headers, частковими response body, частково розібраним stream output і трасуванням стека для кращого усунення проблем на шляхах OpenAI-compatible, Anthropic, Google, Azure OpenAI та Ollama.
  • Панель режиму розробника: налаштування тепер містять окрему діагностичну панель лише для розробників, яка прихована, доки не ввімкнено "Developer mode". Вона підтримує вибір діагностичного шляху виклику та повторні перевірки стабільності для вибраного режиму.
  • Оновлена бічна панель: вбудовані дії згруповані в більш сфокусовані секції з яснішими мітками, живим статусом, прогресом із можливістю скасування і журналами, які можна копіювати, щоб зменшити захаращення бічної панелі. Нижній блок прогресу й журналів тепер залишається видимим навіть коли всі секції розгорнуті, а стан готовності використовує зрозумілішу доріжку очікування.
  • Поліпшення взаємодії та читабельності бічної панелі: кнопки бічної панелі тепер мають чіткіший відгук на наведення, натискання та фокус, а кольорові CTA-кнопки, зокрема One-Click Extract і Batch generate from titles, мають кращий контраст тексту для читабельності в різних темах.
  • CTA лише для дій з одним файлом: кольоровий стиль CTA тепер зарезервовано лише для дій над окремим файлом. Пакетні дії, дії над папками та змішані робочі процеси використовують не-CTA стиль, щоб зменшити помилки через неправильне сприйняття масштабу дії.
  • Користувацькі робочі процеси в один клік: перетворюйте вбудовані інструменти бічної панелі на багаторазові користувацькі кнопки з власними назвами й ланцюжками дій. Типовий робочий процес One-Click Extract доступний одразу після встановлення.

Розширення графа знань

  • Автоматичне wiki-linking: визначає ключові поняття й додає [[wiki-links]] до оброблених нотаток на основі виводу LLM.
  • Створення concept note (необов'язково й налаштовувано): автоматично створює нові нотатки для виявлених понять у вказаній папці vault.
  • Налаштовувані вихідні шляхи: окремо налаштуйте відносні шляхи всередині vault для збереження оброблених файлів і нових concept note.
  • Налаштовувані назви вихідних файлів для Add Links: ви можете за бажанням перезаписувати оригінальний файл або використовувати власний suffix чи replacement string замість типового _processed.md, коли файли обробляються для додавання посилань.
  • Підтримка цілісності посилань: базова підтримка оновлення посилань, коли нотатки змінюються або видаляються з vault.
  • Чисте виділення понять: виділяйте поняття й створюйте відповідні concept note без зміни документа-джерела. Це зручно для наповнення бази знань із наявних документів без їх модифікації. Функція має налаштовувані опції мінімальних concept note та backlink.

Переклад

  • Переклад за допомогою ШІ:
    • Перекладайте вміст нотаток за допомогою налаштованого LLM.
    • Підтримка великих файлів: великі файли автоматично діляться на менші частини на основі параметра Chunk word count перед надсиланням до LLM. Потім перекладені фрагменти акуратно об'єднуються назад в один документ.
    • Підтримує переклад між багатьма мовами.
    • Налаштовувана цільова мова через settings або UI.
    • Автоматично відкриває перекладений текст праворуч від оригіналу для зручнішого читання.
  • Пакетний переклад:
    • Перекладайте всі файли у вибраній папці.
    • Підтримує паралельну обробку, якщо ввімкнено "Enable Batch Parallelism".
    • Використовує користувацькі prompt для перекладу, якщо вони налаштовані.
    • Додає пункт "Batch translate this folder" у контекстне меню file explorer.
  • Вимкнути автоматичний переклад: коли цю опцію ввімкнено, завдання, відмінні від Translate, більше не змушують результат бути певною мовою, зберігаючи контекст мови джерела. Явне завдання "Translate" все одно виконує переклад згідно з налаштуванням.

Веб-дослідження та генерація контенту

  • Веб-дослідження та підсумовування:
    • Виконуйте веб-пошук через Tavily, що потребує API key, або через DuckDuckGo, який лишається експериментальним.
    • Покращена стійкість пошуку: пошук DuckDuckGo тепер має покращену логіку парсингу, DOMParser з Regex fallback, щоб витримувати зміни верстки й повертати надійні результати.
    • Підсумовуйте результати пошуку за допомогою налаштованого LLM.
    • Мову підсумку можна налаштувати в settings.
    • Додавайте підсумки до поточної нотатки.
    • Налаштовуваний ліміт token для дослідницького контенту, що надсилається до LLM.
  • Генерація контенту з заголовка:
    • Використовуйте заголовок нотатки, щоб згенерувати початковий контент через LLM, замінюючи наявний вміст.
    • Необов'язкове дослідження: налаштуйте, чи виконувати веб-дослідження через вибраного провайдера, щоб додати контекст для генерації.
  • Пакетна генерація контенту із заголовків: генеруйте контент для всіх нотаток у вибраній папці на основі їхніх заголовків, з урахуванням необов'язкового параметра дослідження. Успішно оброблені файли переміщуються до налаштовуваної підпапки "complete", наприклад [foldername]_complete або папки з власною назвою, щоб уникнути повторної обробки.
  • Зв'язка з Mermaid auto-fix: коли Mermaid auto-fix увімкнено, Mermaid-related workflow тепер автоматично виправляють згенеровані файли або вихідні папки після обробки. Це охоплює Process, Generate from Title, Batch Generate from Titles, Research & Summarize, Summarise as Mermaid і Translate.

Допоміжні можливості

  • Підсумувати як діаграму Mermaid:
    • Ця функція дозволяє стисло подати вміст нотатки у вигляді Mermaid diagram.
    • Мову виходу Mermaid diagram можна налаштувати в settings.
    • Mermaid Output Folder: налаштуйте папку, куди зберігатимуться згенеровані Mermaid diagram files.
    • Translate Summarize to Mermaid Output: за бажанням перекладайте згенерований Mermaid-контент на налаштовану цільову мову.
SUMM

  • Просте виправлення формату формул:

    • Швидко перетворює однорядкові математичні формули, обмежені одним $, на стандартні блоки $$.
    • Single File: обробіть поточний файл через кнопку в sidebar або палітру команд.
    • Batch Fix: обробіть усі файли у вибраній папці через кнопку в sidebar або палітру команд.

  • Check for Duplicates in Current File: ця команда допомагає виявити потенційно дубльовані терміни в активному файлі.

  • Duplicate Detection: базова перевірка дубльованих слів у вмісті поточного оброблюваного файлу, результати логуються в console.

  • Check and Remove Duplicate Concept Notes: виявляє потенційні дублікати нотаток у налаштованій Concept Note Folder на основі точних збігів назв, множини, normalisation і single-word containment порівняно з нотатками поза цією папкою. Область порівняння можна налаштувати на entire vault, тільки конкретно включені папки або усі папки з виключенням певних папок. Показує детальний список із причинами й конфліктними файлами, а потім просить підтвердження перед переміщенням знайдених дублікатів до system trash. Показує progress під час видалення.

  • Batch Mermaid Fix: застосовує виправлення синтаксису Mermaid і LaTeX до всіх Markdown files у вибраній користувачем папці.

    • Готово для workflow: можна використовувати як окрему утиліту або як крок у користувацькій кнопці one-click workflow.
    • Звітність про помилки: створює звіт mermaid_error_{foldername}.md, який перелічує файли, у яких після обробки все ще є потенційні Mermaid-помилки.
    • Переміщення файлів з помилками: за бажанням переміщує файли з виявленими помилками в окрему папку для ручного перегляду.
    • Розумне виявлення: тепер розумно перевіряє файли на syntax error за допомогою mermaid.parse перед спробою виправлення, заощаджуючи час обробки й уникаючи зайвих редагувань.
    • Безпечна обробка: гарантує, що виправлення синтаксису застосовуються лише до Mermaid code block, щоб випадково не змінити Markdown tables або інший контент. Також містить надійні запобіжники для захисту table syntax, наприклад | :--- |, від занадто агресивних debug-fix.
    • Deep Debug Mode: якщо після первинного виправлення помилки лишаються, запускається просунутий режим deep debug. Він обробляє складні edge case, зокрема:
      • Comment Integration: автоматично зливає кінцеві коментарі, що починаються з %, в edge label, наприклад A -- Label --> B; % Comment перетворюється на A -- "Label(Comment)" --> B;.
      • Malformed Arrows: виправляє стрілки, поглинуті лапками, наприклад A -- "Label -->" B -> A -- "Label" --> B.
      • Inline Subgraphs: перетворює inline subgraph labels на edge labels.
      • Reverse Arrow Fix: виправляє нестандартні стрілки X <-- Y на Y --> X.
      • Direction Keyword Fix: забезпечує написання ключового слова direction малими літерами всередині subgraph, наприклад Direction TB -> direction TB.
      • Comment Conversion: перетворює коментарі // на edge labels, наприклад A --> B; // Comment -> A -- "Comment" --> B;.
      • Duplicate Label Fix: спрощує повторювані bracketed label, наприклад Node["Label"]["Label"] -> Node["Label"].
      • Invalid Arrow Fix: перетворює невалідний синтаксис стрілки --|> на стандартний -->.
      • Надійна обробка label і note: покращена обробка міток зі спеціальними символами, як /, і краща підтримка користувацького синтаксису нотаток note for ..., що дозволяє чисто прибирати артефакти на кшталт зайвих дужок наприкінці.
      • Advanced Fix Mode: містить надійні виправлення для нецитованих node label, які містять пробіли, спеціальні символи або вкладені дужки, наприклад Node[Label [Text]] -> Node["Label [Text]"], що забезпечує сумісність зі складними diagram на кшталт paths Stellar Evolution. Також виправляє пошкоджені edge labels, наприклад --["Label["--> у -- "Label" -->. Додатково перетворює inline comments, наприклад Consensus --> Adaptive; # Some advanced consensus, на Consensus -- "Some advanced consensus" --> Adaptive, а також виправляє незакриті лапки наприкінці рядка, замінюючи фінальне ;" на "].
      • Note Conversion: автоматично перетворює note right/left of і standalone comments note : на стандартні Mermaid node definition та connections, наприклад note right of A: text стає NoteA["Note: text"], з'єднаним з A, що запобігає syntax error і покращує layout. Тепер підтримуються і arrow links (-->), і solid links (---).
      • Extended Note Support: автоматично перетворює note for Node "Content" і note of Node "Content" на стандартні зв'язані note node, наприклад NoteNode[" Content"], з'єднану з Node, забезпечуючи сумісність із розширеним користувацьким синтаксисом.
      • Enhanced Note Correction: автоматично перейменовує нотатки з послідовною нумерацією, наприклад Note1, Note2, щоб уникнути aliasing-помилок, коли присутні кілька нотаток.
      • Parallelogram/Shape Fix: виправляє пошкоджені форми вузлів, такі як [/["Label["/], до стандартного ["Label"], забезпечуючи сумісність зі згенерованим контентом.
      • Standardize Pipe Labels: автоматично виправляє й стандартизує edge label, що містять вертикальні риски, щоб вони були коректно взяті в лапки, наприклад -->|Text| стає -->|"Text"|, а -->|Math|^2| стає -->|"Math|^2"|.
      • Misplaced Pipe Fix: виправляє edge label, які помилково стоять перед стрілкою, наприклад >|"Label"| A --> B стає A -->|"Label"| B.
      • Merge Double Labels: виявляє та об'єднує складні подвійні label на одному edge, наприклад A -- Label1 -- Label2 --> B або A -- Label1 -- Label2 --- B, в одну чисту label із переносами рядка: A -- "Label1<br>Label2" --> B.
      • Unquoted Label Fix: автоматично бере в лапки node label, які містять потенційно проблемні символи, як лапки, знаки дорівнює або математичні оператори, але не мають зовнішніх лапок, наприклад Plot[Plot "A"] -> Plot["Plot "A""], щоб запобігти render error.
      • Intermediate Node Fix: розділяє edge, які містять визначення проміжного node, на два окремі edge, наприклад A -- B[...] --> C стає A --> B[...] і B[...] --> C, забезпечуючи валідний Mermaid-синтаксис.
      • Concatenated Label Fix: надійно виправляє визначення node, де ID злипся з label, наприклад SubdivideSubdivide... стає Subdivide["Subdivide..."], навіть якщо перед цим стоять pipe labels або повторення не є точним, шляхом валідації проти відомих node ID.

  • Extract Specific Original Text:

    • Визначте список питань у settings.
    • Витягує дослівні фрагменти тексту з активної нотатки, які відповідають цим питанням.
    • Merged Query Mode: опція обробляти всі питання одним API-викликом для кращої ефективності.
    • Translation: опція включити переклади витягнутого тексту в результат.
    • Custom Output: налаштовуваний шлях збереження й suffix filename для файлу з витягнутим текстом.

  • LLM Connection Test: перевірте API settings для активного провайдера.

Встановлення

Install

Із Obsidian Marketplace (рекомендовано)

  1. Відкрийте в Obsidian Settings -> Community plugins.
  2. Переконайтеся, що "Restricted mode" вимкнено.
  3. Натисніть Browse community plugins і знайдіть "Notemd".
  4. Натисніть Install.
  5. Після встановлення натисніть Enable.

Ручне встановлення

  1. Завантажте assets останнього release зі сторінки GitHub Releases. Кожен release також містить README.md для довідки в пакеті, але для ручного встановлення потрібні лише main.js, styles.css і manifest.json.
  2. Перейдіть до папки конфігурації вашого Obsidian vault: <YourVault>/.obsidian/plugins/.
  3. Створіть нову папку з назвою notemd.
  4. Скопіюйте main.js, styles.css і manifest.json до папки notemd.
  5. Перезапустіть Obsidian.
  6. Перейдіть до Settings -> Community plugins і увімкніть "Notemd".

Налаштування

Доступ до settings плагіна: Settings -> Community Plugins -> Notemd (натисніть значок шестерні).

Конфігурація провайдера LLM

  1. Активний провайдер: виберіть зі списку провайдера LLM, якого хочете використовувати.
  2. Параметри провайдера: налаштуйте конкретні параметри для вибраного провайдера:
    • API-ключ: потрібен для більшості хмарних провайдерів, наприклад OpenAI, Anthropic, DeepSeek, Qwen, Qwen Code, Doubao, Moonshot, GLM, Z AI, MiniMax, Huawei Cloud MaaS, Baidu Qianfan, SiliconFlow, Google, Mistral, Azure OpenAI, OpenRouter, xAI, Groq, Together, Fireworks і Requesty. Не потрібен для Ollama. Необов'язковий для LM Studio та універсального пресету OpenAI Compatible, якщо ваш endpoint підтримує анонімний або placeholder-доступ.
    • Базовий URL / endpoint: API endpoint сервісу. Типові значення надаються, але вам може знадобитися змінити їх для локальних моделей, таких як LMStudio й Ollama, gateway на кшталт OpenRouter, Requesty і OpenAI Compatible, або для конкретних Azure deployment. Обов'язково для Azure OpenAI.
    • Модель: конкретна назва або ID моделі, яку слід використовувати, наприклад gpt-4o, claude-3-5-sonnet-20240620, google/gemini-flash-1.5, grok-4, moonshotai/kimi-k2-instruct-0905, accounts/fireworks/models/kimi-k2p5 або anthropic/claude-3-7-sonnet-latest. Переконайтеся, що модель доступна на вашому endpoint або у провайдера.
    • Температура: керує випадковістю виводу LLM, де 0 = детерміновано, а 1 = максимальна креативність. Нижчі значення, наприклад 0.2-0.5, зазвичай кращі для структурованих завдань.
    • Версія API (лише Azure): потрібна для Azure OpenAI deployment, наприклад 2024-02-15-preview.
  3. Перевірити підключення: використовуйте кнопку "Перевірити підключення" для активного провайдера, щоб перевірити налаштування. OpenAI-compatible провайдери тепер використовують перевірки з урахуванням типу провайдера: endpoint, такі як Qwen, Qwen Code, Doubao, Moonshot, GLM, Z AI, MiniMax, Huawei Cloud MaaS, Baidu Qianfan, SiliconFlow, Groq, Together, Fireworks, LMStudio та OpenAI Compatible, перевіряють chat/completions напряму, тоді як провайдери з надійним /models endpoint можуть як і раніше спершу використовувати перелік моделей. Якщо перша перевірка зривається через тимчасовий мережевий розрив, наприклад ERR_CONNECTION_CLOSED, Notemd автоматично переходить до стабільної послідовності повторів замість негайної помилки.
  4. Керування конфігураціями провайдерів: використовуйте кнопки "Export Providers" і "Import Providers", щоб зберігати або завантажувати налаштування провайдерів LLM до файлу notemd-providers.json у каталозі конфігурації плагіна або з нього. Це полегшує резервне копіювання та спільне використання.
  5. Покриття пресетів: окрім оригінальних провайдерів, Notemd тепер містить попередньо налаштовані записи для Qwen, Qwen Code, Doubao, Moonshot, GLM, Z AI, MiniMax, Huawei Cloud MaaS, Baidu Qianfan, SiliconFlow, xAI, Groq, Together, Fireworks, Requesty і універсальної цілі OpenAI Compatible для LiteLLM, vLLM, Perplexity, Vercel AI Gateway або власних проксі. LLM

Налаштування кількох моделей

  • Використовувати різних провайдерів для задач:
    • Вимкнено (типово): використовує одного «активного провайдера», вибраного вище, для всіх завдань.
    • Увімкнено: дозволяє вибрати конкретного провайдера й за бажанням перевизначити назву моделі для кожного завдання, такого як "Add Links", "Research & Summarize", "Generate from Title", "Translate" і "Extract Concepts". Якщо поле перевизначення моделі для завдання лишається порожнім, буде використано типову модель, налаштовану для провайдера, вибраного для цього завдання.
  • Вибирати різні мови для різних задач:
    • Вимкнено (типово): використовує одну «мову виводу» для всіх завдань.
    • Увімкнено: дозволяє вибрати конкретну мову для кожного завдання, такого як "Add Links", "Research & Summarize", "Generate from Title", "Summarise as Mermaid diagram" і "Extract Concepts".
Multi-model

Мовна архітектура (мова інтерфейсу та мова виводу задач)

  • Мова інтерфейсу керує лише текстом інтерфейсу плагіна: підписами в налаштуваннях, кнопками бічної панелі, сповіщеннями та діалогами. Типовий режим auto наслідує поточну UI-мову Obsidian.
  • Регіональні або писемні варіанти тепер зіставляються з найближчим опублікованим каталогом замість того, щоб одразу відкотитися до англійської. Наприклад, fr-CA використовує французьку, es-419 — іспанську, pt-PT — португальську, zh-Hans — спрощену китайську, а zh-Hant-HK — традиційну китайську.
  • Мова виводу задач керує модельно-згенерованим виводом завдань, таким як посилання, підсумки, генерація заголовків, Mermaid-підсумок, виділення понять і ціль перекладу.
  • Режим мови за задачами дозволяє кожному завданню визначати власну вихідну мову через єдиний шар політики замість розрізнених перевизначень у різних модулях.
  • Вимкнути автопереклад залишає завдання, відмінні від Translate, у контексті мови джерела, тоді як явні завдання Translate все ще примусово використовують налаштовану цільову мову.
  • Mermaid-пов'язані шляхи генерації дотримуються тієї ж мовної політики й усе ще можуть запускати автовиправлення Mermaid, коли ця функція ввімкнена.

Налаштування стабільних API-викликів

  • Увімкнути стабільні API-виклики (логіка повторів):
    • Вимкнено (типово): один збій API-виклику зупинить поточне завдання.
    • Увімкнено: автоматично повторює невдалі виклики LLM API, що корисно при нестабільній мережі або обмеженнях за частотою.
    • Резервний шлях для перевірки підключення: навіть коли звичайні виклики ще не працюють у стабільному режимі, перевірки з'єднання з провайдером тепер переходять на ту саму послідовність повторів після першого тимчасового мережевого збою.
    • Резервний транспорт під час виконання (з урахуванням середовища): довгі запити задач, тимчасово обірвані requestUrl, тепер повторюють ту саму спробу спочатку через резервний транспорт з урахуванням середовища. Desktop builds використовують Node http/https, а non-desktop environments — browser fetch. Ці резервні спроби тепер використовують потоковий розбір з урахуванням протоколу у вбудованих шляхах LLM, охоплюючи OpenAI-compatible SSE, Azure OpenAI SSE, Anthropic Messages SSE, Google Gemini SSE та Ollama NDJSON, завдяки чому повільні gateway можуть повертати body chunks раніше. Решта direct OpenAI-style provider entrypoint використовують той самий shared fallback path.
    • Порядок стабільного режиму для OpenAI-compatible: у stable mode кожна OpenAI-compatible attempt тепер проходить через direct streaming -> direct non-stream -> requestUrl (with streamed fallback when needed) перед тим, як вважатися невдалою. Це запобігає надто агресивним збоям, коли нестабільний лише один transport mode.
  • Інтервал повторів (секунди): видно лише коли функцію ввімкнено. Час очікування між повторними спробами, від 1 до 300 секунд. Типово: 5.
  • Максимальна кількість повторів: видно лише коли функцію ввімкнено. Максимальна кількість повторних спроб, від 0 до 10. Типово: 3.
  • Режим налагодження помилок API:
    • Вимкнено (типово): використовує стандартне й лаконічне звітування про помилки.
    • Увімкнено: вмикає детальне логування помилок, подібне до verbose output у DeepSeek, для всіх провайдерів і завдань, включно з Translate, Search і Connection Tests. Це включає HTTP status codes, raw response text, request transport timelines, sanitized request URLs і headers, тривалість кожної attempt, response headers, partial response body, parsed partial stream output і stack traces, що критично для усунення проблем із підключенням до API та reset з боку upstream gateway.
  • Режим розробника:
    • Вимкнено (типово): ховає всі діагностичні елементи керування, призначені лише для розробників, від звичайних користувачів.
    • Увімкнено: показує окрему панель діагностики розробника в налаштуваннях.
  • Діагностика провайдера для розробника (довгий запит):
    • Режим діагностичного виклику: оберіть шлях виконання для кожної перевірки. OpenAI-compatible провайдери підтримують додаткові примусові режими direct streaming, direct buffered і requestUrl-only на додачу до звичайних режимів виконання.
    • Запустити діагностику: запускає одну перевірку довгого запиту з вибраним режимом виклику й записує Notemd_Provider_Diagnostic_*.txt у корені vault.
    • Запустити тест стабільності: повторює перевірку задану кількість разів, від 1 до 10, з обраним режимом виклику і зберігає агрегований звіт про стабільність.
    • Тайм-аут діагностики: налаштовуваний тайм-аут на один запуск, від 15 до 3600 секунд.
    • Навіщо це потрібно: швидше за ручне відтворення, коли провайдер проходить "Test connection", але падає на реальних довгих завданнях, наприклад перекладі через повільний gateway. stable API calls

Загальні налаштування

Вихід обробленого файлу

  • Customize Processed File Save Path:

    • Вимкнено (типово): оброблені файли, наприклад YourNote_processed.md, зберігаються в тій самій папці, що й оригінальна нотатка.
    • Увімкнено: дозволяє вказати власне місце збереження.

  • Processed File Folder Path: видно лише коли попередню опцію ввімкнено. Введіть відносний шлях усередині vault, наприклад Processed Notes або Output/LLM, куди мають зберігатися оброблені файли. Папки буде створено, якщо вони не існують. Не використовуйте абсолютні шляхи, як C:\..., або недійсні символи.

  • Use Custom Output Filename for 'Add Links':

    • Вимкнено (типово): оброблені файли, створені командою 'Add Links', використовують типовий suffix _processed.md, наприклад YourNote_processed.md.
    • Увімкнено: дозволяє налаштувати вихідну назву файла через параметр нижче.

  • Custom Suffix/Replacement String: видно лише коли попередню опцію ввімкнено. Введіть рядок, який треба використати для вихідної назви файлу.

    • Якщо залишити поле порожнім, оригінальний файл буде перезаписано обробленим вмістом.
    • Якщо ви введете рядок, наприклад _linked, його буде додано до базової назви оригіналу, наприклад YourNote_linked.md. Переконайтеся, що suffix не містить недійсних символів імені файлу.

  • Remove Code Fences on Add Links:

    • Вимкнено (типово): code fence (`\``) зберігаються у вмісті під час додавання посилань, а (`\`markdown) буде видалено автоматично.
    • Увімкнено: видаляє code fence із контенту перед додаванням посилань. Processed file output

Вивід концептуальної нотатки

  • Customize Concept Note Path:
    • Вимкнено (типово): автоматичне створення нотаток для [[linked concepts]] вимкнено.
    • Увімкнено: дозволяє вказати папку, де створюватимуться нові concept note.
  • Concept Note Folder Path: видно лише коли попередню опцію ввімкнено. Введіть відносний шлях усередині vault, наприклад Concepts або Generated/Topics, куди зберігатимуться нові concept note. Папки буде створено, якщо їх немає. Обов'язково має бути заповнено, якщо налаштування ввімкнено. Не використовуйте абсолютні шляхи або недійсні символи. concept note output

Вихід log-файлу понять

  • Generate Concept Log File:
    • Вимкнено (типово): log-файл не створюється.
    • Увімкнено: створює log-файл із переліком нових concept note після обробки. Формат: 
      створити xx md-файлів понять
1. concepts1
2. concepts2
...
n. conceptsn
  • Customize Log File Save Path: видно лише коли ввімкнено "Generate Concept Log File".
    • Вимкнено (типово): log-файл зберігається у Concept Note Folder Path, якщо її вказано, або в корені vault в іншому випадку.
    • Увімкнено: дозволяє вказати власну папку для log-файлу.
  • Concept Log Folder Path: видно лише коли ввімкнено "Customize Log File Save Path". Введіть відносний шлях усередині vault, наприклад Logs/Notemd, куди має зберігатися log-файл. Обов'язково має бути заповнено, якщо налаштування ввімкнено.
  • Customize Log File Name: видно лише коли ввімкнено "Generate Concept Log File".
    • Вимкнено (типово): log-файл має назву Generate.log.
    • Увімкнено: дозволяє вказати власну назву log-файлу.
  • Concept Log File Name: видно лише коли ввімкнено "Customize Log File Name". Введіть бажану назву файлу, наприклад ConceptCreation.log. Обов'язково має бути заповнено, якщо налаштування ввімкнено. Concept log file output

Завдання виділення понять

  • Створювати мінімальні concept note:
    • Увімкнено (типово): новостворені concept note міститимуть лише заголовок, наприклад # Concept.
    • Вимкнено: concept note можуть містити додатковий контент, наприклад backlink "Linked From", якщо його не вимкнено параметром нижче.
  • Додавати backlink "Linked From":
    • Вимкнено (типово): не додає backlink до вихідного документа в concept note під час extraction.
    • Увімкнено: додає секцію "Linked From" з backlink на вихідний файл.

Витяг конкретного оригінального тексту

  • Questions for extraction: введіть список питань, по одному на рядок, для яких ШІ має витягнути дослівні відповіді з ваших нотаток.
  • Translate output to corresponding language:
    • Off (Default): виводить лише витягнутий текст його оригінальною мовою.
    • On: додає переклад витягнутого тексту мовою, обраною для цього завдання.
  • Merged query mode:
    • Off: обробляє кожне питання окремо, що точніше, але вимагає більше API calls.
    • On: надсилає всі питання одним prompt, що швидше й потребує менше API calls.
  • Customise extracted text save path & filename:
    • Off: зберігає в тій самій папці, що й оригінальний файл, із suffix _Extracted.
    • On: дозволяє вказати власну вихідну папку та suffix назви файлу.

Пакетне виправлення Mermaid

  • Enable Mermaid Error Detection:
    • Off (Default): виявлення помилок пропускається після обробки.
    • On: сканує оброблені файли на залишкові Mermaid syntax errors і створює звіт mermaid_error_{foldername}.md.
  • Move files with Mermaid errors to specified folder:
    • Off: файли з помилками залишаються на місці.
    • On: переміщує всі файли, що після спроби виправлення все ще містять Mermaid syntax errors, до окремої папки для ручного перегляду.
  • Mermaid error folder path: видно, якщо параметр вище ввімкнено. Папка, куди слід переміщувати файли з помилками.

Параметри обробки

  • Enable Batch Parallelism:
    • Вимкнено (типово): пакетні завдання, такі як "Process Folder" або "Batch Generate from Titles", обробляють файли один за одним, послідовно.
    • Увімкнено: дозволяє плагіну обробляти кілька файлів одночасно, що може суттєво пришвидшити великі пакетні job.
  • Batch Concurrency: видно лише коли ввімкнено parallelism. Визначає максимальну кількість файлів, які обробляються паралельно. Більше значення може працювати швидше, але споживає більше ресурсів і може впертися в API rate limits. Типово: 1, діапазон: 1-20.
  • Batch Size: видно лише коли ввімкнено parallelism. Кількість файлів, що об'єднуються в один batch. Типово: 50, діапазон: 10-200.
  • Delay Between Batches (ms): видно лише коли ввімкнено parallelism. Необов'язкова затримка в мілісекундах між обробкою batch, що допомагає контролювати API rate limits. Типово: 1000 ms.
  • API Call Interval (ms): мінімальна затримка в мілісекундах до і після кожного окремого виклику LLM API. Критично для низьколімітних API або щоб запобігати 429-помилкам. Встановіть 0, якщо не хочете штучних затримок. Типово: 500 ms.
  • Chunk Word Count: максимальна кількість слів у chunk, який надсилається до LLM. Впливає на кількість API calls для великих файлів. Типово: 3000.
  • Enable Duplicate Detection: перемикає базову перевірку дублікатів слів у обробленому вмісті, результати виводяться в console. Типово: увімкнено.
  • Max Tokens: максимальна кількість token, які LLM має згенерувати в одному response chunk. Впливає на вартість і деталізацію. Типово: 4096. Processing Parameters Language settings

Переклад

  • Default Target Language: виберіть типову мову, якою ви хочете перекладати свої нотатки. Це можна перевизначити в UI під час запуску команди перекладу. Типово: English.
  • Customise Translation File Save Path:
    • Вимкнено (типово): перекладені файли зберігаються в тій самій папці, що й оригінальна нотатка.
    • Увімкнено: дозволяє вказати відносний шлях усередині vault, наприклад Translations, куди слід зберігати перекладені файли. Папки буде створено, якщо вони не існують.
  • Use custom suffix for translated files:
    • Вимкнено (типово): перекладені файли використовують типовий suffix _translated.md, наприклад YourNote_translated.md.
    • Увімкнено: дозволяє вказати власний suffix.
  • Custom Suffix: видно лише коли попередню опцію ввімкнено. Введіть власний suffix, який додаватиметься до імен перекладених файлів, наприклад _es або _fr. translate

Генерація контенту

  • Enable Research in "Generate from Title":
    • Вимкнено (типово): "Generate from Title" використовує як вхід лише заголовок.
    • Увімкнено: виконує веб-дослідження через налаштований Web Research Provider і додає знайдений контекст до prompt, який надсилається LLM під час генерації за заголовком.
  • Auto-run Mermaid Syntax Fix after Generation:
    • Увімкнено (типово): автоматично запускає Mermaid syntax-fixing pass після Mermaid-related workflow, таких як Process, Generate from Title, Batch Generate from Titles, Research & Summarize, Summarise as Mermaid і Translate.
    • Disabled: залишає згенерований Mermaid-вивід без змін, якщо ви вручну не запустите Batch Mermaid Fix або не додасте його до власного workflow.
  • Output Language: нове. Виберіть бажану мову виходу для завдань "Generate from Title" і "Batch Generate from Title".
    • English (Default): prompt обробляються і результат створюється англійською.
    • Other Languages: LLM отримує вказівку міркувати англійською, але надати фінальну документацію вашою вибраною мовою, наприклад Español, Français, 简体中文, 繁體中文, العربية, हिन्दी тощо.
  • Change Prompt Word: нове.
    • Change Prompt Word: дозволяє змінити prompt word для конкретного завдання.
    • Custom Prompt Word: введіть власний prompt word для завдання.
  • Use Custom Output Folder for 'Generate from Title':
    • Вимкнено (типово): успішно згенеровані файли переміщуються до підпапки з назвою [OriginalFolderName]_complete відносно батьківської папки оригінальної папки, або Vault_complete, якщо вихідна папка була коренем.
    • Увімкнено: дозволяє вказати власну назву підпапки, куди переміщуються завершені файли.
  • Custom Output Folder Name: видно лише коли попередню опцію ввімкнено. Введіть бажану назву підпапки, наприклад Generated Content або _complete. Недійсні символи не допускаються. Якщо залишити порожнім, типовим значенням буде _complete. Ця папка створюється відносно батьківського каталогу оригінальної папки.

Кнопки робочого процесу в один клік

  • Visual Workflow Builder: створюйте власні workflow-кнопки з вбудованих дій без ручного написання DSL.
  • Custom Workflow Buttons DSL: досвідчені користувачі все ще можуть безпосередньо редагувати текст визначення workflow. Невалідний DSL безпечно відкотиться до типового workflow і покаже попередження в UI sidebar/settings.
  • Workflow Error Strategy:
    • Stop on Error (Default): негайно зупиняє workflow, коли один крок завершується з помилкою.
    • Continue on Error: продовжує запуск наступних кроків і наприкінці повідомляє кількість невдалих дій.
  • Default Workflow Included: One-Click Extract об'єднує Process File (Add Links), Batch Generate from Titles і Batch Mermaid Fix.

Налаштування власних промптів

Ця функція дозволяє перевизначати типові інструкції, тобто prompt, які надсилаються до LLM для конкретних завдань, даючи вам тонкий контроль над результатом.

  • Enable Custom Prompts for Specific Tasks:

    • Вимкнено (типово): плагін використовує вбудовані типові prompt для всіх операцій.
    • Увімкнено: вмикає можливість задавати власні prompt для перелічених нижче завдань. Це master switch для всієї функції.

  • Use Custom Prompt for [Task Name]: видно лише коли попередню опцію ввімкнено.

    • Для кожного підтримуваного завдання, такого як "Add Links", "Generate from Title", "Research & Summarize" і "Extract Concepts", ви можете окремо ввімкнути або вимкнути власний prompt.
    • Disabled: це конкретне завдання використовуватиме типовий prompt.
    • Увімкнено: це завдання використовуватиме текст, який ви введете у відповідне поле "Custom Prompt" нижче.

  • Custom Prompt Text Area: видно лише коли для завдання ввімкнено custom prompt.

    • Default Prompt Display: для довідки плагін показує типовий prompt, який зазвичай використовувався б для цього завдання. Ви можете скористатися кнопкою "Copy Default Prompt", щоб скопіювати цей текст як відправну точку для власного prompt.
    • Custom Prompt Input: тут ви пишете власні інструкції для LLM.
    • Placeholders: ви можете і повинні використовувати спеціальні placeholders у своєму prompt. Плагін замінить їх фактичним вмістом перед надсиланням запиту до LLM. Перегляньте типовий prompt, щоб побачити, які placeholders доступні для кожного завдання. Поширені placeholders:
      • {TITLE}: заголовок поточної нотатки.
      • {RESEARCH_CONTEXT_SECTION}: контент, зібраний під час веб-дослідження.
      • {USER_PROMPT}: вміст нотатки, яка обробляється.
Content generation output Duplicate check scope Custom prompt settings

Область перевірки дублікатів

  • Duplicate Check Scope Mode: визначає, які файли перевіряються щодо potential duplicates проти нотаток у вашій Concept Note Folder.
    • Entire Vault (Default): порівнює concept note з усіма іншими нотатками у vault, окрім самої Concept Note Folder.
    • Include Specific Folders Only: порівнює concept note лише з нотатками всередині папок, перелічених нижче.
    • Exclude Specific Folders: порівнює concept note з усіма нотатками, крім тих, що лежать у папках, перелічених нижче, і також виключає саму Concept Note Folder.
    • Concept Folder Only: порівнює concept note лише з іншими нотатками всередині Concept Note Folder. Це допомагає знаходити дублікати суто серед згенерованих понять.
  • Include/Exclude Folders: видно лише якщо Mode = 'Include' або 'Exclude'. Введіть відносні шляхи папок, які хочете включити або виключити, по одному шляху на рядок. Шляхи чутливі до регістру й використовують / як separator, наприклад Reference Material/Papers або Daily Notes. Ці папки не можуть збігатися з Concept Note Folder або бути вкладеними в неї.

Провайдер веб-дослідження

  • Search Provider: оберіть між Tavily, який потребує API key і рекомендований, і DuckDuckGo, який лишається експериментальним та часто блокується search engine під час автоматизованих запитів. Використовується для "Research & Summarize Topic" і, за бажанням, для "Generate from Title".
  • Tavily API Key: видно лише якщо вибрано Tavily. Введіть свій API key із tavily.com.
  • Tavily Max Results: видно лише якщо вибрано Tavily. Максимальна кількість search results, які має повернути Tavily, від 1 до 20. Типово: 5.
  • Tavily Search Depth: видно лише якщо вибрано Tavily. Виберіть basic, типово, або advanced. Примітка: advanced дає кращі результати, але коштує 2 API credits за пошук замість 1.
  • DuckDuckGo Max Results: видно лише якщо вибрано DuckDuckGo. Максимальна кількість search results для парсингу, від 1 до 10. Типово: 5.
  • DuckDuckGo Content Fetch Timeout: видно лише якщо вибрано DuckDuckGo. Максимальна кількість секунд очікування під час спроби отримати контент із кожного URL результату DuckDuckGo. Типово: 15.
  • Max Research Content Tokens: приблизна максимальна кількість token з об'єднаних web research results, snippets або fetched content, яка включатиметься до prompt підсумовування. Допомагає контролювати розмір context window і вартість. Типово: 3000. Web research provider

Фокусна навчальна доменна область

  • Enable Focused Learning Domain:
    • Вимкнено (типово): prompt, що надсилаються до LLM, використовують стандартні інструкції загального призначення.
    • Увімкнено: дозволяє вказати одну чи кілька галузей знань, щоб покращити контекстуальне розуміння LLM.
  • Learning Domain: видно лише коли попередню опцію ввімкнено. Введіть свою конкретну галузь або галузі, наприклад 'Materials Science', 'Polymer Physics', 'Machine Learning'. Це додасть рядок "Relevant Fields: [...]" на початок prompt, допомагаючи LLM генерувати точніші й релевантніші links і контент для вашої предметної області. focused learning domain

Посібник з використання

Швидкі робочі процеси й бічна панель

  • Відкрийте бічну панель Notemd, щоб отримати доступ до згрупованих секцій дій для основної обробки, генерації, перекладу, знань і утиліт.
  • Використовуйте область Швидкі робочі процеси у верхній частині бічної панелі, щоб запускати власні багатокрокові кнопки.
  • Типовий робочий процес One-Click Extract запускає Process File (Add Links) -> Batch Generate from Titles -> Batch Mermaid Fix.
  • Прогрес робочого процесу, логи кожного кроку та помилки відображаються в бічній панелі, а закріплений нижній блок не дає progress bar і log area бути витісненими розгорнутими секціями.
  • Картка прогресу залишає текст стану, окрему плашку з відсотком і час, що залишився, читабельними з першого погляду, а ті самі власні робочі процеси можна переналаштувати з налаштувань.

Початкова обробка (додавання wiki-links)

Це основна функціональність, зосереджена на визначенні понять і додаванні [[wiki-links]].

Важливо: цей процес працює лише з файлами .md або .txt. Ви можете безкоштовно конвертувати PDF-файли у MD за допомогою Mineru перед подальшою обробкою.

  1. Використання бічної панелі:
    • Відкрийте Notemd Sidebar через значок чарівної палички або палітру команд.
    • Відкрийте файл .md або .txt.
    • Натисніть "Process File (Add Links)".
    • Щоб обробити папку: натисніть "Process Folder (Add Links)", виберіть папку й натисніть "Process".
    • Прогрес показується в бічній панелі. Ви можете скасувати завдання кнопкою "Cancel Processing" у бічній панелі.
    • Примітка щодо обробки папок: файли обробляються у фоновому режимі без відкриття в редакторі.
image
  1. Використання Command Palette (Ctrl+P або Cmd+P):
    • Один файл: відкрийте файл і запустіть Notemd: Process Current File.
    • Папка: запустіть Notemd: Process Folder, а потім виберіть папку. Файли обробляються у фоновому режимі без відкриття в редакторі.
    • Для дій із палітри команд з'являється модальне вікно прогресу з кнопкою скасування.
    • Примітка: плагін автоматично видаляє початкові рядки \boxed{ і фінальні рядки } у фінальному обробленому вмісті перед збереженням, якщо вони трапляються.

Нові можливості

  1. Підсумувати як діаграму Mermaid:

    • Відкрийте нотатку, яку хочете підсумувати.
    • Запустіть команду Notemd: Summarise as Mermaid diagram через палітру команд або кнопку в sidebar.
    • Плагін створить нову нотатку з Mermaid diagram.

  2. Translate Note/Selection:

    • Виділіть текст у нотатці, якщо хочете перекласти лише виділення, або запустіть команду без виділення, щоб перекласти всю нотатку.
    • Запустіть команду Notemd: Translate Note/Selection через палітру команд або кнопку в бічній панелі.
    • З'явиться модальне вікно, у якому можна підтвердити або змінити Target Language; типове значення береться з налаштувань у Configuration.
    • Плагін використовує налаштований LLM Provider відповідно до налаштувань кількох моделей для виконання перекладу.
    • Перекладений контент зберігається в налаштованому Translation Save Path із відповідним suffix і відкривається в новій панелі праворуч від оригінального контенту для зручного порівняння.
    • Це завдання можна скасувати через кнопку в бічній панелі або кнопку скасування в модальному вікні.

  3. Пакетний переклад:

    • Запустіть команду Notemd: Batch Translate Folder з палітри команд і виберіть папку, або натисніть правою кнопкою папку у file explorer і виберіть "Batch translate this folder".
    • Плагін перекладе всі Markdown files у вибраній папці.
    • Перекладені файли зберігаються в налаштованому translation path, але автоматично не відкриваються.
    • Цей процес можна скасувати через progress modal.
image
  1. Research & Summarize Topic:
    • Виділіть текст у нотатці АБО переконайтеся, що нотатка має заголовок, який і стане темою пошуку.
    • Запустіть команду Notemd: Research and Summarize Topic через палітру команд або кнопку в бічній панелі.
    • Плагін використовує налаштований Search Provider, тобто Tavily або DuckDuckGo, і відповідний LLM Provider на основі налаштувань кількох моделей, щоб знайти й підсумувати інформацію.
    • Підсумок додається до поточної нотатки.
    • Це завдання можна скасувати через кнопку в бічній панелі або кнопку скасування в модальному вікні.
    • Примітка: DuckDuckGo search може давати збої через bot detection. Рекомендується Tavily.
image

  1. Generate Content from Title:

    • Відкрийте нотатку, вона може бути порожньою.
    • Запустіть команду Notemd: Generate Content from Title через палітру команд або кнопку в бічній панелі.
    • Плагін використовує відповідний LLM Provider на основі налаштувань кількох моделей, щоб згенерувати контент із заголовка нотатки, замінивши будь-який наявний вміст.
    • Якщо ввімкнено параметр "Enable Research in 'Generate from Title'", спочатку буде виконано веб-дослідження через налаштований Web Research Provider, а його результати буде додано як контекст до prompt, який надсилається до LLM.
    • Це завдання можна скасувати через кнопку в бічній панелі або кнопку скасування в модальному вікні.

  2. Batch Generate Content from Titles:

    • Запустіть команду Notemd: Batch Generate Content from Titles через палітру команд або кнопку в бічній панелі.
    • Виберіть папку з нотатками, які треба обробити.
    • Плагін пройде по кожному .md файлу в папці, виключаючи _processed.md files і файли в призначеній "complete" папці, генеруючи контент із заголовка й замінюючи наявний вміст. Файли обробляються у фоні без відкриття в редакторі.
    • Успішно оброблені файли переміщуються в налаштовану "complete" папку.
    • Ця команда враховує параметр "Enable Research in 'Generate from Title'" для кожної оброблюваної нотатки.
    • Це завдання можна скасувати через кнопку в бічній панелі або кнопку скасування в модальному вікні.
    • Прогрес і результати, зокрема кількість змінених файлів та помилки, показуються в бічній панелі або журналі модального вікна. image

  3. Check and Remove Duplicate Concept Notes:

    • Переконайтеся, що Concept Note Folder Path правильно налаштовано в налаштуваннях.
    • Запустіть Notemd: Check and Remove Duplicate Concept Notes через палітру команд або кнопку в бічній панелі.
    • Плагін сканує concept note folder і порівнює назви файлів із нотатками поза цією папкою за кількома правилами, як exact match, plurals, normalization і containment.
    • Якщо знайдено потенційні дублікати, з'явиться модальне вікно зі списком файлів, причиною позначення й конфліктними файлами.
    • Уважно перегляньте список. Натисніть "Delete Files", щоб перемістити перелічені файли до системного кошика, або "Cancel", щоб нічого не робити.
    • Прогрес і результати показуються в бічній панелі або журналі модального вікна.

  4. Extract Concepts (Pure Mode):

    • Ця функція дозволяє витягувати поняття з документа і створювати відповідні concept note без зміни оригінального файлу. Це чудовий спосіб швидко наповнити вашу базу знань із набору документів.
    • Один файл: відкрийте файл і запустіть команду Notemd: Extract concepts (create concept notes only) з палітри команд або натисніть кнопку "Extract concepts (current file)" у бічній панелі.
    • Папка: запустіть команду Notemd: Batch extract concepts from folder з палітри команд або натисніть кнопку "Extract concepts (folder)" у бічній панелі, а потім виберіть папку, щоб обробити всі її нотатки.
    • Плагін прочитає файли, визначить поняття і створить для них нові нотатки у вашій Concept Note Folder, не змінюючи оригінальні файли.

  5. Create Wiki-Link & Generate Note from Selection:

    • Ця потужна команда спрощує процес створення й наповнення нових concept note.
    • Виділіть слово або фразу в editor.
    • Запустіть команду Notemd: Create Wiki-Link & Generate Note from Selection; рекомендовано призначити їй hotkey, наприклад Cmd+Shift+W.
    • Плагін виконає:
      1. Замінить виділений текст на [[wiki-link]].
      2. Перевірить, чи існує нотатка з таким заголовком у Concept Note Folder.
      3. Якщо існує, додасть backlink до поточної нотатки.
      4. Якщо не існує, створить нову порожню нотатку.
      5. Потім автоматично запустить команду "Generate Content from Title" для нової або наявної нотатки й наповнить її AI-згенерованим контентом.

  6. Extract Concepts and Generate Titles:

    • Ця команда об'єднує дві потужні функції в один зручний робочий процес.
    • Запустіть команду Notemd: Extract Concepts and Generate Titles з палітри команд; рекомендовано призначити їй hotkey.
    • Плагін виконає:
      1. Спочатку завдання "Extract concepts (current file)" для поточного активного файлу.
      2. Потім автоматично запустить завдання "Batch generate from titles" для папки, яку ви вказали в settings як Concept note folder path.
    • Це дозволяє спочатку поповнити базу знань новими поняттями з вихідного документа, а потім одразу розгорнути ці нові concept note AI-згенерованим контентом в одному кроці.

  7. Extract Specific Original Text:

    • Налаштуйте свої питання в settings у секції "Extract Specific Original Text".
    • Використовуйте кнопку "Extract Specific Original Text" у sidebar, щоб обробити активний файл.
    • Merged Mode: дозволяє швидшу обробку, надсилаючи всі питання в одному prompt.
    • Translation: за бажанням перекладає витягнутий текст обраною мовою.
    • Custom Output: налаштовуйте, де і як зберігається файл із витягнутим текстом.

  8. Batch Mermaid Fix:

    • Використовуйте кнопку "Batch Mermaid Fix" у sidebar, щоб просканувати папку й виправити типові Mermaid syntax errors.
    • Плагін повідомить про файли, у яких після цього все ще лишилися помилки, у файлі mermaid_error_{foldername}.md.
    • За бажанням налаштуйте плагін так, щоб переміщувати ці проблемні файли до окремої папки для review.

Підтримувані провайдери LLM

Provider Type API Key Required Notes
DeepSeek Хмара Так Нативний endpoint DeepSeek з підтримкою reasoning-моделей
Qwen Хмара Так DashScope compatible-mode preset для моделей Qwen / QwQ
Qwen Code Хмара Так DashScope preset, орієнтований на кодерські моделі Qwen
Doubao Хмара Так Preset Volcengine Ark; зазвичай у поле model треба вказувати ваш endpoint ID
Moonshot Хмара Так Офіційний endpoint Kimi / Moonshot
GLM Хмара Так Офіційний Zhipu BigModel OpenAI-compatible endpoint
Z AI Хмара Так Міжнародний GLM/Zhipu OpenAI-compatible endpoint; доповнює GLM
MiniMax Хмара Так Офіційний MiniMax chat-completions endpoint
Huawei Cloud MaaS Хмара Так Huawei ModelArts MaaS OpenAI-compatible endpoint для hosted models
Baidu Qianfan Хмара Так Офіційний Qianfan OpenAI-compatible endpoint для моделей ERNIE
SiliconFlow Хмара Так Офіційний SiliconFlow OpenAI-compatible endpoint для hosted OSS models
OpenAI Хмара Так Підтримує GPT та моделі o-series
Anthropic Хмара Так Підтримує моделі Claude
Google Хмара Так Підтримує моделі Gemini
Mistral Хмара Так Підтримує сімейства Mistral і Codestral
Azure OpenAI Хмара Так Потребує Endpoint, API Key, deployment name і API Version
OpenRouter Шлюз Так Доступ до багатьох провайдерів через OpenRouter model ID
xAI Хмара Так Нативний endpoint Grok
Groq Хмара Так Швидка OpenAI-compatible inference для hosted OSS models
Together Хмара Так OpenAI-compatible endpoint для hosted OSS models
Fireworks Хмара Так OpenAI-compatible inference endpoint
Requesty Шлюз Так Multi-provider router за одним API key
OpenAI Compatible Шлюз Optional Універсальний preset для LiteLLM, vLLM, Perplexity, Vercel AI Gateway тощо
LMStudio Локально Optional (EMPTY) Запускає моделі локально через сервер LM Studio
Ollama Локально Ні Запускає моделі локально через сервер Ollama

Примітка: для локальних провайдерів, LMStudio й Ollama, переконайтеся, що відповідний серверний застосунок запущений і доступний за налаштованим Base URL. Примітка: для OpenRouter і Requesty використовуйте provider-prefixed або повний model identifier, який показує gateway, наприклад google/gemini-flash-1.5 або anthropic/claude-3-7-sonnet-latest. Примітка: Doubao зазвичай очікує в полі model Ark endpoint або deployment ID, а не сиру назву model family. Екран settings тепер попереджає, якщо там усе ще стоїть placeholder value, і блокує connection tests, доки ви не заміните його справжнім endpoint ID. Примітка: Z AI використовує міжнародну лінію api.z.ai, тоді як GLM лишається на материковому китайському BigModel endpoint. Вибирайте preset відповідно до регіону вашого акаунта. Примітка: пресети, орієнтовані на Китай, використовують chat-first connection checks, щоб тест перевіряв фактично налаштовану model/deployment, а не лише доступність API key. Примітка: OpenAI Compatible призначений для кастомних gateway і proxy. Налаштуйте Base URL, політику API key і model ID відповідно до документації вашого провайдера.

Використання мережі та обробка даних

Notemd працює локально всередині Obsidian, але деякі функції надсилають зовнішні запити.

Виклики до провайдерів LLM (налаштовувані)

  • Тригер: обробка файлів, генерація, переклад, підсумування досліджень, Mermaid-підсумування та actions з перевірки підключення або діагностики.
  • Endpoint: ваші налаштовані provider base URL у settings Notemd.
  • Дані, що надсилаються: текст prompt і task content, потрібний для обробки.
  • Примітка щодо обробки даних: API keys налаштовуються локально в settings плагіна і використовуються для підпису запитів з вашого пристрою.

Виклики веб-дослідження (необов'язково)

  • Тригер: коли веб-дослідження ввімкнено і вибрано search provider.
  • Endpoint: Tavily API або DuckDuckGo endpoint.
  • Дані, що надсилаються: ваш пошуковий запит і необхідні request metadata.

Діагностика для розробників і журнали налагодження (необов'язково)

  • Тригер: режим API debug і дії developer diagnostic.
  • Зберігання: diagnostic і error log записуються в корінь вашого vault, наприклад Notemd_Provider_Diagnostic_*.txt і Notemd_Error_Log_*.txt.
  • Примітка про ризики: logs можуть містити уривки request і response. Переглядайте їх перед публічним поширенням.

Локальне зберігання

  • Конфігурація плагіна зберігається в .obsidian/plugins/notemd/data.json.
  • Згенеровані файли, звіти й необов'язкові log зберігаються у вашому vault згідно з settings.

Усунення неполадок

Поширені проблеми

  • Плагін не завантажується: переконайтеся, що manifest.json, main.js і styles.css лежать у правильній папці, <Vault>/.obsidian/plugins/notemd/, і перезапустіть Obsidian. Перевірте Developer Console через Ctrl+Shift+I або Cmd+Option+I, чи немає помилок під час startup.
  • Збої обробки / API errors:
    1. Перевірте формат файлу: переконайтеся, що файл, який ви намагаєтеся обробити або перевірити, має розширення .md або .txt. Наразі Notemd підтримує лише ці текстові формати.
    2. Використайте команду або кнопку "Test LLM Connection", щоб перевірити settings для активного провайдера.
    3. Ще раз перевірте API Key, Base URL, Model Name і API Version, для Azure. Переконайтеся, що API key правильний і має достатньо credits або permissions.
    4. Переконайтеся, що ваш локальний LLM server, LMStudio або Ollama, запущений, а Base URL правильний, наприклад http://localhost:1234/v1 для LMStudio.
    5. Перевірте інтернет-з'єднання для хмарних провайдерів.
    6. Для помилок обробки одного файлу: перегляньте Developer Console для детальних error message. За потреби скопіюйте їх кнопкою в error modal.
    7. Для пакетних помилок: перевірте файл error_processing_filename.log у корені vault, щоб побачити детальні error message для кожного файлу, що завершився невдало. Developer Console або error modal можуть показувати лише summary або загальну batch error.
    8. Автоматичні журнали помилок: якщо процес завершується невдачею, плагін автоматично зберігає детальний log-файл із назвою Notemd_Error_Log_[Timestamp].txt у кореневому каталозі vault. Цей файл містить error message, трасування стека і session logs. Якщо проблеми повторюються, перевірте цей файл. Увімкнення "API Error Debugging Mode" у settings наповнить log ще детальнішими API response data.
    9. Діагностика довгих запитів до реального endpoint, для розробників:
      • Шлях усередині плагіна, рекомендовано спочатку: використайте Settings -> Notemd -> Developer provider diagnostic (long request), щоб запустити runtime probe на активному провайдері й згенерувати Notemd_Provider_Diagnostic_*.txt у корені vault.
      • CLI-шлях, поза Obsidian runtime: для відтворюваного порівняння buffered і streaming behavior на рівні endpoint використайте: 
        npm run diagnose:llm -- \
  --transport openai-compatible \
  --provider-name OpenRouter \
  --base-url https://openrouter.ai/api/v1 \
  --api-key "$OPENROUTER_API_KEY" \
  --model anthropic/claude-3.7-sonnet \
  --prompt-file ./tmp/prompt.txt \
  --content-file ./tmp/content.txt \
  --mode compare \
  --timeout-ms 360000 \
  --output ./tmp/openrouter-diagnostic.txt
        Згенерований звіт містить timing для кожної attempt, тобто First Byte і Duration, очищені request metadata, response headers, raw або partial body fragments, parsed stream fragments і точки збоїв transport layer.
  • Проблеми з підключенням LM Studio/Ollama:
    • Перевірка з'єднання не проходить: переконайтеся, що локальний сервер, LM Studio або Ollama, запущений і правильну model завантажено або вона доступна.
    • CORS Errors, Ollama on Windows: якщо ви стикаєтеся з CORS, тобто Cross-Origin Resource Sharing errors, під час використання Ollama у Windows, вам може знадобитися задати environment variable OLLAMA_ORIGINS. Це можна зробити, виконавши set OLLAMA_ORIGINS=* у command prompt перед запуском Ollama. Це дозволяє запити з будь-якого origin.
    • Enable CORS in LM Studio: для LM Studio ви можете увімкнути CORS безпосередньо в server settings; це може бути необхідно, якщо Obsidian працює в browser або має суворі origin policies.
  • Помилки створення папок ("File name cannot contain..."):
    • Зазвичай це означає, що шлях, указаний у settings, тобто Processed File Folder Path або Concept Note Folder Path, є недійсним для Obsidian.
    • Переконайтеся, що ви використовуєте відносні шляхи, наприклад Processed або Notes/Concepts, а не абсолютні шляхи, як C:\Users\... або /Users/....
    • Перевірте недійсні символи: * " \ / < > : | ? # ^ [ ]. Зверніть увагу, що \ є недійсним навіть у Windows для шляхів Obsidian. Використовуйте / як path separator.
  • Проблеми з продуктивністю: обробка великих файлів або багатьох файлів може займати час. Зменште параметр "Chunk Word Count", якщо хочете потенційно швидші, але численніші API calls. Спробуйте іншого провайдера LLM або іншу модель.
  • Неочікуване linking: якість linking сильно залежить від LLM і prompt. Експериментуйте з різними моделями або параметрами температури.

Внесок

Вітаються будь-які внески. Будь ласка, зверніться до GitHub-репозиторію за інструкціями: https://github.com/Jacobinwwey/obsidian-NotEMD

Документація для супроводу

Ліцензія

Ліцензія MIT. Докладніше див. у файлі LICENSE.

Notemd v1.9.3 - Розширюйте свій граф знань Obsidian за допомогою ШІ.

Хроніка Розвитку

Ця квартальна хроніка зберігає оригінальний візуальний стиль repo-saga; квартальний поділ тепер генерує сам repo-saga напряму.

Notemd Development Chronicle

Востаннє оновлено для тега релізу 1.9.3: 2026-06-24. Дата останнього коміту: 2026-06-24.

Star History Chart