Gemeinsames Gedächtnis.
Unter Ihrer Kontrolle.

01 / Die Geschichte

Das Projekt wird fortgesetzt. Das Gespräch ändert sich.

Die Ausgangsfrage war einfach. Könnten wir unseren Arbeitsverlauf in einem Obsidian-Vault aufbewahren und ihn für alle Agenten und Maschinen verwenden? Ein Projekt kann eine Chat-Sitzung, eine Modellauswahl oder die Anwendung, mit der wir begonnen haben, überleben. Seine Entscheidungen sind immer noch wichtig.

Ich wollte etwas, das sich einfach installieren und lokal ausführen lässt, idealerweise auf jedem Betriebssystem. Die Notizen mussten Markdown sein, damit ich sie selbst lesen und bearbeiten konnte, auch ohne Agenten. Ich wollte ausserdem ein minimales Dashboard, um zu sehen, was das System tut, ohne eine weitere Anwendung darauf aufbauen zu müssen.

Obsidian passte zu dieser Idee. Es gab mir einen Reader für die Markdown-Dateien, Links zwischen Notizen und eine Grafik dieser Verbindungen. Die Unterstützung für HTML in Notizen passte auch zu der schlanken Benutzeroberfläche, die ich mir vorgestellt hatte. Eine einfache Installation und Unterstützung auf allen Betriebssystemen waren Anforderungen, auf die man hinarbeiten musste, und nicht Dinge, von denen ich annehmen wollte, dass sie bereits gelöst waren.

Das Kopieren einer Zusammenfassung in das nächste Gespräch hilft, aber eine Zusammenfassung kann den Grund für eine Entscheidung verlieren. Es kann auch einen alten Fehler fortführen, ohne die spätere Korrektur. Wir wollten das Original überprüfen können.

Wir haben obsidian-master mit gewöhnlichen Dateien und einem gemeinsamen Abrufbefehl aufgebaut. Die nativen Agentensitzungen bleiben an ihren bisherigen Speicherorten. Die Bridge kopiert unterstützte Datensätze in einen separaten Vault. Ein Wechsel des Agenten bedeutet damit nicht, das Archiv aufzugeben.

Nach einer Woche

Die Grafik gibt mir eine Möglichkeit, die Zusammenhänge zu erkunden. Um eine bestimmte Entscheidung zu verstehen, muss ich die Notiz trotzdem öffnen und ihr bis zur Quelle folgen. Die Dashboards beantworten eine andere Frage: Was hat die Brücke erfasst, beurteilt und zurückgegeben?

02 / Das Problem

Alles zu speichern ist nicht dasselbe wie sich daran zu erinnern, was wichtig ist

Ein Archiv kann weit über das hinauswachsen, was in eine Eingabeaufforderung gehört. Das Senden des gesamten Verlaufs an ein Modell verursacht zusätzliches Rauschen und macht es schwieriger zu erkennen, welche Nachweise eine Antwort tatsächlich verwendet hat.

Auch die umgekehrte Abkürzung ist riskant. Wenn ein Modell entscheidet, dass eine Passage unwichtig ist und wir das Original verwerfen, sind für eine spätere Frage möglicherweise Nachweise erforderlich, die wir nicht mehr haben. Unsere Brücke bewahrt daher Quellen vor einer optionalen Beurteilung.

Wir müssen auch die Entscheidung eines Benutzers vom Vorschlag eines Assistenten unterscheiden. Beides kann es wert sein, behalten zu werden. Keines von beiden sollte stillschweigend zu einer bestätigten Tatsache werden, weil ein anderer Agent es abgerufen hat.

03 / Wie es funktioniert

Ein Archiv, ein lokaler Suchindex, mehrere Agenten

Obsidian macht die Dateien lesbar

Der Vault enthält erfasste Originale, aufbewahrte Notizen und Überprüfungsaufzeichnungen. Mit Obsidian können wir Verbindungen zwischen ihnen verfolgen und die Notizen bearbeiten, die wir besitzen. Die Bridge benötigt kein Obsidian-Community-Plugin oder einen kostenpflichtigen Synchronisierungsdienst. Die Befehlszeilenarbeit kann bei geschlossener App fortgesetzt werden.

Markdown ist das Format für die Notizen, die ich pflege und lese. Die unterstützenden Datensätze verwenden die für sie geeigneten Formate: JSONL für erfasste Konversationen, JSON für Belege und Manifeste und HTML für Dashboard-Ansichten. Die Lesbarkeit der Notizen zu gewährleisten bedeutet nicht, dass jeder Originaldatensatz in Markdown konvertiert und seine Struktur verloren geht.

Der Quellscanner kann auch Dateien aus vorhandenen Notizordnern kopieren. Es bewahrt physische Kopien und Revisionen und ist nicht auf Links zu Ordnern angewiesen, die möglicherweise auf einem anderen Computer fehlen.

