v0.7.0
This commit is contained in:
+53
-272
@@ -1,33 +1,8 @@
|
||||
# Omarchy Citizen 0.6.4 – Plug-&-Play-Installation
|
||||
# Omarchy Citizen 0.7.0 – Rundum-Sorglos
|
||||
|
||||
## Ziel
|
||||
## Installation
|
||||
|
||||
Der Nutzer soll Star Citizen unter Omarchy benutzen können, ohne Linux administrieren zu müssen.
|
||||
|
||||
Im normalen Alltag sind nur drei Dinge wichtig:
|
||||
|
||||
1. **EINRICHTEN & STARTKLAR MACHEN** bzw. **STAR CITIZEN STARTEN**
|
||||
2. **Problem beheben**
|
||||
3. **Support-Paket erstellen**
|
||||
|
||||
Wine-Runner, DXVK, einzelne Reparaturschritte, Logs und NGL befinden sich unter
|
||||
**Erweiterte Optionen**.
|
||||
|
||||
---
|
||||
|
||||
## 1. Plugin installieren
|
||||
|
||||
### Mausfreundlich
|
||||
|
||||
Entpacke `omarchy-citizen-0.6.0.zip`.
|
||||
|
||||
Im entpackten Ordner liegt:
|
||||
|
||||
`INSTALLIEREN.sh`
|
||||
|
||||
Führe diese Datei über deinen Dateimanager als Programm aus.
|
||||
|
||||
Falls der Dateimanager Skripte nicht direkt ausführt, bleibt der Terminal-Fallback:
|
||||
Entpacken und einmal ausführen:
|
||||
|
||||
```bash
|
||||
./INSTALLIEREN.sh
|
||||
@@ -39,267 +14,73 @@ oder:
|
||||
./install.sh
|
||||
```
|
||||
|
||||
Der Plugin-Installer benötigt kein `sudo` und schreibt nur nach:
|
||||
Danach übernimmt **Autopilot**.
|
||||
|
||||
## Was automatisch aktuell gehalten wird
|
||||
|
||||
Ohne weitere Pflege des Nutzers:
|
||||
|
||||
- Omarchy Citizen selbst (wenn als Git-Plugin installiert)
|
||||
- offizieller LUG Helper als AppImage
|
||||
- stabiler LUG-Wine-Runner
|
||||
- DXVK
|
||||
- Auswahl des verwalteten Wine-Runners im Start-Script
|
||||
|
||||
Der Wartungstimer läuft alle sechs Stunden.
|
||||
|
||||
## Sicherheitsmechanismus für Wine Updates
|
||||
|
||||
Ein neuer Wine-Runner wird nicht einfach installiert.
|
||||
|
||||
Omarchy Citizen baut zuerst einen temporären Wine-Prefix und verlangt erfolgreich:
|
||||
|
||||
```text
|
||||
~/.config/omarchy/plugins/local.omarchy-citizen/
|
||||
wineboot
|
||||
drive_c
|
||||
system.reg
|
||||
user.reg
|
||||
%APPDATA%
|
||||
```
|
||||
|
||||
Nach der Installation erscheint **✦SC** in der Omarchy-Leiste.
|
||||
Erst danach wird der Runner aktiviert.
|
||||
|
||||
---
|
||||
Damit hätte der Fehler, den wir während der Entwicklung gesehen haben
|
||||
(`drive_c` fehlt / `%AppData% returned empty string`), bereits *vor* der echten
|
||||
Star-Citizen-Installation den Autopilot-Test gestoppt.
|
||||
|
||||
## 2. Erstes Setup
|
||||
## Warum kein AUR-LUG-Paket mehr?
|
||||
|
||||
Klicke:
|
||||
Der offizielle LUG Helper wird als AppImage verwaltet. Dadurch hängt der
|
||||
Star-Citizen-Workflow nicht mehr davon ab, ob das AUR-Paket, dessen Winetricks
|
||||
oder dessen GUI-Abhängigkeiten gerade passend installiert sind.
|
||||
|
||||
**✦SC → EINRICHTEN & STARTKLAR MACHEN**
|
||||
Bestehende AUR-LUG-Installationen dürfen vorhanden bleiben; Omarchy Citizen
|
||||
bevorzugt jedoch seine eigene verwaltete AppImage-Kopie.
|
||||
|
||||
Omarchy Citizen übernimmt danach soweit möglich selbst:
|
||||
## Systemupdates
|
||||
|
||||
- benötigte Systempakete prüfen/installieren
|
||||
- `zenity`, `polkit`, `cabextract`, `unzip`
|
||||
- LUG Helper aus dem AUR installieren
|
||||
- LUG Preflight Check starten
|
||||
- Star-Citizen-/RSI-Launcher-Einrichtung starten
|
||||
- vorhandenen Wine-Prefix erkennen
|
||||
- Start-Script erkennen/reparieren
|
||||
Omarchy Citizen installiert absichtlich keine dauerhafte passwortlose
|
||||
Pacman-/sudo-Regel.
|
||||
|
||||
Für Paketinstallationen kann einmal ein sichtbares Omarchy-Terminal erscheinen.
|
||||
Das ist absichtlich so, damit Passwortabfragen sicher und nachvollziehbar bleiben.
|
||||
Der Nutzer muss dort keine Paketnamen oder Linux-Befehle kennen.
|
||||
Omarchy-System-, Kernel- und GPU-Treiberupdates bleiben bei:
|
||||
|
||||
---
|
||||
|
||||
## 3. Normaler Alltag
|
||||
|
||||
Wenn das Panel **FLIGHT READY** zeigt:
|
||||
|
||||
**✦SC → STAR CITIZEN STARTEN**
|
||||
|
||||
Das Plugin verwendet weiterhin das vom LUG Helper verwaltete `sc-launch.sh`.
|
||||
|
||||
---
|
||||
|
||||
## 4. Problem beheben
|
||||
|
||||
Klicke:
|
||||
|
||||
**✦SC → Problem beheben**
|
||||
|
||||
Der Assistent prüft zuerst automatisch, ob etwas offensichtlich fehlt.
|
||||
|
||||
Wenn das System grundsätzlich eingerichtet ist, fragt er nur nach dem Symptom:
|
||||
|
||||
- Automatisch prüfen
|
||||
- RSI Launcher startet nicht / ist kaputt
|
||||
- Star Citizen startet nicht
|
||||
- Grafik / Performance / Abstürze
|
||||
- NGL macht Probleme
|
||||
- Problem unklar
|
||||
|
||||
Dahinter werden die passenden LUG-Helper-Funktionen aufgerufen.
|
||||
|
||||
Der Nutzer muss keine Begriffe wie Wine-Prefix, DXVK oder `vm.max_map_count` kennen.
|
||||
|
||||
---
|
||||
|
||||
## 5. Permanentes Debug-Log
|
||||
|
||||
Omarchy Citizen protokolliert seine eigenen Aktionen dauerhaft unter:
|
||||
|
||||
```text
|
||||
~/.local/state/omarchy-citizen/omarchy-citizen.log
|
||||
```bash
|
||||
omarchy update -y
|
||||
```
|
||||
|
||||
Darin stehen unter anderem:
|
||||
Das ist der von Omarchy vorgesehene vollständige Updatepfad. Die Star-Citizen-
|
||||
Komponenten selbst werden davon unabhängig durch Autopilot gepflegt.
|
||||
|
||||
- Plugin-Version
|
||||
- aufgerufene Plugin-Aktionen
|
||||
- Start-/Reparaturvorgänge
|
||||
- LUG-Helper-Aufrufe
|
||||
- Setup-/Update-Abläufe
|
||||
- Fehlermeldungen des Plugins
|
||||
## Support
|
||||
|
||||
Das lokale Roh-Log kann in **Erweiterte Optionen → Plugin-Debuglog öffnen**
|
||||
angesehen werden.
|
||||
|
||||
Das Roh-Log wird nicht automatisch hochgeladen oder versendet. Ab ungefähr 4 MiB wird es automatisch gekürzt; die neuesten ungefähr 2 MiB bleiben erhalten.
|
||||
|
||||
---
|
||||
|
||||
## 6. Support-Paket für Nutzer
|
||||
|
||||
Klicke:
|
||||
Bei einem Fehler:
|
||||
|
||||
**✦SC → Support-Paket erstellen**
|
||||
|
||||
Das Plugin erzeugt automatisch eine Datei wie:
|
||||
Das Paket enthält zusätzlich:
|
||||
|
||||
```text
|
||||
~/Downloads/Omarchy-Citizen-Support-OC-20260831-123456-abcdef.tar.gz
|
||||
```
|
||||
|
||||
Zusätzlich wird eine **Support-ID** angezeigt.
|
||||
|
||||
### Standardmäßig enthalten
|
||||
|
||||
- Omarchy Citizen Status
|
||||
- Plugin-Version
|
||||
- `omarchy debug --no-sudo --print`
|
||||
- Kernel/Desktop-Informationen
|
||||
- GPU/Vulkan-Zusammenfassung
|
||||
- RAM
|
||||
- Dateisystemtyp und freier Speicher
|
||||
- relevante Paketversionen
|
||||
- Star-Citizen-Kernel-Limits
|
||||
- Plugin-Validierung
|
||||
- letzte Omarchy-Citizen-Debugmeldungen
|
||||
- letzter Omarchy-Update-Logauszug, falls vorhanden
|
||||
- Star-Citizen-/LUG-Pfadstatus
|
||||
- begrenzter `sc-launch.log`-Auszug
|
||||
- bereinigte Kopie des LUG-Start-Scripts
|
||||
- Go-Updater-Status (Git/ZIP, Auto-Update, Commit-Stand)
|
||||
- bereinigter Updater-Logauszug
|
||||
|
||||
### Nicht standardmäßig enthalten
|
||||
|
||||
- Browserdaten
|
||||
- SSH-Schlüssel
|
||||
- Passwortdateien
|
||||
- vollständige Star-Citizen-Game.log-Dateien
|
||||
- vollständige EAC-Logs
|
||||
- Dateien aus dem RSI-Account/Browserprofil
|
||||
|
||||
### Automatische Maskierung beim Export
|
||||
|
||||
Das Support-Paket versucht folgende Daten zu maskieren:
|
||||
|
||||
- Home-Pfad
|
||||
- Benutzername
|
||||
- Hostname
|
||||
- E-Mail-Adressen
|
||||
- IPv4-Adressen
|
||||
- MAC-Adressen
|
||||
- Bearer-/JWT-Tokens
|
||||
- typische `token`, `session`, `cookie`, `password`, `secret`-Werte
|
||||
- typische Auth-Queryparameter in URLs
|
||||
|
||||
Die Maskierung ist eine Best-Effort-Funktion. Nutzer können das Archiv vor dem
|
||||
Versenden selbst öffnen und prüfen.
|
||||
|
||||
---
|
||||
|
||||
## 7. Updates
|
||||
|
||||
### Plugin selbst
|
||||
|
||||
0.6.0 enthält ein statisch gebautes Go-Backend. Es erkennt automatisch, ob Omarchy
|
||||
Citizen als Git-Plugin oder aus einem ZIP installiert wurde.
|
||||
|
||||
Bei einer Git-Installation gibt es unter **Erweiterte Optionen → Plugin-Updates**:
|
||||
|
||||
- **Plugin-Update prüfen**
|
||||
- **Plugin jetzt aktualisieren**
|
||||
- **Auto-Updates einschalten/ausschalten**
|
||||
- **Updater-Log öffnen**
|
||||
|
||||
Beim Aktivieren von Auto-Updates wird das aktuelle Git-`origin` als vertrauenswürdige
|
||||
Quelle gespeichert. Ein systemd-User-Timer prüft ungefähr alle sechs Stunden mit einer
|
||||
zufälligen Verzögerung von bis zu 15 Minuten.
|
||||
|
||||
Ein automatisches Update wird verweigert, wenn:
|
||||
|
||||
- das Git-Remote nachträglich geändert wurde
|
||||
- lokale Änderungen im Plugin-Checkout liegen
|
||||
- der lokale Branch vom Upstream abgewichen ist
|
||||
- bereits ein anderes Plugin-Update läuft
|
||||
- Omarchys Plugin-Validierung fehlschlägt
|
||||
|
||||
Das Backend baut keinen eigenen Plugin-Paketmanager. Die eigentliche Aktualisierung läuft
|
||||
über Omarchys offiziellen nicht-interaktiven Weg:
|
||||
|
||||
```bash
|
||||
omarchy plugin update local.omarchy-citizen --yes
|
||||
```
|
||||
|
||||
Dadurch bleiben Fast-Forward-Prüfung, Validierung und Rollback bei Omarchy.
|
||||
|
||||
Bei der aktuellen ZIP-Installation zeigt das Backend bewusst **ZIP / nicht Git-verwaltet**.
|
||||
Es lädt dann nichts aus einer erfundenen oder unbekannten Quelle herunter. Sobald das
|
||||
Projekt als GitHub-/Git-Repository veröffentlicht und mit `omarchy plugin add` installiert
|
||||
wird, erkennt das Backend `origin` automatisch.
|
||||
|
||||
### LUG und Omarchy
|
||||
|
||||
Zusätzlich befinden sich unter **Erweiterte Optionen**:
|
||||
|
||||
- LUG Update prüfen
|
||||
- LUG aktualisieren
|
||||
- Omarchy aktualisieren
|
||||
|
||||
Systempakete werden weiter über den normalen `omarchy update`-Weg aktualisiert.
|
||||
Dadurch bleiben Omarchy-Migrationen und der vorgesehene Update-Ablauf erhalten.
|
||||
|
||||
### Updater-Dateien
|
||||
|
||||
```text
|
||||
~/.config/omarchy-citizen/updater.json
|
||||
~/.local/state/omarchy-citizen/updater.log
|
||||
~/.local/lib/omarchy-citizen/omarchy-citizen-backend
|
||||
```
|
||||
|
||||
Der Updater läuft nicht als dauerhafter Webserver. Der systemd-User-Timer startet ihn nur
|
||||
für die jeweilige Prüfung.
|
||||
|
||||
---
|
||||
|
||||
## 8. NGL
|
||||
|
||||
NGL bleibt unter **Erweiterte Optionen** und ist deutlich als experimentell markiert.
|
||||
|
||||
Der normale Star-Citizen-Betrieb ist nicht von NGL abhängig.
|
||||
|
||||
---
|
||||
|
||||
## 9. Supportablauf für dich als Plugin-Betreuer
|
||||
|
||||
Wenn ein Nutzer ein Problem meldet, kannst du ihn bitten:
|
||||
|
||||
1. **✦SC** öffnen
|
||||
2. **Support-Paket erstellen** klicken
|
||||
3. dir die erzeugte `.tar.gz` schicken
|
||||
4. die angezeigte Support-ID nennen
|
||||
|
||||
Damit brauchst du im ersten Supportkontakt normalerweise keine Terminalbefehle
|
||||
vom Nutzer anzufordern.
|
||||
|
||||
|
||||
## Hotfix 0.6.4 – Setup-Button
|
||||
|
||||
Version 0.6.4 ändert die Ausführung der Panel-Aktionen grundlegend.
|
||||
|
||||
Beim Klick auf **EINRICHTEN & STARTKLAR MACHEN** wird die Aktion nun direkt als
|
||||
Quickshell-Prozess gestartet. Das Panel zeigt sofort **WIRD GESTARTET**.
|
||||
|
||||
Wenn der Start fehlschlägt, bleibt das Panel offen und zeigt den Fehler an.
|
||||
Außerdem wird der fehlgeschlagene Terminalstart in
|
||||
`~/.local/state/omarchy-citizen/omarchy-citizen.log` protokolliert und landet
|
||||
im Support-Paket.
|
||||
|
||||
Nach der Installation wird der Omarchy-Shellprozess einmal neu gestartet, damit
|
||||
die neue QML-Version sicher aktiv ist.
|
||||
|
||||
## 0.6.4 – unvollständiger Wine-Prefix
|
||||
|
||||
Ein Ordner wie `~/Games/star-citizen` gilt jetzt erst dann als fertiger Wine-Prefix,
|
||||
wenn mindestens `drive_c`, `system.reg` und `user.reg` existieren.
|
||||
|
||||
Wenn nur Runner/Teildateien vorhanden sind, zeigt das Plugin **SETUP REPAIR**.
|
||||
|
||||
Bei **SETUP SICHER REPARIEREN** wird der alte Ordner nicht gelöscht. Ohne erkannte
|
||||
`Data.p4k`-Spieldatei wird er nach `star-citizen-incomplete-<Zeitstempel>` umbenannt,
|
||||
die LUG-Zielkonfiguration wird gesichert und der offizielle LUG-Installer startet neu.
|
||||
|
||||
Das Support-Paket enthält jetzt außerdem den neuesten detaillierten
|
||||
`lughelper-install-*.log`, damit Wine-/Winetricks-Fehler analysiert werden können.
|
||||
- Autopilot-Status
|
||||
- verwaltete LUG-/Wine-/DXVK-Versionen
|
||||
- Wine-Selbsttest
|
||||
- Maintenance-Ergebnis
|
||||
- Updater-Log
|
||||
|
||||
Reference in New Issue
Block a user