From c9a61c405a238cdc7cf66cdfcf95a57cb5d4e4e9 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sun, 12 Apr 2026 16:13:06 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/plugins/memory-wiki.md | 261 ++++++++++++++++++++++----------- 1 file changed, 174 insertions(+), 87 deletions(-) diff --git a/docs/uk/plugins/memory-wiki.md b/docs/uk/plugins/memory-wiki.md index ca3dfa1e1..3f7c7c3bf 100644 --- a/docs/uk/plugins/memory-wiki.md +++ b/docs/uk/plugins/memory-wiki.md @@ -1,49 +1,78 @@ --- read_when: - - Вам потрібні постійні знання понад звичайні нотатки MEMORY.md - - Ви налаштовуєте вбудований плагін memory-wiki - - Ви хочете зрозуміти wiki_search, wiki_get або режим bridge -summary: 'memory-wiki: скомпільоване сховище знань із походженням, твердженнями, панелями та режимом bridge' + - Вам потрібні постійні знання, що виходять за межі простих нотаток у `MEMORY.md` + - Ви налаштовуєте вбудований Plugin memory-wiki + - Ви хочете зрозуміти `wiki_search`, `wiki_get` або режим bridge +summary: 'memory-wiki: скомпільоване сховище знань із provenance, claims, dashboards і режимом bridge' title: Memory Wiki x-i18n: - generated_at: "2026-04-08T03:01:25Z" + generated_at: "2026-04-12T16:12:23Z" model: gpt-5.4 provider: openai - source_hash: b78dd6a4ef4451dae6b53197bf0c7c2a2ba846b08e4a3a93c1026366b1598d82 + source_hash: 44d168a7096f744c56566ecac57499192eb101b4dd8a78e1b92f3aa0d6da3ad1 source_path: plugins/memory-wiki.md workflow: 15 --- # Memory Wiki -`memory-wiki` — це вбудований плагін, який перетворює довготривалу пам’ять на скомпільоване сховище знань. +`memory-wiki` — це вбудований Plugin, який перетворює довготривалу пам’ять на скомпільоване +сховище знань. -Він **не** замінює активний плагін пам’яті. Активний плагін пам’яті, як і раніше, відповідає за пригадування, просування, індексацію та dreaming. `memory-wiki` працює поруч із ним і компілює довготривалі знання в навігаційну wiki з детермінованими сторінками, структурованими твердженнями, походженням, панелями та машиночитними дайджестами. +Він **не** замінює Plugin active memory. Plugin active memory і далі +відповідає за recall, promotion, indexing і Dreaming. `memory-wiki` працює поруч +із ним і компілює довготривалі знання в навігаційну wiki з детермінованими сторінками, +структурованими claims, provenance, dashboards і машинозчитуваними digest-ами. -Використовуйте його, якщо хочете, щоб пам’ять поводилася більше як підтримуваний шар знань, а не як купа файлів Markdown. +Використовуйте його, якщо хочете, щоб пам’ять працювала більше як підтримуваний +рівень знань, а не як купа файлів Markdown. ## Що він додає -- Окреме сховище wiki з детермінованим макетом сторінок -- Структуровані метадані тверджень і доказів, а не лише звичайний текст -- Походження на рівні сторінки, впевненість, суперечності та відкриті питання -- Скомпільовані дайджести для споживачів agent/runtime +- Виділене сховище wiki з детермінованою структурою сторінок +- Структуровані метадані claims і evidence, а не лише прозовий текст +- Provenance, confidence, contradictions і open questions на рівні сторінки +- Скомпільовані digest-и для агентів/компонентів runtime - Власні для wiki інструменти search/get/apply/lint -- Необов’язковий режим bridge, який імпортує публічні артефакти з активного плагіна пам’яті +- Необов’язковий режим bridge, який імпортує публічні артефакти з Plugin active memory - Необов’язковий режим рендерингу, дружній до Obsidian, та інтеграція з CLI ## Як це поєднується з пам’яттю -Думайте про цей поділ так: +Уявіть цей поділ так: -| Шар | Відповідає за | -| ------------------------------------------------------- | ------------------------------------------------------------------------------------------ | -| Активний плагін пам’яті (`memory-core`, QMD, Honcho тощо) | Пригадування, семантичний пошук, просування, dreaming, runtime пам’яті | -| `memory-wiki` | Скомпільовані wiki-сторінки, синтези з багатим походженням, панелі, wiki-специфічний search/get/apply | +| Рівень | Відповідає за | +| ------------------------------------------------------- | ----------------------------------------------------------------------------------------- | +| Plugin active memory (`memory-core`, QMD, Honcho тощо) | Recall, semantic search, promotion, Dreaming, runtime пам’яті | +| `memory-wiki` | Скомпільовані wiki-сторінки, синтези з багатим provenance, dashboards, wiki-специфічні search/get/apply | -Якщо активний плагін пам’яті надає спільні артефакти пригадування, OpenClaw може шукати в обох шарах за один прохід через `memory_search corpus=all`. +Якщо Plugin active memory надає спільні артефакти recall, OpenClaw може шукати +в обох рівнях за один прохід через `memory_search corpus=all`. -Коли вам потрібні wiki-специфічне ранжування, походження або прямий доступ до сторінки, використовуйте натомість wiki-native інструменти. +Коли вам потрібні wiki-специфічне ранжування, provenance або прямий доступ до сторінки, +замість цього використовуйте власні інструменти wiki. + +## Рекомендований гібридний шаблон + +Надійний варіант за замовчуванням для локальних конфігурацій — це: + +- QMD як backend active memory для recall і широкого semantic search +- `memory-wiki` у режимі `bridge` для довготривалих синтезованих сторінок знань + +Такий поділ добре працює, тому що кожен рівень зберігає свою спеціалізацію: + +- QMD зберігає можливість пошуку по сирих нотатках, експортам сеансів і додаткових колекціях +- `memory-wiki` компілює стабільні сутності, claims, dashboards і сторінки джерел + +Практичне правило: + +- використовуйте `memory_search`, коли хочете один широкий прохід recall по пам’яті +- використовуйте `wiki_search` і `wiki_get`, коли вам потрібні wiki-результати з урахуванням provenance +- використовуйте `memory_search corpus=all`, коли хочете, щоб спільний пошук охоплював обидва рівні + +Якщо режим bridge повідомляє про нуль експортованих артефактів, Plugin active memory +зараз іще не надає публічні bridge-входи. Спочатку виконайте `openclaw wiki doctor`, +потім підтвердьте, що Plugin active memory підтримує публічні артефакти. ## Режими сховища @@ -53,31 +82,36 @@ x-i18n: Власне сховище, власні джерела, без залежності від `memory-core`. -Використовуйте це, якщо хочете, щоб wiki була власним куруваним сховищем знань. +Використовуйте це, якщо хочете, щоб wiki була окремим куруваним сховищем знань. ### `bridge` -Зчитує публічні артефакти пам’яті та події пам’яті з активного плагіна пам’яті через публічні шви plugin SDK. +Читає публічні артефакти пам’яті та memory events із Plugin active memory +через публічні шви Plugin SDK. -Використовуйте це, якщо хочете, щоб wiki компілювала й упорядковувала експортовані артефакти плагіна пам’яті без звернення до приватних внутрішніх компонентів плагіна. +Використовуйте це, якщо хочете, щоб wiki компілювала й упорядковувала +експортовані артефакти Plugin memory без звернення до приватних внутрішніх +компонентів Plugin. Режим bridge може індексувати: - експортовані артефакти пам’яті -- звіти dreaming -- щоденні нотатки +- dream reports +- daily notes - кореневі файли пам’яті -- журнали подій пам’яті +- журнали memory events ### `unsafe-local` -Явний експериментальний вихід для приватних локальних шляхів на тій самій машині. +Явний аварійний варіант для доступу до локальних приватних шляхів на тій самій машині. -Цей режим навмисно є експериментальним і непереносним. Використовуйте його лише тоді, коли розумієте межу довіри і вам справді потрібен доступ до локальної файлової системи, який режим bridge не може надати. +Цей режим навмисно є експериментальним і непереносним. Використовуйте його лише тоді, +коли розумієте межу довіри та справді потребуєте доступу до локальної файлової системи, +який режим bridge не може надати. -## Макет сховища +## Структура сховища -Плагін ініціалізує сховище так: +Plugin ініціалізує сховище так: ```text / @@ -95,21 +129,22 @@ x-i18n: .openclaw-wiki/ ``` -Керований вміст залишається всередині згенерованих блоків. Блоки нотаток, створені людиною, зберігаються. +Керований вміст зберігається всередині згенерованих блоків. Блоки нотаток, +створені людиною, зберігаються. Основні групи сторінок: -- `sources/` для імпортованого сирого матеріалу та сторінок, підкріплених bridge -- `entities/` для довготривалих сутностей, людей, систем, проєктів і об’єктів +- `sources/` для імпортованих сирих матеріалів і сторінок, що підтримуються bridge +- `entities/` для довготривалих речей, людей, систем, проєктів і об’єктів - `concepts/` для ідей, абстракцій, шаблонів і політик -- `syntheses/` для скомпільованих підсумків і підтримуваних зведень -- `reports/` для згенерованих панелей +- `syntheses/` для скомпільованих зведень і підтримуваних зведених матеріалів +- `reports/` для згенерованих dashboards -## Структуровані твердження та докази +## Структуровані claims і evidence Сторінки можуть містити структурований frontmatter `claims`, а не лише довільний текст. -Кожне твердження може містити: +Кожен claim може містити: - `id` - `text` @@ -118,7 +153,7 @@ x-i18n: - `evidence[]` - `updatedAt` -Записи доказів можуть містити: +Записи evidence можуть містити: - `sourceId` - `path` @@ -127,27 +162,31 @@ x-i18n: - `note` - `updatedAt` -Саме це робить wiki більше схожою на шар переконань, ніж на пасивне сховище нотаток. Твердження можна відстежувати, оцінювати, оскаржувати й пов’язувати назад із джерелами. +Саме це змушує wiki діяти радше як рівень переконань, а не як пасивне +сховище нотаток. Claims можна відстежувати, оцінювати, оскаржувати й пов’язувати +назад із джерелами. ## Конвеєр компіляції -Крок компіляції читає wiki-сторінки, нормалізує підсумки та створює стабільні артефакти для машин під: +Крок compile читає wiki-сторінки, нормалізує зведення та створює стабільні +машинно-орієнтовані артефакти в: - `.openclaw-wiki/cache/agent-digest.json` - `.openclaw-wiki/cache/claims.jsonl` -Ці дайджести існують для того, щоб агентам і коду runtime не доводилося парсити сторінки Markdown. +Ці digest-и існують для того, щоб агентам і коду runtime не доводилося +парсити сторінки Markdown. Скомпільований вивід також забезпечує: -- первинну індексацію wiki для потоків search/get -- пошук за id тверджень із поверненням до сторінок-власників +- первинне wiki-індексування для потоків search/get +- пошук claim-id назад до сторінок-власників - компактні доповнення до prompt -- генерацію звітів/панелей +- генерацію reports/dashboard -## Панелі та звіти про стан +## Dashboards і звіти про стан -Коли ввімкнено `render.createDashboards`, компіляція підтримує панелі в `reports/`. +Коли ввімкнено `render.createDashboards`, compile підтримує dashboards у `reports/`. Вбудовані звіти включають: @@ -159,21 +198,21 @@ x-i18n: Ці звіти відстежують такі речі, як: -- кластери нотаток із суперечностями -- кластери конкуруючих тверджень -- твердження без структурованих доказів -- сторінки й твердження з низькою впевненістю -- застарілі або з невідомою свіжістю +- кластери нотаток про contradictions +- кластери конкуруючих claims +- claims без структурованого evidence +- сторінки й claims із низьким confidence +- застарілість або невідому актуальність - сторінки з невирішеними питаннями ## Пошук і отримання -`memory-wiki` підтримує два бекенди пошуку: +`memory-wiki` підтримує два backend-и пошуку: - `shared`: використовувати спільний потік пошуку в пам’яті, якщо він доступний -- `local`: шукати локально в wiki +- `local`: шукати в wiki локально -Він також підтримує три корпуси: +Він також підтримує три corpus: - `wiki` - `memory` @@ -181,19 +220,20 @@ x-i18n: Важлива поведінка: -- `wiki_search` і `wiki_get` використовують скомпільовані дайджести як перший прохід, коли це можливо -- id тверджень можуть повертати до сторінки-власника -- оспорювані/застарілі/свіжі твердження впливають на ранжування -- мітки походження можуть зберігатися в результатах +- `wiki_search` і `wiki_get` використовують скомпільовані digest-и як перший прохід, коли це можливо +- id claims можуть повертати перехід назад до сторінки-власника +- contested/stale/fresh claims впливають на ранжування +- мітки provenance можуть зберігатися в результатах Практичне правило: -- використовуйте `memory_search corpus=all` для одного широкого проходу пригадування -- використовуйте `wiki_search` + `wiki_get`, коли вам важливі wiki-специфічне ранжування, походження або структура переконань на рівні сторінки +- використовуйте `memory_search corpus=all` для одного широкого проходу recall +- використовуйте `wiki_search` + `wiki_get`, коли вам важливі wiki-специфічне ранжування, + provenance або структура переконань на рівні сторінки ## Інструменти агента -Плагін реєструє такі інструменти: +Plugin реєструє такі інструменти: - `wiki_status` - `wiki_search` @@ -204,26 +244,31 @@ x-i18n: Що вони роблять: - `wiki_status`: поточний режим сховища, стан, доступність Obsidian CLI -- `wiki_search`: пошук по wiki-сторінках і, коли налаштовано, по спільних корпусах пам’яті -- `wiki_get`: читання wiki-сторінки за id/шляхом або повернення до спільного корпусу пам’яті -- `wiki_apply`: вузькі мутації синтезу/метаданих без довільного редагування сторінки -- `wiki_lint`: структурні перевірки, прогалини в походженні, суперечності, відкриті питання +- `wiki_search`: пошук по wiki-сторінках і, за налаштуванням, по спільних corpus пам’яті +- `wiki_get`: читання wiki-сторінки за id/шляхом або повернення до спільного corpus пам’яті +- `wiki_apply`: вузькі мутації syntheses/metadata без довільного редагування сторінки +- `wiki_lint`: структурні перевірки, прогалини provenance, contradictions, open questions -Плагін також реєструє невиключне доповнення до корпусу пам’яті, тож спільні `memory_search` і `memory_get` можуть звертатися до wiki, коли активний плагін пам’яті підтримує вибір корпусу. +Plugin також реєструє невиключне доповнення corpus пам’яті, тому спільні +`memory_search` і `memory_get` можуть звертатися до wiki, коли Plugin active memory +підтримує вибір corpus. ## Поведінка prompt і контексту -Коли ввімкнено `context.includeCompiledDigestPrompt`, розділи prompt пам’яті додають компактний скомпільований знімок із `agent-digest.json`. +Коли ввімкнено `context.includeCompiledDigestPrompt`, розділи prompt пам’яті +додають компактний скомпільований знімок із `agent-digest.json`. -Цей знімок навмисно є малим і високосигнальним: +Цей знімок навмисно малий і високосигнальний: - лише верхні сторінки -- лише верхні твердження -- кількість суперечностей +- лише верхні claims +- кількість contradictions - кількість питань -- кваліфікатори впевненості/свіжості +- qualifiers confidence/freshness -Це опціонально, бо змінює форму prompt і здебільшого корисне для рушіїв контексту або застарілих механізмів складання prompt, які явно споживають доповнення пам’яті. +Це опція за вибором, бо вона змінює форму prompt і головним чином корисна для +рушіїв контексту або застарілих механізмів збирання prompt, які явно споживають +доповнення пам’яті. ## Конфігурація @@ -279,17 +324,58 @@ x-i18n: } ``` -Ключові перемикачі: +Основні перемикачі: - `vaultMode`: `isolated`, `bridge`, `unsafe-local` - `vault.renderMode`: `native` або `obsidian` -- `bridge.readMemoryArtifacts`: імпортувати публічні артефакти активного плагіна пам’яті +- `bridge.readMemoryArtifacts`: імпортувати публічні артефакти Plugin active memory - `bridge.followMemoryEvents`: включати журнали подій у режимі bridge - `search.backend`: `shared` або `local` - `search.corpus`: `wiki`, `memory` або `all` -- `context.includeCompiledDigestPrompt`: додавати компактний знімок дайджесту до розділів prompt пам’яті -- `render.createBacklinks`: генерувати детерміновані пов’язані блоки -- `render.createDashboards`: генерувати сторінки панелей +- `context.includeCompiledDigestPrompt`: додавати компактний знімок digest до розділів prompt пам’яті +- `render.createBacklinks`: генерувати детерміновані related-блоки +- `render.createDashboards`: генерувати dashboard-сторінки + +### Приклад: QMD + режим bridge + +Використовуйте це, коли хочете QMD для recall, а `memory-wiki` — для підтримуваного +рівня знань: + +```json5 +{ + memory: { + backend: "qmd", + "memory-wiki": { + enabled: true, + config: { + vaultMode: "bridge", + bridge: { + enabled: true, + readMemoryArtifacts: true, + indexDreamReports: true, + indexDailyNotes: true, + indexMemoryRoot: true, + followMemoryEvents: true, + }, + search: { + backend: "shared", + corpus: "all", + }, + context: { + includeCompiledDigestPrompt: false, + }, + }, + }, + }, + }, +} +``` + +Це зберігає: + +- QMD відповідає за recall в active memory +- `memory-wiki` зосереджений на скомпільованих сторінках і dashboards +- форму prompt незмінною, доки ви свідомо не ввімкнете prompts скомпільованого digest ## CLI @@ -309,11 +395,12 @@ openclaw wiki bridge import openclaw wiki obsidian status ``` -Див. [CLI: wiki](/cli/wiki), щоб переглянути повний довідник команд. +Повний довідник команд див. у [CLI: wiki](/cli/wiki). ## Підтримка Obsidian -Коли `vault.renderMode` має значення `obsidian`, плагін записує Markdown, дружній до Obsidian, і за бажанням може використовувати офіційний `obsidian` CLI. +Коли `vault.renderMode` має значення `obsidian`, Plugin записує Markdown, +дружній до Obsidian, і за потреби може використовувати офіційний CLI `obsidian`. Підтримувані робочі процеси включають: @@ -321,19 +408,19 @@ openclaw wiki obsidian status - пошук по сховищу - відкриття сторінки - виклик команди Obsidian -- перехід до щоденної нотатки +- перехід до daily note -Це необов’язково. Wiki і надалі працює в режимі native без Obsidian. +Це необов’язково. Wiki і далі працює в режимі native без Obsidian. ## Рекомендований робочий процес -1. Залиште активний плагін пам’яті для пригадування/просування/dreaming. +1. Залиште свій Plugin active memory для recall/promotion/Dreaming. 2. Увімкніть `memory-wiki`. -3. Починайте з режиму `isolated`, якщо вам явно не потрібен режим bridge. -4. Використовуйте `wiki_search` / `wiki_get`, коли важливе походження. -5. Використовуйте `wiki_apply` для вузьких синтезів або оновлень метаданих. +3. Почніть із режиму `isolated`, якщо тільки вам явно не потрібен режим bridge. +4. Використовуйте `wiki_search` / `wiki_get`, коли provenance має значення. +5. Використовуйте `wiki_apply` для вузьких оновлень syntheses або metadata. 6. Запускайте `wiki_lint` після суттєвих змін. -7. Увімкніть панелі, якщо хочете бачити застарілість/суперечності. +7. Увімкніть dashboards, якщо хочете бачити застарілість/contradictions. ## Пов’язані документи