NotariumҚұжаттама
Құжаттама нұсқасы: latest
KZ

Глоссарий

Notarium-ның негізгі терминдерінің қысқаша анықтамалары. Әрбір термин ол толығырақ ашылатын бетке сілтейді.

Сақтау және бірегейлік

file-first — ақиқат көзі дискідегі Markdown-файлдардың өзі болатын принцип. Іздеу индексі, байланыстар графы және барлық туынды нәрсе файлдардан қайта құрылады; қалтаны алып, кез келген сәтте кетуге болады. Толығырақ — File-first.

кеңістік (space) — өз индексі, графы, іздеуі, ағашы, ревизиялар журналы және қатысушылар құрамы бар оқшауланған білім қоры. Әр пайдаланушыда жойылмайтын жеке кеңістік болады (агенттік беттерде оны жеке домен деп атайды). Толығырақ — Кеңістіктер мен жобалар.

жоба — жеңіл әрі міндетті емес нысан: кеңістік ішінде тұрақты бірегейлігі бар белгіленген қалта (белгі — қалта түбіріндегі dot-файл). Агент оны space/slug хэндлі арқылы адрестейді. Толығырақ — Кеңістіктер мен жобалар.

notarium-id — frontmatter-дегі жазбаның тұрақты 12 таңбалы идентификаторы. Файлды жылжытқанда және қайта атағанда да сақталады, сондықтан байланыстар мен тарих үзілмейді. Толығырақ — Нұсқалар тарихы.

жазба класы — сақталу орнынан шығарылатын көріну мен индекстеу саясаттарының жиынтығы (еркін өріс емес): user-doc (пайдаланушылық, барлық жерде көрінеді), agent-memory (агент жады, индекстеледі және recall арқылы қолжетімді, бірақ пайдаланушылық беттерден жасырылған), сондай-ақ қызметтік attachment, derived және profile. Толығырақ — Жазба түрлері.

Қол жеткізу және агенттер

субъект (principal) — жалпыланған қол жеткізу субъектісі: адам немесе ЖИ-агент. Барлығына бір ғана рұқсат беру механизмі. Толығырақ — Қол жеткізу моделі.

рөлдер — кеңістіктегі мүшелік: reader (бәрін оқиды), writer (жазбаларды өңдейді), owner (мүшелікті басқарады). Толығырақ — Қол жеткізу моделі.

PAT (Personal Access Token) — агенттерге арналған жеке қол жеткізу токені, Authorization: Bearer … тақырыбымен беріледі. Оның ауқымы (read/write), кеңістіктер бойынша міндетті емес тарылтуы және жарамдылық мерзімі бар. Құпия дәл бір рет қана көрсетіледі. Толығырақ — Агентті қосу.

MCP шлюзі — ЖИ-агент білім қорын ниетке бағытталған құралдармен (әмбебап CRUD-операциялармен емес) оқитын және жазатын кірістірілген POST /mcp эндпоинті. Агенттің түзетулері нұсқаланады, қол жеткізулермен шектеледі және шығу тегімен қолтаңбаланады. Толығырақ — Агенттер және MCP.

ниет құралы — төмен деңгейлі қойма CRUD-операциясын емес, ниетті («тап», «жазба жаса») білдіретін MCP шлюзінің құралы. Толығырақ — Ниет құралдары.

Іздеу

гибридті іздеу — үш арнаның бірігуі: лексикалық (толық мәтіндік FTS/BM25, әрдайым қосулы), семантикалық (векторлар, жалаушамен қосылады) және міндетті емес граф күшейтуі. Нәтижелер RRF алгоритмімен біріктіріледі. Толығырақ — Іздеу.

RRF (Reciprocal Rank Fusion) — рейтингтелген тізімдерді (лексика + семантика + граф) ортақ ұпай шкаласынсыз біртұтас нәтижеге салмақтап біріктіретін алгоритм. Толығырақ — Іздеу.

деградация — тәуелділіктері болмаған кезде мүмкіндіктің қарапайымырақ нұсқаға шегінуі: векторлық стек өшірулі немесе қолжетімсіз болса, іздеу толық мәтін (FTS) бойынша жұмысын жалғастырады — қатесіз әрі сол нәтижемен. Толығырақ — Іздеуді баптау.

Нұсқалар мен шығу тегі

ревизиялар журналы — қызметтік дерекқордағы жазбалардың нұсқалар тарихы (git емес). Ревизия — күйдің толық лездік көшірмесі; бірдей күйлер мазмұны бойынша дедупликацияланады. Журналдың кілті — notarium-id, сондықтан тарих жылжытқанда және қайта атағанда да сақталады. Толығырақ — Нұсқалар тарихы.

шығу тегі (provenance) — әр ревизияның атрибуциясы: түзетуді кім және қалай енгізді — нақты адам, нақты ЖИ-агент немесе сыртқы файл редакторы. Толығырақ — Нұсқалар тарихы.

Орналастыру

self-host — Notarium-ның орналастыру моделі: бір өзіне-өзі жеткілікті контейнер (Node/Fastify, процесс ішіндегі қозғалтқыш, сыртқы сервистерсіз). Құпиялылық серверге және файлдарға иелік етумен қамтамасыз етіледі, ұштан-ұшқа шифрлаумен емес. Толығырақ — Self-host.

Сондай-ақ қараңыз