NotariumДокументация
Версия документации: latest
RU

Глоссарий

Короткие определения ключевых терминов Notarium. Каждый термин ведёт на страницу, где он раскрыт подробнее.

Хранение и идентичность

file-first — принцип, по которому источник истины — сами Markdown-файлы на диске. Поисковый индекс, граф связей и всё производное восстановимы из файлов; забрать папку и уйти можно в любой момент. Подробнее — File-first.

пространство (space) — изолированная база знаний со своим индексом, графом, поиском, деревом, журналом ревизий и составом участников. У каждого пользователя есть неудаляемое личное пространство (на агентских страницах его называют личным доменом). Подробнее — Пространства и проекты.

проект — лёгкая опциональная сущность: помеченная папка со стабильной идентичностью внутри пространства (метка — dot-файл в корне папки). Адресуется агентом хэндлом space/slug. Подробнее — Пространства и проекты.

notarium-id — стабильный 12-символьный идентификатор заметки во frontmatter. Переживает перемещение и переименование файла, поэтому связи и история не рвутся. Подробнее — История версий.

класс заметки — набор политик видимости и индексации, выводимый из места хранения (не свободное поле): user-doc (пользовательская, видна везде), agent-memory (память агента, индексируется и доступна recall, но скрыта из пользовательских поверхностей), плюс служебные attachment, derived и profile. Подробнее — Типы заметок.

Доступ и агенты

принципал (principal) — обобщённый субъект доступа: человек или ИИ-агент. Один механизм грантов на все. Подробнее — Модель доступа.

роли — членство в пространстве: reader (читает всё), writer (правит заметки), owner (управляет членством). Подробнее — Модель доступа.

PAT (Personal Access Token) — персональный токен доступа для агентов, передаётся заголовком Authorization: Bearer …. Имеет scope (read/write), опциональное сужение по пространствам и срок. Секрет показывается ровно один раз. Подробнее — Подключение агента.

MCP-гейтвей — встроенный эндпоинт POST /mcp, через который ИИ-агент читает и пишет базу знаний инструментами, ориентированными на намерение (а не универсальными CRUD-операциями). Правки агента версионируются, ограничиваются доступами и подписываются провенансом. Подробнее — Агенты и MCP.

интент-инструмент — инструмент MCP-гейтвея, выражающий намерение («найди», «создай заметку»), а не низкоуровневую CRUD-операцию по хранилищу. Подробнее — Интент-инструменты.

Поиск

гибридный поиск — слияние трёх каналов: лексики (полнотекстовый FTS/BM25, работает всегда), семантики (векторы, включается флагом) и опционального граф-буста. Результаты объединяются алгоритмом RRF. Подробнее — Поиск.

RRF (Reciprocal Rank Fusion) — алгоритм взвешенного слияния ранжированных списков (лексика + семантика + граф) в единую выдачу без общей шкалы очков. Подробнее — Поиск.

деградация — откат возможности на более простой вариант, когда её зависимостей нет: если векторный стек выключен или недоступен, поиск продолжает работать по полному тексту (FTS) — без ошибки и с тем же результатом. Подробнее — Настройка поиска.

Версии и провенанс

журнал (ревизий) — история версий заметок в служебной БД (не git). Ревизия — полный снапшот состояния; идентичные состояния дедуплицируются по содержимому. Ключ журнала — notarium-id, поэтому история переживает перемещение и переименование. Подробнее — История версий.

провенанс (provenance) — атрибуция каждой ревизии: кто и как внёс правку — конкретный человек, конкретный ИИ-агент или внешний редактор файла. Подробнее — История версий.

Развёртывание

self-host — модель развёртывания Notarium: один самодостаточный контейнер (Node/Fastify, движок в процессе, без внешних сервисов). Приватность обеспечивается владением сервером и файлами, а не сквозным шифрованием. Подробнее — Self-host.

Смотрите также