chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-29 19:22:18 +00:00
parent 0c5e8d81d2
commit 8032c58b7e
2 changed files with 271 additions and 164 deletions

View File

@ -2,38 +2,38 @@
read_when:
- Ви хочете використовувати CLI memory-wiki
- Ви документуєте або змінюєте `openclaw wiki`
summary: Довідник CLI для `openclaw wiki` (стан сховища memory-wiki, пошук, компіляція, лінтинг, застосування, bridge і допоміжні інструменти Obsidian)
summary: Довідник CLI для `openclaw wiki` (стан сховища memory-wiki, search, compile, lint, apply, bridge і допоміжні засоби Obsidian)
title: Вікі
x-i18n:
generated_at: "2026-04-28T11:08:03Z"
generated_at: "2026-04-29T19:21:07Z"
model: gpt-5.5
provider: openai
source_hash: f9d25a16125ac201ba5856acdb9eeda43725c30815507b17a96702a2ce3d6c91
source_hash: 67fe56c9bff7b24570f890733314857dd261fca8233051681a83c171656ff27d
source_path: cli/wiki.md
workflow: 16
---
# `openclaw wiki`
Перевіряйте й підтримуйте сховище `memory-wiki`.
Переглядайте та підтримуйте сховище `memory-wiki`.
Надається вбудованим Plugin `memory-wiki`.
Надається вбудованим plugin `memory-wiki`.
Пов’язане:
Пов’язано:
- [Plugin Memory Wiki](/uk/plugins/memory-wiki)
- [Огляд пам’яті](/uk/concepts/memory)
- [CLI: пам’ять](/uk/cli/memory)
## Для чого це
## Для чого це потрібно
Використовуйте `openclaw wiki`, коли вам потрібне скомпільоване сховище знань із:
Використовуйте `openclaw wiki`, коли потрібне скомпільоване сховище знань із:
- пошуком, нативним для wiki, і читанням сторінок
- синтезами з багатим походженням даних
- wiki-орієнтованим пошуком і читанням сторінок
- синтезами з багатою інформацією про походження
- звітами про суперечності та актуальність
- bridge-імпортами з Plugin активної пам’яті
- необов’язковими допоміжними засобами Obsidian CLI
- мостовими імпортами з active memory plugin
- необов’язковими помічниками Obsidian CLI
## Поширені команди
@ -45,6 +45,7 @@ openclaw wiki ingest ./notes/alpha.md
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki search "who should I ask about Teams?" --mode route-question
openclaw wiki get entity.alpha --from 1 --lines 80
openclaw wiki apply synthesis "Alpha Summary" \
@ -70,51 +71,45 @@ openclaw wiki obsidian daily
### `wiki status`
Перевіряє поточний режим сховища, стан справності та доступність Obsidian CLI.
Перевіряє поточний режим сховища, стан працездатності та доступність Obsidian CLI.
Використовуйте це спочатку, коли не впевнені, чи ініціалізовано сховище, чи
справний bridge-режим, або чи доступна інтеграція з Obsidian.
Спершу використовуйте це, якщо не впевнені, чи ініціалізовано сховище, чи справний bridge mode, або чи доступна інтеграція з Obsidian.
Коли bridge-режим активний і налаштований на читання артефактів пам’яті, ця команда
запитує запущений Gateway, тож бачить той самий контекст Plugin активної пам’яті, що й
пам’ять агента/середовища виконання.
Коли bridge mode активний і налаштований на читання артефактів пам’яті, ця команда опитує запущений Gateway, тому бачить той самий контекст active memory plugin, що й пам’ять агента/середовища виконання.
### `wiki doctor`
Запускає перевірки справності wiki й показує проблеми конфігурації або сховища.
Запускає перевірки стану wiki та показує проблеми конфігурації або сховища.
Коли bridge-режим активний і налаштований на читання артефактів пам’яті, ця команда
запитує запущений Gateway перед побудовою звіту. Вимкнені bridge-імпорти
та bridge-конфігурації, що не читають артефакти пам’яті, залишаються локальними/офлайн.
Коли bridge mode активний і налаштований на читання артефактів пам’яті, ця команда опитує запущений Gateway перед побудовою звіту. Вимкнені bridge-імпорти та bridge-конфігурації, що не читають артефакти пам’яті, залишаються локальними/офлайн.
Типові проблеми:
- bridge-режим увімкнено без публічних артефактів пам’яті
- bridge mode увімкнено без публічних артефактів пам’яті
- недійсна або відсутня структура сховища
- відсутній зовнішній Obsidian CLI, коли очікується режим Obsidian
### `wiki init`
Створює структуру сховища wiki та стартові сторінки.
Створює структуру wiki-сховища та початкові сторінки.
Це ініціалізує кореневу структуру, включно з індексами верхнього рівня та каталогами
кешу.
Це ініціалізує кореневу структуру, зокрема індекси верхнього рівня та каталоги кешу.
### `wiki ingest <path-or-url>`
Імпортує вміст у вихідний шар wiki.
Імпортує вміст у джерельний шар wiki.
Примітки:
- імпорт URL контролюється `ingest.allowUrlIngest`
- імпортовані вихідні сторінки зберігають походження у frontmatter
- авто-компіляція може запускатися після імпорту, коли її ввімкнено
- імпорт URL керується `ingest.allowUrlIngest`
- імпортовані сторінки джерел зберігають походження у frontmatter
- автоматична компіляція може запускатися після імпорту, якщо її ввімкнено
### `wiki compile`
Перебудовує індекси, пов’язані блоки, панелі та скомпільовані дайджести.
Перебудовує індекси, пов’язані блоки, дашборди та скомпільовані дайджести.
Це записує стабільні машинно-орієнтовані артефакти до:
Це записує стабільні машинно-орієнтовані артефакти в:
- `.openclaw-wiki/cache/agent-digest.json`
- `.openclaw-wiki/cache/claims.jsonl`
@ -123,7 +118,7 @@ openclaw wiki obsidian daily
### `wiki lint`
Перевіряє сховище й звітує про:
Перевіряє сховище та звітує про:
- структурні проблеми
- прогалини в походженні
@ -132,7 +127,7 @@ openclaw wiki obsidian daily
- сторінки/твердження з низькою впевненістю
- застарілі сторінки/твердження
Запускайте це після змістовних оновлень wiki.
Запускайте це після значущих оновлень wiki.
### `wiki search <query>`
@ -142,14 +137,32 @@ openclaw wiki obsidian daily
- `search.backend`: `shared` або `local`
- `search.corpus`: `wiki`, `memory` або `all`
- `--mode`: `auto`, `find-person`, `route-question`, `source-evidence` або
`raw-claim`
Використовуйте `wiki search`, коли потрібне специфічне для wiki ранжування або деталі походження.
Для одного широкого проходу спільного пригадування віддавайте перевагу `openclaw memory search`, коли
Plugin активної пам’яті надає спільний пошук.
Використовуйте `wiki search`, коли потрібне специфічне для wiki ранжування або подробиці походження. Для одного широкого спільного проходу пригадування надавайте перевагу `openclaw memory search`, коли active memory plugin надає спільний пошук.
Режими пошуку допомагають агенту вибрати правильну поверхню:
- `find-person`: псевдоніми, handles, соцмережі, канонічні ID та сторінки людей
- `route-question`: підказки, кого запитати/для чого найкраще використовувати, і контекст зв’язків
- `source-evidence`: сторінки джерел і структуровані поля доказів
- `raw-claim`: структурований текст твердження з метаданими твердження/доказів
Приклади:
```bash
openclaw wiki search "bgroux" --mode find-person
openclaw wiki search "who knows Teams rollout?" --mode route-question
openclaw wiki search "maintainer-whois" --mode source-evidence
openclaw wiki search "strong route Teams" --mode raw-claim --json
```
Текстовий вивід містить рядки `Claim:` і `Evidence:`, коли результат відповідає структурованому твердженню. JSON-вивід додатково надає `matchedClaimId`, `matchedClaimStatus`, `matchedClaimConfidence`, `evidenceKinds` і `evidenceSourceIds` для деталізації на боці агента.
### `wiki get <lookup>`
Читає сторінку wiki за id або відносним шляхом.
Читає wiki-сторінку за id або відносним шляхом.
Приклади:
@ -160,33 +173,27 @@ openclaw wiki get syntheses/alpha-summary.md --from 1 --lines 80
### `wiki apply`
Застосовує вузькі мутації без довільного хірургічного редагування сторінок.
Застосовує вузькі мутації без довільного редагування сторінок.
Підтримувані сценарії охоплюють:
Підтримувані сценарії:
- створення/оновлення сторінки синтезу
- оновлення метаданих сторінки
- прикріплення source ids
- прикріплення ID джерел
- додавання питань
- додавання суперечностей
- оновлення впевненості/статусу
- запис структурованих тверджень
Ця команда існує, щоб wiki могла безпечно розвиватися без ручного редагування
керованих блоків.
Ця команда існує, щоб wiki могла безпечно розвиватися без ручного редагування керованих блоків.
### `wiki bridge import`
Імпортує публічні артефакти пам’яті з Plugin активної пам’яті у вихідні сторінки,
підтримувані bridge.
Імпортує публічні артефакти пам’яті з active memory plugin у source pages, підтримувані bridge.
Використовуйте це в режимі `bridge`, коли хочете підтягнути до сховища wiki найновіші
експортовані артефакти пам’яті.
Використовуйте це в режимі `bridge`, коли потрібно втягнути до wiki-сховища найновіші експортовані артефакти пам’яті.
Для активного читання bridge-артефактів CLI маршрутизує імпорт через Gateway RPC,
щоб імпорт використовував контекст Plugin пам’яті середовища виконання. Якщо bridge-імпорти
вимкнено або читання артефактів вимкнено, команда зберігає локальну/офлайн
поведінку нульового імпорту.
Для активного читання bridge-артефактів CLI маршрутизує імпорт через Gateway RPC, щоб імпорт використовував контекст memory plugin середовища виконання. Якщо bridge-імпорти вимкнено або читання артефактів вимкнено, команда зберігає локальну/офлайн поведінку нульового імпорту.
### `wiki unsafe-local import`
@ -206,21 +213,19 @@ openclaw wiki get syntheses/alpha-summary.md --from 1 --lines 80
- `command`
- `daily`
Вони потребують офіційного CLI `obsidian` у `PATH`, коли
`obsidian.useOfficialCli` увімкнено.
Вони потребують офіційного CLI `obsidian` у `PATH`, коли ввімкнено `obsidian.useOfficialCli`.
## Практичні поради з використання
- Використовуйте `wiki search` + `wiki get`, коли походження та ідентичність сторінки важливі.
- Використовуйте `wiki apply` замість ручного редагування керованих згенерованих розділів.
- Використовуйте `wiki search` + `wiki get`, коли важливі походження та ідентичність сторінки.
- Використовуйте `wiki apply` замість ручного редагування керованих згенерованих секцій.
- Використовуйте `wiki lint`, перш ніж довіряти суперечливому вмісту або вмісту з низькою впевненістю.
- Використовуйте `wiki compile` після масових імпортів або змін джерел, коли хочете негайно отримати свіжі
панелі та скомпільовані дайджести.
- Використовуйте `wiki bridge import`, коли bridge-режим залежить від щойно експортованих артефактів пам’яті.
- Використовуйте `wiki compile` після масових імпортів або змін джерел, коли потрібні свіжі дашборди та скомпільовані дайджести негайно.
- Використовуйте `wiki bridge import`, коли bridge mode залежить від щойно експортованих артефактів пам’яті.
## Прив’язки до конфігурації
## Зв’язки з конфігурацією
Поведінку `openclaw wiki` формують:
Поведінка `openclaw wiki` формується такими параметрами:
- `plugins.entries.memory-wiki.config.vaultMode`
- `plugins.entries.memory-wiki.config.search.backend`
@ -232,7 +237,7 @@ openclaw wiki get syntheses/alpha-summary.md --from 1 --lines 80
Див. [Plugin Memory Wiki](/uk/plugins/memory-wiki) для повної моделі конфігурації.
## Пов’язане
## Пов’язано
- [Довідник CLI](/uk/cli)
- [Memory wiki](/uk/plugins/memory-wiki)

