chore(i18n): refresh uk translations
This commit is contained in:
parent
0c5e8d81d2
commit
8032c58b7e
@ -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)
|
||||
|
||||
@ -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)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user