Enable public model catalogue and isolated file downloads; define native target

2026-09-28 15:50:31 +02:00
parent 6d5671f75b
commit 5fb732469a
12 changed files with 247 additions and 17 deletions
@@ -38,6 +38,37 @@ Diese Befehle verwalten ausschließlich den eigenen, per Label geprüften
 Deck-Container. Produktiver Router, Modelle, WireGuard und Hostkonfiguration
 werden nicht verändert. Kein Docker-Socket im Webcontainer.

-Modellkatalog, Downloads, Profile und llama.cpp-Build/Update sind weiterhin
-GUI-Entwürfe. Die Netzwerk-Erweiterung ist in dieser Installation deaktiviert.
+Profile und llama.cpp-Build/Update sind weiterhin GUI-Entwürfe. Die Netzwerk-Erweiterung ist in dieser Installation deaktiviert.
 Das Verschieben der Entwicklung aktiviert keine dieser Funktionen automatisch.
+
+## Verbindliche Zielarchitektur
+
+Das Produkt wird ein nativer Debian-systemd-Dienst unter eingeschränktem Benutzer.
+Docker ist ausschließlich die vorläufige Testverpackung. Katalog, Downloads und
+spätere Worker-Adapter dürfen Docker nicht voraussetzen. Kein Docker-Socket und
+keine Hostprozesssteuerung über Docker. Der vorhandene WireGuard-Container bleibt
+unverändert; Zugriff derzeit über SSH-Tunnel.
+
+## Live-Funktionen ab 0.5
+
+Hugging-Face-Suche nach Bereich, feste Repository-Revision, Dateiauswahl und
+serieller Download öffentlicher GGUF-/Safetensors-/JSON-Dateien. Eigener Ordner
+`runtime/state/models`; Fortschritt, Abbruch, 10 GiB Speicherreserve, Größenprüfung
+und bei vorhandenem LFS-Prüfwert SHA-256-Abgleich. Bei Neustart wird ein laufender
+Download nicht fortgesetzt; unvollständige Dateien sind keine Bibliothekseinträge.
+Keine automatische Ausführung heruntergeladener Dateien. Gated/private Modelle,
+Paketauflösung, VRAM-/Kontextprognose und Worker-Starts fehlen noch.
+
+Interne API (nur angemeldeter Administrator):
+- GET `/api/v1/catalog/search?q=...&kind=chat|image|audio|video`
+- GET `/api/v1/catalog/files?repo=owner/name`
+- GET `/api/v1/catalog`: Bibliothek, Downloadstatus, freier Speicher
+- POST `/api/v1/catalog/download`: repo, filename, revision, kind
+- POST `/api/v1/catalog/cancel`: leeres JSON-Objekt
+
+Anbieter-Dokumentation: https://huggingface.co/docs/hub/api . Audio-Suche filtert
+zunächst Sprachausgabe; weitere Audioaufgaben folgen. Einzelne Dateien stellen
+noch keine vollständige Installation eines mehrteiligen Modells dar.
+
+Update-Sicherungen enthalten den Konfigurationszustand, nicht die heruntergeladenen
+Modelldateien. Diese bleiben im persistenten Zustandsverzeichnis erhalten.