View File

@ -1,82 +1,82 @@
---
read_when:
- Вам потрібні постійні знання, що виходять за межі простих нотаток MEMORY.md
- Вам потрібні сталі знання, ширші за звичайні нотатки MEMORY.md
- Ви налаштовуєте вбудований Plugin memory-wiki
- Ви хочете зрозуміти wiki_search, wiki_get або режим мосту
summary: 'memory-wiki: скомпільоване сховище знань із даними про походження, твердженнями, інформаційними панелями та режимом мосту'
summary: 'memory-wiki: скомпільоване сховище знань із походженням, твердженнями, панелями моніторингу та режимом моста'
title: Вікі пам’яті
x-i18n:
generated_at: "2026-04-28T11:19:30Z"
generated_at: "2026-04-29T19:21:15Z"
model: gpt-5.5
provider: openai
source_hash: 76e783930fbe1bbeeac309dda5a3075cab0e062338cf084a2a493e0afe7e0d87
source_hash: 744d569f8b0c9b668ea54dc057f808544359eaae87d5557de2e6acd1b31acd89
source_path: plugins/memory-wiki.md
workflow: 16
---
`memory-wiki` — це bundled Plugin, який перетворює довготривалу пам’ять на скомпільоване
`memory-wiki` — це вбудований Plugin, який перетворює довготривалу пам’ять на скомпільоване
сховище знань.
Він **не** замінює Plugin Active Memory. Plugin Active Memory і далі
відповідає за recall, promotion, indexing і Dreaming. `memory-wiki` працює поруч із ним
відповідає за пригадування, просування, індексування та Dreaming. `memory-wiki` працює поруч із ним
і компілює довготривалі знання в навігаційну вікі з детермінованими сторінками,
структурованими твердженнями, походженням, дашбордами та машинозчитуваними дайджестами.
структурованими твердженнями, походженням, панелями моніторингу та машинозчитуваними дайджестами.
Використовуйте його, коли хочете, щоб пам’ять поводилася радше як підтримуваний шар знань, а
не як купа Markdown-файлів.
## Що він додає
- Окреме сховище вікі з детермінованою структурою сторінок
- Структуровані метадані тверджень і доказів, а не лише текст
- Походження, упевненість, суперечності та відкриті питання на рівні сторінок
- Скомпільовані дайджести для агентів і споживачів runtime
- Вікі-рідні інструменти пошуку/get/apply/lint
- Окреме вікі-сховище з детермінованим макетом сторінок
- Метадані структурованих тверджень і доказів, а не лише прозу
- Походження, впевненість, суперечності та відкриті питання на рівні сторінки
- Скомпільовані дайджести для споживачів агентів/середовища виконання
- Вікі-нативні інструменти search/get/apply/lint
- Необов’язковий режим bridge, який імпортує публічні артефакти з Plugin Active Memory
- Необов’язковий режим render, зручний для Obsidian, та інтеграція з CLI
- Необов’язковий режим рендерингу, дружній до Obsidian, та інтеграція з CLI
## Як він поєднується з пам’яттю
Поділ можна уявити так:
Уявляйте цей поділ так:
| Шар | Відповідає за |
| Шар | Відповідає за |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Plugin Active Memory (`memory-core`, QMD, Honcho тощо) | Recall, семантичний пошук, promotion, Dreaming, runtime пам’яті |
| `memory-wiki` | Скомпільовані вікі-сторінки, синтези з багатим походженням, дашборди, специфічні для вікі search/get/apply |
| Plugin Active Memory (`memory-core`, QMD, Honcho тощо) | Пригадування, семантичний пошук, просування, Dreaming, середовище виконання пам’яті |
| `memory-wiki` | Скомпільовані вікі-сторінки, синтези з багатим походженням, панелі, вікі-специфічні search/get/apply |
Якщо Plugin Active Memory надає спільні артефакти recall, OpenClaw може шукати
Якщо Plugin Active Memory відкриває спільні артефакти пригадування, OpenClaw може шукати
в обох шарах за один прохід за допомогою `memory_search corpus=all`.
Коли вам потрібне специфічне для вікі ранжування, походження або прямий доступ до сторінок, використовуйте
натомість вікі-рідні інструменти.
Коли потрібне вікі-специфічне ранжування, походження або прямий доступ до сторінок, використовуйте
натомість вікі-нативні інструменти.
## Рекомендований гібридний патерн
## Рекомендований гібридний шаблон
Надійний стандартний варіант для local-first налаштувань:
Надійний типовий варіант для локальних setup-first конфігурацій:
- QMD як бекенд Active Memory для recall і широкого семантичного пошуку
- QMD як backend Active Memory для пригадування та широкого семантичного пошуку
- `memory-wiki` у режимі `bridge` для довготривалих синтезованих сторінок знань
Такий поділ добре працює, бо кожен шар залишається сфокусованим:
Такий поділ добре працює, бо кожен шар зберігає чіткий фокус:
- QMD зберігає сирі нотатки, експорти сесій і додаткові колекції доступними для пошуку
- `memory-wiki` компілює стабільні сутності, твердження, дашборди та сторінки джерел
- QMD зберігає необроблені нотатки, експорти сесій і додаткові колекції доступними для пошуку
- `memory-wiki` компілює стабільні сутності, твердження, панелі та сторінки джерел
Практичне правило:
- використовуйте `memory_search`, коли потрібен один широкий прохід recall по пам’яті
- використовуйте `memory_search`, коли потрібен один широкий прохід пригадування по пам’яті
- використовуйте `wiki_search` і `wiki_get`, коли потрібні вікі-результати з урахуванням походження
- використовуйте `memory_search corpus=all`, коли хочете, щоб спільний пошук охоплював обидва шари
Якщо режим bridge повідомляє про нуль експортованих артефактів, Plugin Active Memory наразі
ще не надає публічні bridge-входи. Спершу запустіть `openclaw wiki doctor`,
Якщо режим bridge повідомляє про нуль експортованих артефактів, Plugin Active Memory
поки що не відкриває публічні вхідні дані bridge. Спершу запустіть `openclaw wiki doctor`,
а потім підтвердьте, що Plugin Active Memory підтримує публічні артефакти.
Коли режим bridge активний і `bridge.readMemoryArtifacts` увімкнено,
`openclaw wiki status`, `openclaw wiki doctor` та `openclaw wiki bridge
`openclaw wiki status`, `openclaw wiki doctor` і `openclaw wiki bridge
import` читають через запущений Gateway. Це узгоджує CLI-перевірки bridge
з контекстом runtime Plugin пам’яті. Якщо bridge вимкнено або читання артефактів
вимкнено, ці команди зберігають свою локальну/offline поведінку.
з контекстом Plugin пам’яті в середовищі виконання. Якщо bridge вимкнено або читання артефактів
вимкнене, ці команди зберігають свою локальну/offline поведінку.
## Режими сховища
@ -86,33 +86,33 @@ import` читають через запущений Gateway. Це узгодж
Власне сховище, власні джерела, без залежності від `memory-core`.
Використовуйте це, коли хочете, щоб вікі була власним curated сховищем знань.
Використовуйте це, коли хочете, щоб вікі була окремим кураторованим сховищем знань.
### `bridge`
Читає публічні артефакти пам’яті та події пам’яті з Plugin Active Memory
через публічні шви plugin SDK.
Використовуйте це, коли хочете, щоб вікі компілювала та впорядковувала
Використовуйте це, коли хочете, щоб вікі компілювала й упорядковувала
експортовані артефакти Plugin пам’яті, не звертаючись до приватних внутрішніх частин Plugin.
Режим bridge може індексувати:
- експортовані артефакти пам’яті
- звіти Dreaming
- звіти dream
- щоденні нотатки
- кореневі файли пам’яті
- журнали подій пам’яті
### `unsafe-local`
Явний аварійний вихід для приватних локальних шляхів на тій самій машині.
Явний escape hatch для приватних локальних шляхів на тій самій машині.
Цей режим навмисно експериментальний і непереносний. Використовуйте його лише тоді, коли
розумієте межу довіри й вам справді потрібен доступ до локальної файлової системи, який
режим bridge не може надати.
Цей режим навмисно експериментальний і непортативний. Використовуйте його лише тоді, коли
розумієте межу довіри та конкретно потребуєте доступу до локальної файлової системи, якого
режим bridge надати не може.
## Структура сховища
## Макет сховища
Plugin ініціалізує сховище так:
@ -132,15 +132,15 @@ Plugin ініціалізує сховище так:
.openclaw-wiki/
```
Керований вміст залишається всередині згенерованих блоків. Людські блоки нотаток зберігаються.
Керований вміст залишається всередині згенерованих блоків. Блоки людських нотаток зберігаються.
Основні групи сторінок:
- `sources/` для імпортованого сирого матеріалу та сторінок, підтриманих bridge
- `sources/` для імпортованих необроблених матеріалів і сторінок, підтриманих bridge
- `entities/` для довготривалих речей, людей, систем, проєктів і об’єктів
- `concepts/` для ідей, абстракцій, патернів і політик
- `concepts/` для ідей, абстракцій, шаблонів і політик
- `syntheses/` для скомпільованих підсумків і підтримуваних зведень
- `reports/` для згенерованих дашбордів
- `reports/` для згенерованих панелей
## Структуровані твердження та докази
@ -157,36 +157,110 @@ Plugin ініціалізує сховище так:
Записи доказів можуть містити:
- `kind`
- `sourceId`
- `path`
- `lines`
- `weight`
- `confidence`
- `privacyTier`
- `note`
- `updatedAt`
Саме це робить вікі радше шаром переконань, ніж пасивним
смітником нотаток. Твердження можна відстежувати, оцінювати, оскаржувати й повертати до джерел.
dump нотаток. Твердження можна відстежувати, оцінювати, оскаржувати та пов’язувати назад із джерелами.
## Пайплайн компіляції
## Метадані сутностей для агентів
Крок компіляції читає вікі-сторінки, нормалізує підсумки та випускає стабільні
Сторінки сутностей також можуть містити маршрутні метадані для використання агентами. Це generic
frontmatter, тому він працює для людей, команд, систем, проєктів або будь-якого іншого
типу сутності.
Поширені поля:
- `entityType`: наприклад `person`, `team`, `system` або `project`
- `canonicalId`: стабільний ключ ідентичності, що використовується між aliases та імпортами
- `aliases`: імена, handles або labels, які мають резолвитися в ту саму сторінку
- `privacyTier`: `public`, `local-private`, `sensitive` або `confirm-before-use`
- `bestUsedFor` / `notEnoughFor`: компактні підказки маршрутизації
- `lastRefreshedAt`: позначка часу оновлення джерела, окрема від часу редагування сторінки
- `personCard`: необов’язкова маршрутна картка, специфічна для людини, з handles, socials,
emails, timezone, lane, ask-for, avoid-asking-for, confidence і privacy
- `relationships`: типізовані ребра до пов’язаних сторінок із target, kind, weight,
confidence, evidence kind, privacy tier і note
Для вікі людей агент зазвичай має починати з
`reports/person-agent-directory.md`, потім відкривати сторінку людини через `wiki_get`,
перш ніж використовувати контактні дані або виведені факти.
Приклад:
```yaml
pageType: entity
entityType: person
id: entity.brad-groux
canonicalId: maintainer.brad-groux
aliases:
- Brad
- bgroux
privacyTier: local-private
bestUsedFor:
- Microsoft Teams and Azure routing
notEnoughFor:
- legal approval
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
handles:
- "@bgroux"
socials:
- "https://x.example/bgroux"
emails:
- brad@example.com
timezone: America/Chicago
lane: Microsoft ecosystem
askFor:
- Teams rollout questions
avoidAskingFor:
- unrelated billing decisions
confidence: 0.8
privacyTier: confirm-before-use
relationships:
- targetId: entity.alice
targetTitle: Alice
kind: collaborates-with
confidence: 0.7
evidenceKind: discrawl-stat
claims:
- id: claim.brad.teams
text: Brad is useful for Microsoft Teams routing.
status: supported
confidence: 0.9
evidence:
- kind: maintainer-whois
sourceId: source.maintainers
privacyTier: local-private
```
## Конвеєр компіляції
Крок компіляції читає вікі-сторінки, нормалізує підсумки та видає стабільні
машинні артефакти в:
- `.openclaw-wiki/cache/agent-digest.json`
- `.openclaw-wiki/cache/claims.jsonl`
Ці дайджести існують, щоб агентам і runtime-коду не доводилося скрейпити Markdown-сторінки.
Ці дайджести існують, щоб агентам і runtime-коду не потрібно було scrape Markdown-сторінки.
Скомпільований вихід також забезпечує:
Скомпільований вивід також забезпечує:
- первинне вікі-індексування для потоків search/get
- пошук за claim-id назад до сторінок-власників
- компактні доповнення prompt
- генерацію звітів/дашбордів
- lookup claim-id назад до сторінок-власників
- компактні доповнення до prompt
- генерацію звітів/панелей
## Дашборди та звіти про стан
## Панелі та звіти про стан
Коли `render.createDashboards` увімкнено, compile підтримує дашборди в
Коли `render.createDashboards` увімкнено, compile підтримує панелі в
`reports/`.
Вбудовані звіти містять:
@ -196,24 +270,32 @@ Plugin ініціалізує сховище так:
- `reports/low-confidence.md`
- `reports/claim-health.md`
- `reports/stale-pages.md`
- `reports/person-agent-directory.md`
- `reports/relationship-graph.md`
- `reports/provenance-coverage.md`
- `reports/privacy-review.md`
Ці звіти відстежують такі речі, як:
- кластери нотаток із суперечностями
- кластери конкуруючих тверджень
- кластери нотаток про суперечності
- конкуруючі кластери тверджень
- твердження без структурованих доказів
- сторінки та твердження з низькою впевненістю
- застарілість або невідома актуальність
- сторінки й твердження з низькою впевненістю
- застарілу або невідому актуальність
- сторінки з нерозв’язаними питаннями
- маршрутні картки людей/сутностей
- структуровані ребра взаємозв’язків
- покриття класів доказів
- непублічні privacy tiers, які потребують перевірки перед використанням
## Пошук і отримання
`memory-wiki` підтримує два бекенди пошуку:
`memory-wiki` підтримує два backend пошуку:
- `shared`: використовувати спільний потік пошуку пам’яті, коли він доступний
- `shared`: використовувати спільний потік пошуку пам’яті, коли доступно
- `local`: шукати у вікі локально
Він також підтримує три корпуси:
Він також підтримує три corpora:
- `wiki`
- `memory`
@ -222,17 +304,35 @@ Plugin ініціалізує сховище так:
Важлива поведінка:
- `wiki_search` і `wiki_get` за можливості використовують скомпільовані дайджести як перший прохід
- id тверджень можуть переходити назад до сторінки-власника
- спірні/застарілі/свіжі твердження впливають на ранжування
- мітки походження можуть зберігатися в результатах
- claim ids можуть резолвитися назад до сторінки-власника
- contested/stale/fresh claims впливають на ранжування
- labels походження можуть зберігатися в результатах
- режим пошуку може зміщувати ранжування для пошуку людей, маршрутизації питань, source
evidence або raw claims
Практичне правило:
- використовуйте `memory_search corpus=all` для одного широкого проходу recall
- використовуйте `wiki_search` + `wiki_get`, коли для вас важливі специфічне для вікі ранжування,
- використовуйте `memory_search corpus=all` для одного широкого проходу пригадування
- використовуйте `wiki_search` + `wiki_get`, коли вам важливі вікі-специфічне ранжування,
походження або структура переконань на рівні сторінки
## Інструменти агента
Режими пошуку:
- `auto`: збалансоване типове значення
- `find-person`: підсилює person-like entities, aliases, handles, socials і
canonical IDs
- `route-question`: підсилює картки агентів, ask-for hints, best-used-for hints і
контекст взаємозв’язків
- `source-evidence`: підсилює сторінки джерел і метадані структурованих доказів
- `raw-claim`: підсилює відповідні структуровані твердження та повертає claim/evidence
metadata в результатах
Коли результат відповідає структурованому твердженню, `wiki_search` може повертати
`matchedClaimId`, `matchedClaimStatus`, `matchedClaimConfidence`,
`evidenceKinds` і `evidenceSourceIds` у своєму details payload. Текстовий вивід
також містить компактні рядки `Claim:` і `Evidence:`, коли доступно.
## Інструменти для агентів
Plugin реєструє ці інструменти:
@ -245,34 +345,36 @@ Plugin реєструє ці інструменти:
Що вони роблять:
- `wiki_status`: поточний режим сховища, стан, доступність Obsidian CLI
- `wiki_search`: пошук вікі-сторінок і, якщо налаштовано, спільних корпусів пам’яті
- `wiki_get`: читання вікі-сторінки за id/path або fallback до спільного корпусу пам’яті
- `wiki_apply`: вузькі зміни синтезу/метаданих без довільної хірургії сторінок
- `wiki_search`: шукає вікі-сторінки та, коли налаштовано, спільні corpora пам’яті;
приймає `mode` для пошуку людей, маршрутизації питань, source evidence або raw
claim drilldown
- `wiki_get`: читає вікі-сторінку за id/path або повертається до спільного corpus пам’яті
- `wiki_apply`: вузькі мутації синтезу/метаданих без довільної хірургії сторінок
- `wiki_lint`: структурні перевірки, прогалини походження, суперечності, відкриті питання
Plugin також реєструє неексклюзивне доповнення корпусу пам’яті, тож спільні
`memory_search` і `memory_get` можуть діставатися вікі, коли Plugin Active Memory
підтримує вибір корпусу.
Plugin також реєструє неексклюзивне доповнення corpus пам’яті, щоб спільні
`memory_search` і `memory_get` могли досягати вікі, коли Plugin Active Memory
підтримує вибір corpus.
## Поведінка prompt і контексту
Коли `context.includeCompiledDigestPrompt` увімкнено, секції prompt пам’яті
додають компактний скомпільований знімок з `agent-digest.json`.
Коли `context.includeCompiledDigestPrompt` увімкнено, розділи prompt пам’яті
додають компактний скомпільований snapshot з `agent-digest.json`.
Цей знімок навмисно малий і з високою корисністю:
Цей snapshot навмисно малий і високосигнальний:
- лише найважливіші сторінки
- лише найважливіші твердження
- лише top pages
- лише top claims
- кількість суперечностей
- кількість питань
- кваліфікатори впевненості/свіжості
- qualifiers впевненості/актуальності
Це opt-in, бо воно змінює форму prompt і переважно корисне для рушіїв контексту
або legacy-складання prompt, які явно споживають доповнення пам’яті.
Це opt-in, бо змінює форму prompt і переважно корисне для context
engines або legacy prompt assembly, які явно споживають доповнення пам’яті.
## Конфігурація
Розмістіть конфігурацію в `plugins.entries.memory-wiki.config`:
Розмістіть config у `plugins.entries.memory-wiki.config`:
```json5
{
@ -328,17 +430,17 @@ Plugin також реєструє неексклюзивне доповненн
- `vaultMode`: `isolated`, `bridge`, `unsafe-local`
- `vault.renderMode`: `native` або `obsidian`
- `bridge.readMemoryArtifacts`: імпортувати публічні артефакти Plugin Active Memory
- `bridge.readMemoryArtifacts`: імпортувати публічні артефакти Plugin активної пам’яті
- `bridge.followMemoryEvents`: включати журнали подій у режимі bridge
- `search.backend`: `shared` або `local`
- `search.corpus`: `wiki`, `memory` або `all`
- `context.includeCompiledDigestPrompt`: додавати компактний знімок дайджесту до секцій prompt пам’яті
- `context.includeCompiledDigestPrompt`: додавати компактний знімок дайджесту до розділів підказки пам’яті
- `render.createBacklinks`: генерувати детерміновані пов’язані блоки
- `render.createDashboards`: генерувати сторінки дашбордів
- `render.createDashboards`: генерувати сторінки панелей огляду
### Приклад: режим QMD + bridge
### Приклад: QMD + режим bridge
Використовуйте це, коли хочете QMD для recall і `memory-wiki` для підтримуваного
Використовуйте це, коли вам потрібен QMD для пригадування та `memory-wiki` для підтримуваного
шару знань:
```json5
@ -373,13 +475,13 @@ Plugin також реєструє неексклюзивне доповненн
Це зберігає:
- QMD відповідальним за recall Active Memory
- `memory-wiki` сфокусованим на скомпільованих сторінках і дашбордах
- форму prompt незмінною, доки ви навмисно не ввімкнете скомпільовані digest prompts
- QMD відповідальним за пригадування активної пам’яті
- `memory-wiki` зосередженим на скомпільованих сторінках і панелях огляду
- форму підказки незмінною, доки ви навмисно не ввімкнете підказки скомпільованого дайджесту
## CLI
`memory-wiki` також надає верхньорівневу CLI-поверхню:
`memory-wiki` також надає поверхню CLI верхнього рівня:
```bash
openclaw wiki status
@ -395,34 +497,34 @@ openclaw wiki bridge import
openclaw wiki obsidian status
```
Див. [CLI: wiki](/uk/cli/wiki) для повного довідника команд.
Див. [CLI: wiki](/uk/cli/wiki), щоб отримати повний довідник команд.
## Підтримка Obsidian
Коли `vault.renderMode` дорівнює `obsidian`, Plugin записує Markdown,
зручний для Obsidian, і може необов’язково використовувати офіційний CLI `obsidian`.
Коли `vault.renderMode` дорівнює `obsidian`, Plugin записує дружній до Obsidian
Markdown і може додатково використовувати офіційний CLI `obsidian`.
Підтримувані робочі процеси:
Підтримувані робочі процеси включають:
- перевірка стану
- перевірку статусу
- пошук у сховищі
- відкриття сторінки
- виклик команди Obsidian
- перехід до щоденної нотатки
Це необов’язково. Вікі й далі працює в native-режимі без Obsidian.
Це необов’язково. Вікі й далі працює в режимі native без Obsidian.
## Рекомендований робочий процес
1. Залиште свій Plugin Active Memory для recall/promotion/Dreaming.
1. Залиште ваш Plugin активної пам’яті для пригадування/просування/Dreaming.
2. Увімкніть `memory-wiki`.
3. Почніть з режиму `isolated`, якщо вам явно не потрібен режим bridge.
4. Використовуйте `wiki_search` / `wiki_get`, коли походження має значення.
3. Почніть із режиму `isolated`, якщо вам явно не потрібен режим bridge.
4. Використовуйте `wiki_search` / `wiki_get`, коли важливе походження.
5. Використовуйте `wiki_apply` для вузьких синтезів або оновлень метаданих.
6. Запускайте `wiki_lint` після змістовних змін.
7. Увімкніть дашборди, якщо хочете бачити застарілість/суперечності.
6. Запускайте `wiki_lint` після суттєвих змін.
7. Увімкніть панелі огляду, якщо вам потрібна видимість застарілого або суперечностей.
## Пов’язані документи
## Пов’язана документація
- [Огляд пам’яті](/uk/concepts/memory)
- [CLI: memory](/uk/cli/memory)