Ähnlichkeit

Apparat verwendet das Wort ähnlich an mehreren Stellen — bei der Suche, bei der Schreibassistenz, beim Aufräumen deines Vokabulars. Dahinter stehen verschiedene Verfahren, die unterschiedliche Probleme lösen. Diese Seite zeigt dir, welches Verfahren wann greift, sodass du beim Lesen einer Kommando-Beschreibung weißt, welche Sorte „Ähnlichkeit" gerade gemeint ist.

Schnell-Übersicht

Welches Konzept wann

„Ich tippe einen neuen Typ und befürchte, schon einen ähnlichen zu haben." Apparat prüft das in zwei Stufen: zuerst gegen bekannte Schreibvarianten (Persons → person), dann gegen lexikalisch ähnliche Werte (Tippfehler, Buchstaben­dreher). Beides läuft automatisch beim entity new-Prompt — du musst nichts dafür tun.

„Ich suche im Vault nach einem Begriff." Wortgenau? entity search ohne weitere Flags. Stichwort­los, nach Bedeutung? entity search --semantic. Beides? entity search --hybrid — die empfohlene Standard­wahl bei größeren Vaults.

„Ich habe eine Entität und will thematisch ähnliche." entity similar liefert die thematisch nächsten Notizen — du brauchst keinen Suchtext, nur die NanoID der Bezugs-Entität.

„Ich schreibe einen langen Body und vergesse, vorhandene Entitäten zu verlinken." ner suggest erkennt Personen, Orte und Organisationen im Text und gleicht sie gegen den Vault ab — als bekannter Treffer, naher Verwandter oder neuer Vorschlag.

„Ich will mein Vokabular aufräumen, bevor ich anlege." consolidate type und consolidate relation sind die expliziten Audit-Kommandos für Typen und Beziehungs­namen. Sie zeigen dir alle bestehenden Werte, die deinem Kandidaten ähneln, und du entscheidest.

Wo du suchst — und was dort passiert

Dieselben Such-Verfahren tauchen an verschiedenen Stellen auf, und nicht jede Stelle bietet jedes an. Diese Übersicht sagt dir, welcher Suchweg welchen Modus nutzt — damit du weißt, wo du einen Treffer erwarten darfst und wo nicht.

Der Unterschied, der im Alltag zählt: Das Suchfeld beim Verlinken im Text schaut nur auf Titel. Kennst du eine Notiz nur an einem Wort aus ihrem Inhalt, taucht sie dort nicht auf — dafür ist der Suche-Tab da, der auch den Text durchsucht. Hast du den Titel dagegen im Kopf, ist das Verlinken-Suchfeld der schnellere Weg. Die kombinierte Suche wiederum musst du nur auf der Kommandozeile ausdrücklich wählen; im Chat läuft sie ohnehin im Hintergrund.

Die Verfahren im Detail

Bekannte Schreibweise

Bei jedem Anlegen oder Bearbeiten einer Entität gleicht Apparat deine Eingabe für Typ, Beziehungs­name, Tag oder Sprache gegen das ab, was im Vault schon vorkommt. Der Abgleich folgt klaren Regeln, je nach Feld:

• Typen kleingeschrieben, Unterstriche statt Bindestriche, einfache englische Singular­regel (Persons → person).
• Beziehungs­namen in snake_case (WorksAt → works_at).
• Tags kleingeschrieben (WCAG ↔ wcag).
• Sprache im Format der internationalen Sprach-Codes (DE → de).

Findet Apparat einen Treffer, schlägt er die im Vault gespeicherte Schreibweise vor. Du übernimmst sie oder behältst deine Eingabe — Apparat schreibt nichts heimlich um.

Volltextsuche

Findet Notizen, in denen ein Suchwort wörtlich vorkommt — in Titel, Tags oder Body. Diakritika werden ignoriert (barriere findet barrière), und jeder Suchbegriff wirkt als Wortanfang (barriere findet auch Barrierefreiheit). Titel zählen stärker als Tags, Tags stärker als Body — das bringt die offensichtlich­sten Treffer nach oben.

Stark, wenn du das Wort kennst. Schwach, wenn du dich vertippst oder nach einem Synonym suchst — dafür sind die nächsten Verfahren da.

Bedeutungssuche

Apparat zerlegt jede Entität in mehrere Sinn-Abschnitte und übersetzt sie in eine numerische Repräsentation, die Bedeutung kodiert. Eine Anfrage wird genauso übersetzt und gegen alle Abschnitte verglichen — je näher die Bedeutung, desto höher der Treffer.

Stark, wenn du nicht das exakte Wort suchst, sondern das Thema: Eine Anfrage „barrierefreie Web-Formulare" findet auch eine Notiz, die nur „WCAG-Kontrastregeln" heißt.

Voraussetzung ist ein laufender Embedding-Dienst — Apparat liefert ihn als Container mit, und auf Wunsch lässt er sich auf einem Inferenz-Host im LAN betreiben.

Kombinierte Suche

