Planen Sie die Erfassung, überprüfen Sie Bewertungen und testen Sie die Wiederherstellung

Führen Sie die Aufnahme jede Minute unter macOS aus

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"

Führen Sie zunächst automode tick manuell aus. Prüfen Sie den Status auf Erfassungs- oder Indexfehler und behalten Sie paused: true bei. Erstellen Sie danach ~/Library/LaunchAgents/com.example.agent-vault-guide.plist mit folgendem Inhalt in einem Texteditor. Ersetzen Sie jedes YOUR_USER und legen Sie den LaunchAgents-Ordner bei Bedarf an.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>Label</key><string>com.example.agent-vault-guide</string>
  <key>ProgramArguments</key><array>
    <string>/Users/YOUR_USER/Developer/obsidian-master/.venv/bin/python</string>
    <string>-m</string><string>agent_vault.automode</string>
    <string>tick</string><string>--runtime</string>
    <string>/Users/YOUR_USER/Library/Application Support/AgentVaultGuide</string>
  </array>
  <key>WorkingDirectory</key><string>/Users/YOUR_USER/Developer/obsidian-master</string>
  <key>RunAtLoad</key><true/>
  <key>StartInterval</key><integer>60</integer>
  <key>StandardOutPath</key><string>/Users/YOUR_USER/Library/Application Support/AgentVaultGuide/worker.log</string>
  <key>StandardErrorPath</key><string>/Users/YOUR_USER/Library/Application Support/AgentVaultGuide/worker-error.log</string>
</dict></plist>

plutil -lint "$HOME/Library/LaunchAgents/com.example.agent-vault-guide.plist"
launchctl bootstrap "gui/$(id -u)" "$HOME/Library/LaunchAgents/com.example.agent-vault-guide.plist"
launchctl print "gui/$(id -u)/com.example.agent-vault-guide"

Damit wird der Job für Ihren angemeldeten Benutzer registriert. Er läuft nicht als systemweiter Dienst. Prüfen Sie nach einer Minute System/Intake/Auto-Status.json im Vault. Die Registrierung allein beweist nicht, dass der letzte Scan erfolgreich war. Prüfen Sie einen bereits vorhandenen Job, statt ihn wiederholt zu registrieren.

Um die geplante Erfassung zu stoppen, entladen Sie den Job dieses Tutorials:

launchctl bootout "gui/$(id -u)/com.example.agent-vault-guide"

automode pause hält dagegen nur die Bewertung an. Solange der Job geladen ist, läuft die Erfassung weiter. Keiner dieser Befehle stoppt Ihre Coding-Agenten.

Bringen Sie einen vorhandenen Notizenordner ein

Der Quellscanner erstellt echte Kopien und behält frühere Versionen. Er verschiebt die Originalnotizen nicht und ersetzt sie nicht durch symbolische Links. Legen Sie eine separate sources.json im Laufzeitverzeichnis der Anleitung an und passen Sie diese Pfade an:

{
  "vault": "/Users/YOUR_USER/Knowledge/AgentVault",
  "sources": [
    {
      "id": "project-notes",
      "label": "Project notes",
      "path": "/Users/YOUR_USER/Knowledge/ProjectNotes"
    }
  ]
}

.venv/bin/python -m agent_vault.vault_sources --config "$AGENT_VAULT_STATE/sources.json"
.venv/bin/python -m agent_vault.retrieval --vault "$AGENT_VAULT_PATH" --index-only

Verwenden Sie einen separaten Quellordner, nicht den Agent Vault selbst. Prüfen Sie die ausgewählten Dateien zuerst. Ohne --judge bleibt dieser Scan lokal. Kontrollieren Sie die Kopierprotokolle unter System/SourceSync. Der oben eingerichtete Zeitplan startet diesen separaten Scanner nicht. Führen Sie ihn erneut aus, wenn Sie Änderungen importieren möchten.

Aktivieren Sie die gehostete Beurteilung erst nach Überprüfung der Grenze

Lokale Erfassung und Suche funktionieren ohne TypeSafe-Schlüssel. Die optionale Jev-Bewertung sendet ausgewählte Passagen und begrenzten Kontext an TypeSafe. Sie liefert Empfehlungen mit Belegen, keine verifizierten Fakten und keine automatisch übernommenen Gedächtniseinträge. Ein lokaler Ersatz für den Bewertungsdienst ist in diesem Quellcode-Stand noch geplant.

Wenn Sie die Bewertung aktivieren möchten, stellen Sie TYPESAFE_API_KEY vertraulich bereit. Die Bridge liest diesen Schlüssel auch aus ~/Library/Application Support/AgentVault/.env. Diesen Speicherort teilen sich andere AgentVault-Installationen. Er liegt nicht im Warteschlangenverzeichnis der Anleitung. Schreiben Sie Zugangsdaten weder in den Vault, den Shell-Verlauf, das Repository noch in die launchd-Plist. Ein launchd-Job übernimmt keine exportierten Variablen aus einem interaktiven Terminal.

