6. Storage-Architektur

Storage-Architektur

Überblick

ZED verwendet mehrere Datenbanken und Dateiformate, je nach System:

Was	Pfad	Format
Text Threads	~/.local/share/zed/conversations/*.zed.json	JSON, unkomprimiert
Agent Threads	~/.local/share/zed/threads/threads.db	SQLite + zstd-Komprimierung
UI-State, History-Index	~/.local/share/zed/db/0-stable/db.sqlite	SQLite, kv_store Tabelle
Globale Settings	~/.local/share/zed/db/0-global/db.sqlite	SQLite
Prompts Library	~/.local/share/zed/prompts/prompts-library-db.0.mdb	LMDB

Der kv_store

In db/0-stable/db.sqlite gibt es eine kv_store Tabelle. Darin speichert ZED u.a.:

• recent-agent-threads — Liste der letzten Agent Thread UUIDs (global)
• recent-agent-threads-{workspace_id} — workspace-spezifische Liste
• agent_panel — letzter Panel-Zustand

Das Format der Thread-Referenzen ist [{"AcpThread": "uuid"}, ...].

WAL-Dateien

ZED nutzt SQLite im WAL-Modus (Write-Ahead Logging). Solange ZED läuft, können Änderungen in der -wal Datei stehen, nicht in der Hauptdatei. Nach dem Beenden von ZED wird der WAL automatisch committed.

Backup-Empfehlung

# Einmalig: Backup-Verzeichnis anlegen
rsync -av ~/.local/share/zed/threads/ ~/backup/zed-threads/
rsync -av ~/.local/share/zed/conversations/ ~/backup/zed-conversations/

→ Weiter: Die wichtigste Lektion