Installieren Sie die Bridge und testen Sie den lokalen Abruf

Holen Sie sich die Quelle, bevor Sie die Befehle ausführen

Die geprüfte Quelle ist obsidian-master, einschliesslich agent_vault/, tests/ und docs/Agent-Vault-Workshop.md. Sie liegt derzeit in einem privaten Repository. Diese Anleitung stellt weder ein öffentliches Paket noch ein plattformübergreifendes Installationsprogramm bereit.

Sie benötigen einen autorisierten Checkout oder einen Quellcode-Stand vom Maintainer. Legen Sie ihn unter ~/Developer/obsidian-master ab oder passen Sie die folgenden Pfade an. Ohne diese Quelle können Sie hier nicht fortfahren. Die Installation von Obsidian allein installiert die Bridge nicht.

Der lokale Abrufpfad verwendet die Standardbibliothek von Python, einschliesslich SQLite FTS5. Verwenden Sie für diese exemplarische Vorgehensweise Python 3.12. Der Code verwendet POSIX-Dateisperre; Dies sind keine nativen Windows-Anweisungen.

Wenn Homebrew bereits installiert ist:

brew install python@3.12

Führen Sie diese Pfadeinstellungen in einem neuen Terminal aus. Behalten Sie die Orte aus den vorherigen Lektionen bei oder passen Sie alle drei konsequent an.

export AGENT_VAULT_CODE="$HOME/Developer/obsidian-master"
export AGENT_VAULT_PATH="$HOME/Knowledge/AgentVault"
export AGENT_VAULT_STATE="$HOME/Library/Application Support/AgentVaultGuide"
cd "$AGENT_VAULT_CODE"

"$(brew --prefix [email protected])/bin/python3.12" -m venv .venv
.venv/bin/python -c 'import sqlite3; c=sqlite3.connect(":memory:"); c.execute("CREATE VIRTUAL TABLE probe USING fts5(text)"); print("SQLite FTS5 available")'
.venv/bin/python -m unittest discover -s tests -v

Das FTS5-Probe sollte seine Erfolgsmeldung ausgeben. Lesen Sie das aktuelle Testergebnis, anstatt sich auf eine alte Testzählung zu verlassen. Die Suite verwendet Vorrichtungen; Es legt nicht die Qualität der gehosteten Bewertungen fest.

Indizieren Sie den Vault und rufen Sie eine Notiz ab

.venv/bin/python -m agent_vault.retrieval \
  --vault "$AGENT_VAULT_PATH" --index-only

"$AGENT_VAULT_CODE/.venv/bin/python" -m agent_vault.retrieval \
  "What is our recovery rule?" --vault "$AGENT_VAULT_PATH" \
  --read-only --budget 800

Das Ergebnis sollte Ihre Wiederherstellungsregel und einen Quellenverweis enthalten. Es ist ein Paket aus Nachweisen, keine generierte Antwort. Dieser Test ruft keinen gehosteten Bewertungsdienst auf.

--read-only fragt den vorhandenen Such-Snapshot ab. Der Befehl aktualisiert ihn nicht und schreibt keinen Abrufbericht. Führen Sie nach Änderungen an Notizen den Indexbefehl erneut aus. Ein normaler Abruf ohne dieses Flag aktualisiert den Index und speichert einen Bericht. Geben Sie immer --vault an. Dieser Quellcode-Stand verwendet sonst einen entwicklerspezifischen Standardpfad.

Bereiten Sie die Aufnahme vor, ohne die gehostete Beurteilung zu aktivieren

mkdir -p "$AGENT_VAULT_STATE/inbox" "$AGENT_VAULT_PATH/System/Dashboard"

Das Dashboard-Verzeichnis muss vor dem ersten Erfassungszyklus in diesem Quell-Snapshot vorhanden sein.

Erstellen Sie in einem Texteditor die Datei config.json unter ~/Library/Application Support/AgentVaultGuide. Nutzen Sie diese Ausgangskonfiguration und ersetzen Sie jedes YOUR_USER durch den Namen Ihres macOS-Benutzerordners. Die JSON-Pfade müssen absolut sein. Der Code löst weder ~ noch Umgebungsvariablen in der Konfiguration auf.

{
  "vault": "/Users/YOUR_USER/Knowledge/AgentVault",
  "sources": "/Users/YOUR_USER/Library/Application Support/AgentVaultGuide/inbox",
  "additional_sources": [],
  "paused": true,
  "idle_seconds": 30,
  "batch_calls": 8,
  "daily_calls": 1000,
  "daily_usd": 1
}

.venv/bin/python -m agent_vault.automode baseline --runtime "$AGENT_VAULT_STATE"
.venv/bin/python -m agent_vault.automode status --runtime "$AGENT_VAULT_STATE"

Erwarten Sie den pausierten Modus und noch keine aufgezeichneten Gespräche. Der Posteingang ist leer. In den nächsten Anleitungen geht es um die Punkterfassung an Quellen, die Sie explizit auswählen.

paused: true hält die automatische Bewertung an. Die Erfassung läuft weiter. Der Baseline-Modus kopiert den vorhandenen Verlauf, ohne ihn zur Bewertung zu senden. Ein späterer tick erfasst neue Datensätze und aktualisiert die Suche, während die Bewertung angehalten bleibt. Das ist lokale Archivierung. Codex, Claude oder Pi werden dadurch nicht gestoppt.