NotariumDokumentation
Dokumentationsversion: latest
DE

Glossar

Kurze Definitionen der wichtigsten Notarium-Begriffe. Jeder Begriff verweist auf die Seite, auf der er ausführlich erklärt wird.

Speicherung und Identität

file-first — das Prinzip, dass die Quelle der Wahrheit die Markdown-Dateien selbst sind, direkt auf der Festplatte. Der Suchindex, der Verknüpfungsgraph und alles Abgeleitete lassen sich aus den Dateien wieder aufbauen; du kannst den Ordner jederzeit mitnehmen und gehen. Mehr dazu in File-first.

Space — eine isolierte Wissensbasis mit eigenem Index, Graph, eigener Suche, eigenem Baum, Revisionsprotokoll und eigener Mitgliederliste. Jeder Nutzer hat einen nicht löschbaren persönlichen Space (auf den agentenseitigen Seiten heißt er persönliche Domäne). Mehr dazu in Spaces und Projekte.

Projekt — eine leichtgewichtige, optionale Einheit: ein markierter Ordner mit stabiler Identität innerhalb eines Space (die Markierung ist eine Dot-Datei im Ordnerstamm). Ein Agent adressiert es über das Handle space/slug. Mehr dazu in Spaces und Projekte.

notarium-id — ein stabiler, 12-stelliger Notiz-Identifikator im Frontmatter. Er übersteht das Verschieben und Umbenennen der Datei, sodass Verknüpfungen und Verlauf nie abreißen. Mehr dazu in Versionsverlauf.

Notizklasse — eine Sammlung von Sichtbarkeits- und Indexierungsrichtlinien, die sich aus dem Speicherort der Notiz ableitet (kein frei wählbares Feld): user-doc (Nutzernotiz, überall sichtbar), agent-memory (Agentenspeicher, indexiert und über recall erreichbar, aber vor nutzerseitigen Oberflächen verborgen), dazu die internen attachment, derived und profile. Mehr dazu in Notiztypen.

Zugriff und Agenten

Principal — ein verallgemeinertes Zugriffssubjekt: eine Person oder ein KI-Agent. Ein einziger Mechanismus für Zugriffsgewährungen deckt sie alle ab. Mehr dazu in Zugriffsmodell.

Rollen — die Mitgliedschaft in einem Space: reader (liest alles), writer (bearbeitet Notizen), owner (verwaltet die Mitgliedschaft). Mehr dazu in Zugriffsmodell.

PAT (Personal Access Token) — ein persönliches Zugriffstoken für Agenten, übermittelt im Header Authorization: Bearer …. Es trägt einen Scope (read/write), optional eine Einschränkung auf Spaces und ein Ablaufdatum. Das Geheimnis wird genau einmal angezeigt. Mehr dazu in Einen Agenten verbinden.

MCP-Gateway — der eingebaute Endpunkt POST /mcp, über den ein KI-Agent die Wissensbasis mit absichtsorientierten Tools liest und schreibt (statt mit generischen CRUD-Operationen). Die Änderungen eines Agenten werden versioniert, durch Zugriffe begrenzt und mit Provenienz signiert. Mehr dazu in Agenten und MCP.

Intent-Tool — ein Tool des MCP-Gateways, das eine Absicht ausdrückt („finde", „erstelle eine Notiz") statt einer CRUD-Operation auf niedriger Ebene im Speicher. Mehr dazu in Intent-Tools.

Suche

hybride Suche — eine Fusion aus drei Kanälen: lexikalisch (Volltext FTS/BM25, immer aktiv), semantisch (Vektoren, per Flag aktivierbar) und ein optionaler Graph-Boost. Die Ergebnisse werden per RRF-Algorithmus kombiniert. Mehr dazu in Suche.

RRF (Reciprocal Rank Fusion) — ein Algorithmus, der Ranglisten (lexikalisch + semantisch + Graph) gewichtet und zu einem einzigen Ergebnissatz verschmilzt, ganz ohne gemeinsame Score-Skala. Mehr dazu in Suche.

Degradation — eine Fähigkeit fällt auf eine einfachere Variante zurück, wenn ihre Abhängigkeiten fehlen: Ist der Vektor-Stack aus oder nicht verfügbar, arbeitet die Suche weiter über den Volltext (FTS) — ohne Fehler und mit demselben Ergebnis. Mehr dazu in Suche einrichten.

Versionen und Provenienz

Revisionsprotokoll — der Versionsverlauf von Notizen in der Metadaten-Datenbank (nicht git). Eine Revision ist ein vollständiger Zustands-Snapshot; identische Zustände werden nach Inhalt dedupliziert. Der Schlüssel des Protokolls ist die notarium-id, sodass der Verlauf Verschieben und Umbenennen übersteht. Mehr dazu in Versionsverlauf.

Provenienz — die Zuordnung jeder Revision: wer die Änderung vorgenommen hat und wie — eine bestimmte Person, ein bestimmter KI-Agent oder ein externer Datei-Editor. Mehr dazu in Versionsverlauf.

Deployment

Self-Hosting — das Deployment-Modell von Notarium: ein einziger, in sich geschlossener Container (Node/Fastify, Engine im Prozess, keine externen Dienste). Der Datenschutz entsteht dadurch, dass dir Server und Dateien gehören, nicht durch Ende-zu-Ende-Verschlüsselung. Mehr dazu in Self-Hosting.

Siehe auch