đŸ©ș Vektor-Doktor: Die native Diagnose fĂŒr Qdrant

CrumbCrew · OZM · nullfeld
MĂ€rz 2026
FĂŒr den Moment, in dem man wissen will, wie groß der Wald ist.

I. Warum ein Skript und kein Dashboard?

Das Crumbforest-System ist auf „Local First“ und SouverĂ€nitĂ€t ausgelegt
(siehe Manifest #46 und den Nexus-Gedanken). Es verzichtet bewusst auf unnötigen
Ballast:

  • Kein Docker-Daemon, der im Hintergrund Ressourcen frisst
  • Keine grafische OberflĂ€che (GUI), die geladen werden muss
  • Kein externer Tracking- oder Telemetrie-Traffic

Weil Qdrant als native Binary betrieben wird, sind curl-Befehle die
sauberste, ehrlichste Form der Kommunikation mit dem Vektorraum.

Mit dem Vektor-Doktor (vektor-doktor.sh) haben wir ein Werkzeug geschaffen,
das die Fragen an die Datenbank vereinfacht – komplett in Bash.

II. Was der Vektor-Doktor macht

Das Skript vektor-doktor.sh ist ein reines Lese-Werkzeug. Es Àndert nichts an
der Datenbank, sondern hört nur zu.

1. PrĂŒfen, ob der Vektorraum atmet

./vektor-doktor.sh status

PrĂŒft den /readyz-Endpunkt von Qdrant auf Port 6333. Gibt Status 200
zurĂŒck, wenn der Kern lĂ€uft.

2. Nachsehen, wie viele BĂ€ume (Collections) es gibt

Bei 18 Repositories und 816 Markdown-Dateien muss man wissen, welche
Themenbereiche (Collections) bereits indiziert wurden.

./vektor-doktor.sh list

Liest die verfĂŒgbaren Collections aus der Struktur.

3. Punkte (BlÀtter) zÀhlen

Wenn der RAG-Ingest gelaufen ist, wollen wir wissen, wie viele Vektoren in einer
Collection erzeugt wurden.

./vektor-doktor.sh count <collection-name>
# Beispiel:
./vektor-doktor.sh count crumbforest_docs

Das gibt zurĂŒck, wie viele „BlĂ€tter“ der Baum hat.

4. Details auslesen

./vektor-doktor.sh info <collection-name>

Erzeugt die rohen JSON-Metriken einer Collection (z. B. Konfiguration der
VektorgrĂ¶ĂŸen, Distanz-Metriken usw.).

III. Voraussetzungen

Das Skript funktioniert am besten mit curl und jq. Falls jq (zum sauberen
Parsen von JSON im Terminal) auf dem Server fehlt, versucht der Vektor-Doktor,
die wichtigsten Werte ĂŒber reines grep zu retten.

Die erste Hilfe zur Selbsthilfe. Der Vektor-Doktor liefert keine „Lösung“
fĂŒr falsche Prompts, sondern Transparenz. Er zeigt dir, ob das Fundament –
der Vektorraum – befĂŒllt ist. Er ist der Pulsmesser fĂŒr das lokale
Wissensnetz. đŸŒČ