Volltest
python -m pytest -q tests
Reproduzierbarer Betriebsmodus
Installation fuer technische Nutzer und Maintainer. Mit deterministischen Checks, Diagnosepfaden und Governance-Verifikation.
Diese Anleitung ist fuer Entwickler, Wissenschaftler mit Technikfokus und CI-nahe Arbeitsweisen. Ziel: stabiler, nachvollziehbarer Wrapper-Betrieb.
Setup
Baseline-Installation
| Schritt | Kommando / Hinweis |
|---|---|
| Repo holen | git clone https://github.com/vfi64/wrapper.git |
| Verzeichnis | cd wrapper |
| Venv + Dependencies | bash scripts/setup_venv.sh |
| Aktivieren | source .venc/bin/activate |
| Runtime Start | python Comm-SCI-Control-App.py |
Qualitaetssicherung
Contract- und Regressionstest-Pfade
S8 Bootstrap Fokus
python -m pytest -q tests/test_app_bootstrap.py
Contract-Pruefungen
python -m pytest -q tests/test_app.py -k "contract or panel"
Diagnose bei Fehlern
Comm State, Comm Anchor, Comm Audit und Logs gemeinsam auswerten.
Betriebsroutine
Empfohlene Session-Sequenz
- 1) Baseline
Regelwerk laden und `Comm State` pruefen.
- 2) Aktivierung
`Comm Start`, Profil setzen, optional SCI-Variante waehlen.
- 3) Betrieb
Inhaltsanfragen bearbeiten; bei langen Sessions periodisch `Comm Anchor` und `Comm Audit` laufen lassen.
- 4) Nachweis
Relevante Logs/Audit-Dateien archivieren und Zeitstempel dokumentieren.
Security und Kosten
API-Key-Behandlung im professionellen Betrieb
| Thema | Empfehlung |
|---|---|
| Speicherort | Bevorzugt ENV-Variablen; lokale Key-Datei nur fuer Einzelplatzbetrieb. |
| Key-Modi | api_key_plain (ohne Passphrase) vs. api_key_enc (mit Passphrase-Dialog beim Start/Provider-Wechsel). |
| Panel-Workflow | Im Bereich Provider & LLM den Button API-Key nutzen; je Provider getrennt pflegen. |
| Provider-Onboarding | Gemini: Key, OpenRouter: Key, Hugging Face: Token |
| Kostenkontrolle | Pricing vorab pruefen: Gemini, OpenRouter, HF. |
| Leak Response | Key sofort widerrufen, rotieren, lokale Artefakte prufen, Zugriffsgrenzen anpassen. |