---
title: "Глоссарий"
description: "Термины Notarium: пространство, проект, notarium-id, класс заметки, принципал, PAT, журнал, RRF и другие."
---

# Глоссарий

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

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

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

**пространство (space)** — изолированная база знаний со своим индексом, графом, поиском, деревом, журналом ревизий и составом участников. У каждого пользователя есть неудаляемое личное пространство (на агентских страницах его называют **личным доменом**). Подробнее — [Пространства и проекты](/docs/concepts/spaces-and-projects/).

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

**`notarium-id`** — стабильный 12-символьный идентификатор заметки во frontmatter. Переживает перемещение и переименование файла, поэтому связи и история не рвутся. Подробнее — [История версий](/docs/concepts/versioning/).

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

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

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

**роли** — членство в пространстве: `reader` (читает всё), `writer` (правит заметки), `owner` (управляет членством). Подробнее — [Модель доступа](/docs/concepts/access-model/).

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

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

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

## Поиск

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

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

**деградация** — откат возможности на более простой вариант, когда её зависимостей нет: если векторный стек выключен или недоступен, поиск продолжает работать по полному тексту (FTS) — без ошибки и с тем же результатом. Подробнее — [Настройка поиска](/docs/self-hosting/search-setup/).

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

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

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

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

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

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

- [Переменные окружения](/docs/reference/environment-variables/) — полная таблица конфигурации.
- [Справочник горячих клавиш](/docs/reference/keyboard-shortcuts/) — раскладки и пресеты.
- [Концепции](/docs/concepts/) — как устроен Notarium.