diff --git a/docs/uk/cli/wiki.md b/docs/uk/cli/wiki.md index 996d93d91..628c0e62c 100644 --- a/docs/uk/cli/wiki.md +++ b/docs/uk/cli/wiki.md @@ -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 ` -Імпортує вміст у вихідний шар 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 ` @@ -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 ` -Читає сторінку 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) diff --git a/docs/uk/plugins/memory-wiki.md b/docs/uk/plugins/memory-wiki.md index 7e8f414cc..9831faf7c 100644 --- a/docs/uk/plugins/memory-wiki.md +++ b/docs/uk/plugins/memory-wiki.md @@ -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)