Die Brücke bewahrt, wer was gesagt hat

Hostspezifische Adapter erkennen unterstützte Codex-, Claude Code- und Pi-Konversationsdatensätze. Bei der inkrementellen Erfassung bleiben neue Segmente mit ihrer Quellidentität erhalten. Die Originaldatensätze bleiben vom sichtbaren Nachrichtentext, der für die Suche verwendet wird, getrennt.

Diese Trennung ist wichtig. Ein Suchergebnis kann auf die erhaltene Quelle verweisen, aber nicht jeder Werkzeugdatensatz oder binäre Anhang wird zu durchsuchbarem Text. Da sich die Formate der Host-Transkripte ändern können, ist bei der Erfassung nach Aktualisierungen eine Überprüfung der echten Nachricht erforderlich.

Rufen Sie bei Bedarf einen kleinen Satz an Nachweisen ab

SQLite FTS5 durchsucht das lokale Archiv. Der Abrufbefehl gibt begrenzte Auszüge mit Quellenangaben und Quellenangabe zurück. Der Agent erhält den relevanten Verlauf, ohne den gesamten Vault in jedes Gespräch laden zu müssen.

Der Agent stellt eine gezielte Frage
  → Die lokale Suche findet passende Auszüge
  → Ein begrenztes Kontextpaket enthält die Quellenverweise
  → Der Agent antwortet anhand dieser Nachweise
  → Sie können das Original öffnen und prüfen

Jeder Agent verfügt über eine Anweisung, die erklärt, wann und wie derselbe Abrufbefehl aufgerufen werden soll. Hierbei handelt es sich um einen expliziten Abruf und nicht um einen Ersatz für den nativen Speicher der Anwendung. Es hängt auch davon ab, dass der Agent Zugriff auf die Bridge und den Index hat.

Wo wir Jev verwenden

In diesem Ablauf übernimmt Jev die Bewertung. Bei der Aufnahme prüft es eine ausgewählte Passage auf nützlichen Inhalt, ordnet sie einer Kategorie zu und bewertet ihre mögliche Wiederverwendung. Eine Entscheidung, eine Präferenz und ein vorgeschlagenes Vorgehen müssen unterschiedlich behandelt werden. Die strukturierte Bewertung wird neben der Quelle gespeichert und ersetzt sie nicht.

Signal schätzt den Nutzen unter unserer Rubrik, nicht die Wahrscheinlichkeit, dass eine Aussage wahr ist. Bei der Wiederverwendbarkeit handelt es sich um eine Bewertung, nicht um eine weitere Konfidenzwahrscheinlichkeit. Wir bewahren das Ergebnis des Anbieters und den Antrag in einer Beleg auf, damit das Bewertung später eingesehen werden kann.

Jev spielt beim Abrufen auch eine optionale Rolle. Die lokale Suche findet zuerst eine Auswahlliste. Jev kann dann die Relevanz und Unterstützung der aktuellen Frage beurteilen, um die Einstufung dieser Nachweise zu erleichtern. Dies unterscheidet sich von der früheren Entscheidung, dass eine Passage es wert sei, überprüft zu werden.

Diese Jev-Aufrufe nutzen einen gehosteten Dienst und senden ausgewählten Text vom lokalen Rechner dorthin. Sie sind optional. Die Erfassung und die lokale Stichwortsuche funktionieren ohne API-Schlüssel. In den Installationsanleitungen bleibt die Bewertung zunächst angehalten.

Die Bewertungen dienen als Empfehlung. Nach einer Prüfung kann ein mit seiner Quelle verknüpfter Auszug in eine gepflegte Notiz übernommen werden. Das Original bleibt erhalten. Korrekturen lassen sich an frühere Aussagen anhängen. Eine spätere Suche kann dann den ursprünglichen Nachweis zusammen mit seiner Korrektur liefern.

Kleine Dashboards, die die Arbeit zeigen

Ich wollte den Ablauf prüfen können, ohne jeden einzelnen Rohbeleg zu lesen. Die Bridge erzeugt dafür HTML-Ansichten unter System/Dashboard, neben den Markdown-Notizen und Quelldatensätzen.

