This commit is contained in:
1 parent
23b1cb2966
commit
e9532e8878
30 files changed
+1835
-542
No files matched your search
@@ -1,20 +1,66 @@
|
||||
#!/usr/bin/env python3
|
||||
# scripts/resolve_unresolved_references.py
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
resolve_unresolved_references.py — Unaufgelöste Wikilinks in Qdrant nachträglich auflösen
|
||||
FILE: scripts/resolve_unresolved_references.py
|
||||
VERSION: 2.1.0 (2025-12-15)
|
||||
STATUS: Active
|
||||
COMPATIBILITY: v2.9.1 (Post-WP14/WP-15b)
|
||||
|
||||
Version: 1.1.0 (Fixed for v2.6 Architecture)
|
||||
Zweck:
|
||||
-------
|
||||
Löst unaufgelöste Wikilinks in Qdrant nachträglich auf.
|
||||
Findet Edges mit status=="unresolved" und versucht sie über Titel/Alias aufzulösen.
|
||||
|
||||
Zweck
|
||||
------
|
||||
- Findet Edges in {prefix}_edges mit payload.status=="unresolved".
|
||||
- Baut einen In-Memory Index aller Notizen (Titel/Alias -> ID).
|
||||
- Aktualisiert die Edges (setzt target_id, entfernt status).
|
||||
- Erzeugt symmetrische 'backlink'-Kanten für 'references'.
|
||||
Funktionsweise:
|
||||
---------------
|
||||
1. Baut Lookup-Index aus allen Notizen:
|
||||
- Mapping: lower(title) -> note_id
|
||||
- Mapping: lower(alias) -> note_id
|
||||
2. Findet alle Edges mit status=="unresolved"
|
||||
3. Versucht Auflösung über Lookup-Index
|
||||
4. Aktualisiert erfolgreich aufgelöste Edges:
|
||||
- Setzt target_id
|
||||
- Entfernt status
|
||||
- Fügt resolution="healed_by_script" hinzu
|
||||
5. Erzeugt Backlinks für erfolgreich aufgelöste references-Edges
|
||||
|
||||
Aufruf
|
||||
------
|
||||
python3 -m scripts.resolve_unresolved_references --apply
|
||||
Ergebnis-Interpretation:
|
||||
------------------------
|
||||
- Log-Ausgabe: Fortschritt und Statistiken
|
||||
- "Resolvable: X/Y": Anzahl aufgelösbarer Edges
|
||||
- Ohne --apply: Dry-Run (keine DB-Änderungen)
|
||||
- Exit-Code 0: Erfolgreich
|
||||
|
||||
Verwendung:
|
||||
-----------
|
||||
- Nach Import von neuen Notizen, die bestehende Links auflösen
|
||||
- Reparatur von "Red Links" (Links auf noch nicht existierende Notizen)
|
||||
- Wartung des Graphen nach größeren Änderungen
|
||||
|
||||
Hinweise:
|
||||
---------
|
||||
- Sucht nach status=="unresolved" in Edge-Payloads
|
||||
- Auflösung erfolgt über Titel und Aliases (case-insensitive)
|
||||
- Erzeugt automatisch Backlinks für references-Edges
|
||||
- Batch-Verarbeitung für Performance
|
||||
|
||||
Aufruf:
|
||||
-------
|
||||
python3 -m scripts.resolve_unresolved_references --apply
|
||||
python3 -m scripts.resolve_unresolved_references --prefix mindnet --limit 1000 --apply
|
||||
|
||||
Parameter:
|
||||
----------
|
||||
--prefix TEXT Collection-Präfix (Default: ENV COLLECTION_PREFIX)
|
||||
--apply Führt tatsächliche DB-Änderungen durch (sonst Dry-Run)
|
||||
--limit INT Maximale Anzahl zu verarbeitender Edges (0=alle, Default: 0)
|
||||
--batch INT Batch-Größe für Upserts (Default: 100)
|
||||
|
||||
Änderungen:
|
||||
-----------
|
||||
v2.1.0 (2025-12-15): Dokumentation aktualisiert
|
||||
v1.1.0: Fixed for v2.6 Architecture
|
||||
v1.0.0: Initial Release
|
||||
"""
|
||||
|
||||
import argparse
|
||||
|
||||
Reference in new issue
Block a user