mirror of
https://github.com/TimInTech/proxmox-manager.git
synced 2026-11-20 19:22:53 +03:00
* fix(maintenance): re-pin Helper-Scripts to reviewed 2026-11-04 state Upstream changed core.func and four tools; all eight launchers were blocked. Reviewed the diffs (clear fallback, probe cache, non-fatal logging); no new network access or code paths. Pins and blob SHAs updated. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * refactor(maintenance): add Helper-Scripts identity, groups, hazard levels and verified-launch API Group and label the eight launchers, add SourceBlocked with file and revision details, stored_status() for a network-free menu header, and prepare_launch / run_launch so the verified bytes can be previewed and then executed unchanged. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * feat(maintenance): clearer Helper-Scripts menu with provenance, hazard tags and confirmation Pure render layer (view.py) feeds curses and the golden snapshot tests. Menu names the source, licence and website, groups tools by intent, shows text hazard tags and the stored source check. Confirmation shows URL, command and root-on-host notice; v previews the verified script. NO_COLOR, ASCII glyphs and optional OSC 8 links; badge colours are fixed pairs >= 4.5:1. Module version 1.0.4. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * test(maintenance): derive the bumped version in the installer rollback test Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * fix(maintenance): judge the stored source check against the current manifest A re-pin after the last daily check must not leave the old verdict standing: compare the observed blob with the reviewed pin instead of the stored status text. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * docs: describe the Helper-Scripts menu, hazard levels, confirmation and display options Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * docs(demo): record the new Helper-Scripts flow and close an anonymizer gap The demo now shows the grouped menu, the confirmation screen and the source preview for Kernel Clean, then cancels without starting anything. The stream anonymizer now holds back a partial 'Node:' header line until it is complete; a read ending between the colour codes leaked the real node name into the recording. The privacy scan strips control sequences before matching (it missed the leak before) and also checks the confirmation screen. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * fix(ci): commit demo markers for verification and de-flake the cancel PTY test verify_demo reads the confirmation time recorded by the driver, so the file belongs with the other demo artifacts. The PTY cancel test sent its 'q' in the same instant the UI flushes queued input and could lose it on a busy runner; it now repeats the key like a user would. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * fix(maintenance): qualify the Disk Health hazard level Disk Health can install smartmontools/nvme-cli on request, so its level text no longer promises that nothing changes: 'LESEN – Diagnose; installiert nur auf Nachfrage Pakete'. Docs and golden snapshots follow. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * feat(maintenance): badges in the maintenance menu and a calmer Helper-Scripts overview Changing actions get [ÄNDERT] and the Helper-Scripts entry gets a blue [FREMD] badge (white on xterm-256 25, 6.45:1), aligned in a column; the overview lists name, licence, URL and groups once instead of repeating them. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * docs(demo): re-record with the badged maintenance menu Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
6.7 KiB
6.7 KiB
Proxmox Manager GIF-Demo — Deterministische Headless-Pipeline
Dieses Verzeichnis enthält die vollständige, reproduzierbare Headless-Pipeline zur pixelgenauen Erstellung des Demo-GIFs und Rohvideos für Proxmox Manager.
Die Demo zeigt ausschließlich aktuell implementierte, lesende Oberflächen auf dem PVE-Host:
- Startansicht: VM-/CT-Instanztabelle mit Status, Typ und Tastenkürzeln.
- Health-Übersicht (
h): CPU-, MEM-, DISK-Auslastung, Uptime, OK/CRIT-Bewertung und Findings. - Hauptmenü: Rückkehr in die Hauptansicht.
- Host-Wartungsmenü (
m): Curses-basierte Host-Wartungsoberfläche. - Proxmox VE Helper-Scripts (Community): gruppierte Werkzeuge mit Gefahrenstufe, anschließend Bestätigungsschirm (Quelle, Befehl, Root-Hinweis) und Quellcode-Vorschau für „Kernel Clean“ – ohne Mutation, das Skript wird abgebrochen und nie gestartet.
Architektur
Die Pipeline trennt Session-Steuerung, Datenanonymisierung, Rendering und Verifikation sauber voneinander:
┌────────────────────────────────┐
│ Xvfb Headless Display (:99) │
│ (1280×720, 24-bit TrueColor) │
│ │
│ ┌──────────────────────────┐ │
│ │ Frameless Kitty Terminal │ │
│ │ (DejaVu Sans Mono 15.5) │ │
│ │ │ │
│ │ session_driver.py │ │
│ │ ├── pexpect PTY driver │ │
│ │ └── StreamAnonymizer │ │
│ └──────────┬───────────────┘ │
└──────────────┼─────────────────┘
│
ffmpeg x11grab (30 fps)
│
▼
┌────────────────────────────────┐
│ docs/demo/out/ │
│ ├── proxmox-manager-demo-raw │ (1280×720, H.264, 30 fps)
│ ├── proxmox-manager-demo.gif │ (1280×720, 12 fps, dither=none)
│ ├── proxmox-manager-demo.cast │ (Asciinema v2 Event-Stream, 33 KB)
│ └── pty_stream.log │ (Anonymisierter Stream-Dump)
└────────────────┬───────────────┘
│
build_player.py
└── index.html (Interaktiver Vektor-Player mit Kapiteln & Textauswahl)
│
verify_demo.py (Automated Validation)
├── OCR (tesseract) @ 2s, 8s, 18s
├── Privacy regex scanner (0 leaks in OCR, PTY, Cast)
└── ffprobe stream & size checks
1. Deterministischer Session-Treiber (session_driver.py)
- Steuert die echte
pman-Konsole über SSH (ssh -tt pve 'TERM=xterm-256color pman') an. - Verwendet kein blindes
sleep-Piping: Einepexpect-Zustandsmaschine wartet auf konkrete Text-Buffer vor jeder Aktion (h, Enter,m, Cursor-Navigation, Esc,q). - Keine schreibenden Aktionen: Es werden keine Installationen, Services, Reboots oder mutierenden Helper gestartet.
2. In-Stream-Pseudonymisierung (StreamAnonymizer)
- Ersetzt sensible Daten im Bytestrom in Echtzeit, bevor sie auf das Terminal gezeichnet werden:
- Header-Titel:
Proxmox VM/CT Manager→PROXMOX MANAGER(längengleich). - Node-Name:
Node: pve→Node: pve-node-01(Ausgleich der Padding-Leerzeichen; kein Verrutschen der║-Boxgrenze). - Private IP-Adressen: Reale
192.168.*-Adressen werden durch längengleiche RFC-5737-Dokumentations-IPs (192.0.2.*) ersetzt. - FQDNs:
pve.fritz.boxwird durchpve-node-01.lanersetzt. - SSH-Disconnect-Banner werden im Bytestrom bereinigt.
- Header-Titel:
3. Headless Rendering & Geometrie (build_demo.py)
- Rendering läuft isoliert in
Xvfb :99 -screen 0 1280x720x24. - Rahmenterminal (Kitty) mit
DejaVu Sans Monobei15.5 ptundwindow_padding_width=24füllt das Canvas exakt aus. - Keine Skalierungsunschärfe, keine Fensterrahmen, kein Desktop-Hintergrund, keine Terminal-in-Terminal-Verschachtelung.
4. Artefakt-Generierung
- Rohvideo:
1280×720, H.264, 30 fps, ca. 40–45 Sekunden Dauer (abhängig von der Netzwerkprüfung vor der Bestätigung). - GIF:
1280×720, 12 fps, optimierte Palette (palettegen=max_colors=128:stats_mode=diff,paletteuse=dither=none), Dateigröße unter 1 MB (Ziel < 10 MB). - Asciinema Cast:
docs/demo/out/proxmox-manager-demo.cast(33 KB NDJSON mit exakten Timestamps und Terminal-Events).
5. Interaktiver Web-Vektor-Player (index.html / build_player.py)
- Standalone HTML5-Webplayer mit integriertem Asciinema-Player v3 (Canvas/WASM-Rendering).
- Vollständige Wiedergabesteuerung: Play/Pause, Timeline-Scrubber, 1x/2x Geschwindigkeit, Vollbild.
- Interaktive Kapitelsprungmarken: Direktes Anspringen von Startansicht, Health-Check, Wartungsmenü, Helper-Scripts, Bestätigung, Quellcode und Exit.
- Freie Textauswahl: Alle Terminalinhalte können direkt mit der Maus markiert und per Tastatur kopiert werden (
Strg+C). - Offline- und Online-fähig: Lädt lokale Vendor-Assets (
vendor/) oder eingebetteten Cast, funktioniert sowohl viafile://als auch auf Webservern oder GitHub Pages.
Pipeline ausführen
Die gesamte Generierung inklusive anschließender automatisierter Validierung erfolgt mit einem einzigen Befehl:
bash docs/demo/build_demo.sh
Alternativ direkt per Python:
python3 docs/demo/build_demo.py
Automatisierte Verifikation (verify_demo.py)
Das Prüfskript validiert das erzeugte Artefakt objektiv vor Abschluss:
python3 docs/demo/verify_demo.py
Kriterien & Prüfpunkte:
- ffprobe Stream-Validierung:
- Rohvideo: Exakt 1280×720, 30 fps, Dauer zwischen 20.0s und 60.0s.
- GIF: 1100–1280 px Breite, 10–12 fps, Dateigröße < 10 MB.
- OCR-Prüfung (
tesseract):- Sekunde 2.0: Extrahiert Frame und verifiziert Schlüsselbegriff
"PROXMOX MANAGER". - Sekunde 8.0: Extrahiert Frame und verifiziert Schlüsselbegriff
"Health". - Sekunde 18.0: Extrahiert Frame und verifiziert Schlüsselbegriff
"Helper-Scripts". - Bestätigungsschirm (Zeitpunkt aus der eingecheckten
out/demo_markers.json, vom Treiber aufgezeichnet): verifiziert"FREMDER CODE"undroot.
- Sekunde 2.0: Extrahiert Frame und verifiziert Schlüsselbegriff
- Privacy-Check (Regex):
- Vollständiger Scan der OCR-Texte aller Frames und des gesamten aufgezeichneten PTY-Bytestroms (
pty_stream.log). - Verifiziert 0 Treffer für reale Hostnamen (
Node: pve,Host (pve),pve.fritz.box; Steuerzeichen werden vor dem Scan entfernt, damit durch Farbcodes getrennte Namen gefunden werden) und RFC1918-IPs (192.168.*,10.*,172.16-31.*).
- Vollständiger Scan der OCR-Texte aller Frames und des gesamten aufgezeichneten PTY-Bytestroms (