• Judging.html zeigt den Quelltext, Jevs Ergebnisse zu Signal, Kategorie und Wiederverwendbarkeit sowie Prüfstatus, Latenz und, soweit verfügbar, geschätzte Kosten. Jedes Ergebnis verweist auf das Original und den vollständigen Beleg.
• Retrieval.html zeigt eine gespeicherte Suchanfrage, die gefundenen Auszüge und die Auswahl für das Antwortpaket. Wenn ein Reranking stattfand, erscheinen auch die Bewertungen zu Relevanz und Belegkraft.
• Operations.html fasst den letzten Erfassungsstatus, die Warteschlange, den Suchindex, die Prüfzahlen und die Backup-Prüfungen zusammen. Die Zeitstempel beschreiben beobachtete Läufe. Sie garantieren nicht, dass alles weiterhin läuft.
• Mit Evaluation.html können wir gespeicherte Vergleiche der Nachweise prüfen, die einer Antwort zugrunde lagen. Neue Tests und die menschliche Prüfung übernimmt ein separates lokales Auswertungsprogramm. So lassen sich Kontextumfang, Laufzeit und Antwortqualität getrennt untersuchen.

Obsidian unterstützt HTML in Notizen, bereinigt die Inhalte aber und schränkt sie ein. Eine vollständige interaktive HTML-Anwendung lässt sich so nicht innerhalb einer Notiz ausführen. Die erzeugten Dashboard-Dateien öffnen Sie im Browser. Das interaktive Auswertungstool läuft auf einem separaten lokalen Server.

Diese Ansichten spiegeln die tatsächlich ausgeführten Arbeitsabläufe wider. Bei einer schreibgeschützten Suche wird kein neuer Abrufbericht erstellt, und bei einer Neuinstallation liegen noch keine Bewertungsergebnisse oder Bewertungen vor. Die Akten und Belege bleiben der Nachweis hinter dem Dashboard.

Testen Sie die Übergabe, nicht nur die Antwort

Die praktische Prüfung besteht darin, eine harmlose Entscheidung eines Agenten aufzuzeichnen, sie zu erfassen und dann einen anderen Agenten zu bitten, sie zu finden und die Quelle anzugeben. Eine plausible Antwort allein beweist nicht, dass die Brücke funktioniert hat. Der Abrufaufruf und die zurückgegebene Referenz tun dies.

Bei der wortbasierten Suche können anders ausgedrückte Nachweise übersehen werden. Ein Rankinger kann keine Quelle wiederherstellen, die seine Kandidaten nie erreicht hat. Der kleinere Kontext ist daher neben fehlenden Nachweisen zu messen, nicht der Nachweis für bessere Antworten oder niedrigere Rechnungen.

04 / Lokale Kontrolle und Portabilität

Ihre Dateien können mit Ihnen verschoben werden

Das Design ist portabel, da die Nachweise in Dateien gespeichert sind und nicht nur im Sitzungsspeicher eines Agenten. Ein verifiziertes Backup kann den Vault und die Brücke auf eine andere Maschine übertragen. Der Suchindex kann aus diesen Dateien neu erstellt werden.

Das bedeutet noch nicht, dass es einen One-Click-Installer gibt, der überall läuft. Die exemplarische Vorgehensweise verwendet macOS. Die Bridge verwendet Python- und POSIX-Dateisperren und das geplante Setup verwendet macOS launchd. Um es zu verschieben, müssen die Laufzeit überprüft, lokale Pfade geändert und die Agent-Quellen erneut verbunden werden. Die native Windows-Installation wird in diesem Handbuch nicht behandelt.

Lokale Speicherung bedeutet auch nicht, dass jede spätere Nutzung lokal bleibt. Wenn Sie die gehostete Beurteilung aktivieren, wird der ausgewählte Text an diesen Dienst gesendet. Durch die Übergabe der abgerufenen Nachweise an einen Cloud-gestützten Agenten können diese an den Modellanbieter des Agenten gesendet werden. Sie wählen diese Verbindungen separat aus.

Backups verdienen eine eigene Prüfung. Das Wiederherstellungsmodul überprüft Hashes, stellt Dateien in einem isolierten Verzeichnis wieder her und erstellt die Suche neu. Eine vollständige native Agentenumgebung, einschliesslich Zugangsdaten und Laufzeitwarteschlangen, wird nicht wiederhergestellt.

05 / Installation

Beginnen Sie mit einer Notiz. Dann verbinden Sie Ihre Agenten.

Die Anleitungen beginnen mit einem neuen Obsidian-Vault und einer künstlich erstellten Beispielnotiz. Danach folgen Python, die Bridge und ein lokaler Abruftest. Binden Sie zuerst die Agenten an, die Sie tatsächlich nutzen. Die geplante Erfassung, optionale Bewertung und Backups kommen danach.

Sie benötigen derzeit einen autorisierten Checkout von obsidian-master. Dieser Quellcode-Stand enthält kein öffentliches Installationsprogramm. Die Anleitungen nennen diese Voraussetzung ausdrücklich. Die Bewertung über den gehosteten Dienst bleibt bei den ersten Prüfungen ausgeschaltet.

Beginnen Sie mit der Obsidian-Installationsanleitung, oder wählen Sie unten den benötigten Abschnitt.