chore(i18n): refresh uk translations
This commit is contained in:
parent
ee11cf8f44
commit
c9a61c405a
@ -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
|
||||
<vault>/
|
||||
@ -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.
|
||||
|
||||
## Пов’язані документи
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user