Wortgenau und nach Bedeutung in einer Liste. Apparat führt beide Suchen parallel und mischt die Ergebnisse — wer in einer der beiden weit vorne steht, taucht auch im Mix oben auf. Faires Verfahren ohne Stell­schrauben, deshalb die empfohlene Standard­wahl, sobald der Vektor-Index befüllt ist.

Tippfehler-Erkennung

Apparat zählt, wie viele Einzel-Bearbeitungen nötig wären, um eine Eingabe in einen bestehenden Wert zu überführen — Buchstabe einfügen, ändern, löschen oder vertauschen. Magnos Kober ist von Magnus Kober einen Buchstaben­tausch entfernt; das reicht für einen Treffer. Buchstaben­dreher (Mraia ↔ Maria) werden als ein Edit gezählt, nicht als zwei.

Stark bei Schreibvarianten, die einen Buchstaben oder zwei abweichen. Blind für Synonyme oder Übersetzungen — dafür gibt es die Bedeutungs-Verfahren.

Eingesetzt sowohl bei ner suggest (gegen alle Entity-Titel) als auch bei der Vokabular-Konsolidierung (gegen Typen-, Beziehungs- und Tag-Listen).

Themen-Nachbarschaft im Namen

Wenn WCAG 2.2 im Body steht und der Vault eine Entität namens WCAG-Kontrastregeln hat, fängt das die Tippfehler-Stufe nicht — die beiden Schreib­weisen sind buchstabenmäßig zu weit auseinander. Stattdessen vergleicht Apparat die Bedeutung der Titel gegeneinander. Greift im Vorschlags­pfad von ner suggest als zweite Stufe, wenn die erste keinen Treffer hatte.

In den expliziten Konsolidierungs-Kommandos (consolidate type, consolidate relation) greift dieselbe Stufe — vorausgesetzt, der Vokabel-Wert hat eine eigene Definitionsnotiz im Vault, an die der Vergleich andocken kann.

Schwellwerte einstellen

Die Standard­werte sind so eingestellt, dass du sie im Normalfall nicht anfassen musst. Wenn doch — etwa weil dein Vault ein bestimmtes Muster systematisch übersieht oder zu viele Vorschläge produziert — sind das die vier Stell­schrauben:

Warum Schreibassistenz und Konsolidierung getrennte Werte haben: Die Schreibassistenz bewertet Personen-, Orts- und Organisationsnamen — meist mehrere Wörter, klares Bedeutungs-Signal, Tippfehler­toleranz darf locker sein. Die Konsolidierung bewertet kurze Vokabel-Tokens — wenig Bedeutungs-Signal, deshalb strenger eingestellt. Eine gemeinsame Einstellung würde einen der beiden Anwendungs­fälle suboptimal bedienen.

Warum die zwei lexikalischen Werte verschieden sind: Ein falscher Vorschlag bei der Schreibassistenz kann zu einer falschen Verlinkung führen — der Wert wandert dann tatsächlich in den Vault. Ein falscher Vorschlag bei der Konsolidierung ist ein Hinweis, den du ablehnst — nichts ist passiert. Deshalb ist die Schreibassistenz strenger eingestellt als die Konsolidierung.

Wenn du an den Schwellwerten drehst: nur an der Stelle, an der du das Verhalten konkret beobachtest. Nicht alle vier auf einmal.

Hinter den Kulissen

Die Verfahren auf dieser Seite haben Fachnamen — du brauchst sie nicht, aber falls du sie irgendwo liest oder im Quellcode darauf stößt, hier die Zuordnung:

• Bekannte Schreibweise — regelbasierter Catalog-Match.
• Volltextsuche — SQLite-FTS5 mit BM25-Ranking.
• Bedeutungssuche — Vektor-Embeddings mit L2-Distanz.
• Kombinierte Suche — Reciprocal Rank Fusion über Volltext- und Vektor-Ranglisten.
• Tippfehler-Erkennung — Damerau-Levenshtein-Distanz, normalisiert auf die Codepoint-Länge.
• Themen-Nachbarschaft im Namen — k-Nearest-Neighbour-Suche im Vektor-Raum, gefiltert auf Title-Chunks.

Vollständige Definitionen, Algorithmen und Begründungen stehen in der technischen Spezifikation des Projekts; das Handbuch erklärt absichtlich nur soviel davon, wie für die Bedienung nötig ist.

Vergleich mit anderen Systemen

Andere PKM-Systeme bringen meist nur eine Suchvariante mit (Volltext oder Bedeutung) und keine Schreibassistenz. Apparat investiert in mehrere Pfade, weil sie unterschiedliche Probleme lösen: Volltext für gezieltes Wieder­finden, Bedeutung für stichwort­loses Recherchieren, Tippfehler-Erkennung für die Schreib­hygiene, Schreibvarianten-Abgleich für strukturelle Sauberkeit. Dafür gibt es ein paar Stell­schrauben mehr — aber jeder Pfad ist optional und fällt sauber aus, wenn er nicht greift, ohne die anderen zu blockieren.