This commit is contained in:
1 parent
23b1cb2966
commit
e9532e8878
30 files changed
+1835
-542
No files matched your search
@@ -1,4 +1,61 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
FILE: scripts/backfill_edges.py
|
||||
VERSION: 2.1.0 (2025-12-15)
|
||||
STATUS: Active
|
||||
COMPATIBILITY: v2.9.1 (Post-WP14/WP-15b)
|
||||
|
||||
Zweck:
|
||||
-------
|
||||
Füllt fehlende Edges nach, indem es Wikilinks aus dem Vault extrahiert
|
||||
und in Qdrant schreibt. Nützlich nach Migrationen oder wenn Edges verloren gingen.
|
||||
|
||||
Funktionsweise:
|
||||
---------------
|
||||
1. Scannt alle Markdown-Dateien im Vault
|
||||
2. Für jede Datei:
|
||||
- Erstellt Note-Stub (minimaler Payload)
|
||||
- Erstellt einen Chunk mit dem gesamten Body
|
||||
- Extrahiert Wikilinks via derive_wikilink_edges
|
||||
3. Baut Lookup-Index (Titel/Alias -> note_id)
|
||||
4. Löst Wikilinks auf und erzeugt Edges
|
||||
5. Schreibt Edges in Qdrant
|
||||
|
||||
Ergebnis-Interpretation:
|
||||
------------------------
|
||||
- Ausgabe: JSON mit Statistiken
|
||||
* notes_scanned: Anzahl verarbeiteter Notizen
|
||||
* edges_upserted: Anzahl geschriebener Edges
|
||||
- Exit-Code 0: Erfolgreich
|
||||
|
||||
Verwendung:
|
||||
-----------
|
||||
- Nach Migrationen oder Datenverlust
|
||||
- Wenn Edges fehlen oder unvollständig sind
|
||||
- Zur Reparatur des Graphen
|
||||
|
||||
Hinweise:
|
||||
---------
|
||||
- Überschreibt existierende Edges (kein Merge)
|
||||
- Nutzt vereinfachtes Chunking (1 Chunk = gesamter Body)
|
||||
- Erzeugt nur Wikilink-Edges, keine anderen Edge-Typen
|
||||
|
||||
Aufruf:
|
||||
-------
|
||||
python3 -m scripts.backfill_edges --vault ./vault
|
||||
python3 -m scripts.backfill_edges --vault ./vault --exclude /.obsidian/ /_backup/
|
||||
|
||||
Parameter:
|
||||
----------
|
||||
--vault PATH Pfad zum Vault-Verzeichnis (erforderlich)
|
||||
--exclude PATH Pfade zum Ausschließen (Default: /.obsidian/, /_backup_frontmatter/)
|
||||
|
||||
Änderungen:
|
||||
-----------
|
||||
v2.1.0 (2025-12-15): Dokumentation aktualisiert
|
||||
v1.0.0: Initial Release
|
||||
"""
|
||||
from __future__ import annotations
|
||||
import argparse, glob, json, os
|
||||
from typing import List, Tuple
|
||||
|
||||
Reference in new issue
Block a user