Bevor Sie fortfahren, überprüfen Sie die Nachrichten in der Warteschlange und stellen Sie sicher, dass sie den Computer verlassen können. Das konfigurierte tägliche Dollarlimit basiert auf geschätzten Inferenzkosten und nicht auf einer massgeblichen Ausgabenobergrenze des Anbieters. Vergleichen Sie die Preisannahmen des Adapters mit Ihren aktuellen Servicebedingungen.

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

Prüfen Sie die Belege unter System/Intake. Untersuchen Sie fehlgeschlagene oder unterbrochene Anfragen, statt sie wiederholt neu zu starten. Das Reranking der Suche wird separat über retrieval --judge jev aktiviert. Das Fortsetzen der Erfassung schaltet es nicht ein.

Überprüfen Sie einen Vorschlag, bevor Sie ihn zu einer gepflegten Notiz machen

Das Konsolidierungsmodul liest erfolgreiche Aufnahmebelege und schlägt Quellenauszüge zur Überprüfung vor. Es verlangt von einem Modell nicht, die Geschichte neu zu schreiben. Wenn die Bewertung weiterhin deaktiviert ist und keine erfolgreichen Belege vorliegen, wird mit einer leeren Vorschlagsliste gerechnet.

.venv/bin/python -m agent_vault.consolidation propose --vault "$AGENT_VAULT_PATH" --limit 10

Öffnen Sie System/Consolidation/Review.md in Obsidian. Folgen Sie einem Vorschlag bis zur Originalpassage. Prüfen Sie, von wem die Aussage stammt, ob sie noch gilt und ob spätere Nachweise sie korrigieren. Verwandte Notizen werden durch Wortübereinstimmungen gefunden. Das beweist weder, dass ein Vorschlag neu ist, noch dass er widerspruchsfrei ist.

Ersetzen Sie nach der Prüfung eines Vorschlags PROPOSAL_ID und den Namen des Prüfers. Wählen Sie für die neue Notiz ein Ziel, dessen übergeordneter Ordner bereits existiert:

.venv/bin/python -m agent_vault.consolidation accept \
  --vault "$AGENT_VAULT_PATH" --id PROPOSAL_ID \
  --target "Knowledge/Reviewed recovery decision.md" --reviewer "Your name"

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

Beim Übernehmen bleibt der Quellenverweis erhalten. Der Befehl prüft, ob die Quelle unverändert ist, und überschreibt keine andere Notiz. Er unterstützt ausserdem reject, defer und reopen, jeweils mit Prüfer und Begründung. Auch ein geprüfter Auszug braucht Nachweise für seine Aussagen.

Das Projekt umfasst auch Bewertungsvergleiche, explizite Entscheidungshistorie und Quellenneubewertung. Dabei handelt es sich um separate Arbeitsabläufe, nicht um automatisches Lernen, das durch diese Installation aktiviert wird. Lesen Sie deren Anleitungen und Konfiguration, bevor Sie sie ausführen. Eine Auswertung kann gehostete Anrufe durchführen, auch ohne Antworten zu generieren.

Überprüfen Sie ein Backup, indem Sie die Suche wiederherstellen und neu erstellen

Erstellen Sie recovery.json im Laufzeitverzeichnis der Anleitung. Das Ziel muss ausserhalb des Vaults liegen:

{
  "vault": "/Users/YOUR_USER/Knowledge/AgentVault",
  "code": "/Users/YOUR_USER/Developer/obsidian-master",
  "destination": "/Users/YOUR_USER/Backups/AgentVault"
}

.venv/bin/python -m agent_vault.recovery --config "$AGENT_VAULT_STATE/recovery.json"

Der Befehl archiviert Vault und Code, prüft Datei-Hashes, stellt die Daten in einem temporären Verzeichnis wieder her und baut den Index neu auf. Die Prüfung setzt START.md und durchsuchbare Inhalte voraus, die Sie in der ersten Lektion erstellt haben. Das Ergebnis steht in System/Recovery/Latest.json.

Ein Backup auf derselben Festplatte ist nur die erste Kopie. Bewahren Sie eine weitere verifizierte Kopie auf einem separaten Gerät auf. Der Wiederherstellungsbefehl stellt keine Hostanmeldeinformationen, nativen Sitzungen oder die gesamte Laufzeitwarteschlange wieder her. Veränderbare Dateien werden einzeln erfasst, nicht als ein Transaktions-Snapshot.

Entfernen Sie Zugangsdaten und nicht zugehörige Daten aus Quell-Checkout und Vault, bevor Sie diese archivieren. Die Veröffentlichung über Git mit geschwärzten Inhalten ist eine separate Funktion. Musterbasierte Schwärzung beweist nicht, dass alle vertraulichen Werte entfernt wurden. Diese Anleitung aktiviert keine Veröffentlichung auf einem entfernten Server.

Fehlerbehebung