Skip to content

Latest commit

 

History

History
338 lines (259 loc) · 18.6 KB

File metadata and controls

338 lines (259 loc) · 18.6 KB

DevCenter Banner

DevCenter

Lokale Desktop-Entwicklungsumgebung und Entwickler-Zentrale für Windows, Linux und macOS. DevCenter vereint einen PySide6-Code-Editor, statische AST-Code-Analyse, PyInstaller-EXE-Kompilierung, Icon-Konvertierung, Lizenz-Sammlung, Volltext-SQLite-Dateisuche und einen optionalen Claude/Anthropic AI-Assistenten in einer kohärenten Desktop-Suite.

English | Deutsch

Version Python Lizenz: GPL v3 Plattform UI: PySide6 Datenschutz: 100% Offline Sicherheit: Lokaler Keyring Sicherheits-SLA: 48h / 5d Triage Drittanbieter: Geprüft Tests: 199 Bestanden Marketing Log LLM Context Ökosystem: dev-bricks Dachverband: open-bricks

Note

Für KI-Agenten & LLM-Tools: Dieses Repository stellt mit llms.txt einen maschinenlesbaren Index für automatisierte Erkennung, Funktionsübersichten und CLI-Schnittstellen bereit.

Nicht identisch mit Azure DevCenter, Microsoft Dev Box, Moderne DevCenter oder Devbox. Dies ist dev-bricks/DevCenter — eine quelloffene Python Desktop-Suite.


Schnelleinstieg & Navigation

  1. Schnelleinstieg & Produktgrenze
  2. Systemarchitektur
  3. Datenfluss & Datenschutz-Isolation (Zero-Egress)
  4. Governance & Laufzeit-Invarianten
  5. Warum DevCenter
  6. Schnellstart
  7. Funktionen & Fähigkeiten
  8. Tastenkombinationen
  9. Geschwister-Tools & Ökosystem-Matrix
  10. Drittanbieter-Lizenzen & Transparenz
  11. Marketing & Zielgruppen
  12. Installation & Testausführung
  13. Datenschutz & Sicherheit
  14. Mitwirken & Entwicklung
  15. Lizenz & Haftung

Schnelleinstieg

Anforderung Werkzeug / Aktion Oberfläche / Befehl
Lokale Python-IDE Code-Editor, Syntax-Highlighting, AST-Analyse, Build-Assistent python main.py
Ein-Klick EXE-Kompilierung PyInstaller-Build-Assistent (One-File / One-Directory) build_exe.bat / Build-Reiter
Statische Code-Analyse Methoden, Klassen, Komplexität, ungenutzte Imports, TODOs Analyse-Reiter
Encoding-Diagnostik & Reparatur BOM-/Mojibake-Erkennung, automatische UTF-8-Bereinigung Analyse → Encoding-Reiter
Volltext-Dateisuche SQLite FTS5-Suche, Duplikaterkennung, Backup-Sync FileManager-Reiter
Redigierter Workspace-Export Bereinigter Projekt-Metadaten-Export für Handoff Datei → Workspace exportieren
Windows Schnellstarter Direkter Desktop-Start über Skript START_DevCenter.bat

Produktgrenze

Die PySide6 Desktop-Anwendung ist das einzige ausgelieferte Produkt und die maßgebliche Runtime. devcenter-workspace-v1.json ist ein redigierter lokaler Export für Archivierung oder explizite Übergabe; das Repository enthält keinen Web-/PWA-Begleiter oder gehosteten Importer. Siehe DOCUMENTATION_STATUS.md für die Dokumentenhierarchie.

DevCenter Hauptfenster mit lokaler Python-IDE Übersicht


Systemarchitektur

graph TB
    subgraph UI ["PySide6 Desktop-Anwendung (Hauptfenster)"]
        TOP["Menüleiste & Symbolleisten<br/>• Datei • Bearbeiten • Ansicht • Analyse • Build • Extras • Hilfe"]
        STATUS["Statusleiste & Live-Diagnostik"]
    end

    subgraph MODULES ["Kern-Engine Module"]
        EDITOR["Editor-Modul<br/>• PythonSyntaxHighlighter<br/>• Indent-Folding & Auto-Indent<br/>• Nicht-modale Suche & Ersetzen"]
        ANALYZER["Statische Analyse<br/>• AST Klassen- & Methoden-Parser<br/>• Zyklomatische Komplexität<br/>• Prüfung ungenutzter Imports<br/>• EncodingFixer"]
        BUILDER["Builder-Modul<br/>• PyInstaller-Pipeline<br/>• IconConverter (PNG/JPG zu ICO)<br/>• Lizenz-Kollektor"]
        FILEMGR["FileManager-Modul<br/>• SQLite FTS5 Datei-Index<br/>• Hash-basierte Duplikatsuche<br/>• ProSync Backup-Engine"]
        AI["AI-Assistent (Opt-in)<br/>• Claude / Anthropic API<br/>• Windows Keyring Tresor<br/>• Code-Erklärer & Reviewer"]
    end

    subgraph STORAGE ["Lokaler Speicher & Artefakte"]
        FS[("Lokales Dateisystem<br/>• Projektbäume & Python-Dateien")]
        DB[("Lokale SQLite-Datenbank<br/>• %APPDATA%/DevCenter/index.db")]
        KEYRING[("Windows Anmeldeinformationsverwaltung<br/>• System Keyring Tresor")]
        DIST[("Build-Artefakte<br/>• dist/DevCenter.exe<br/>• devcenter-workspace-v1.json")]
    end

    UI --> MODULES
    EDITOR --> FS
    ANALYZER --> FS
    BUILDER --> FS
    BUILDER --> DIST
    FILEMGR --> FS
    FILEMGR --> DB
    AI --> KEYRING
    STATUS --> MODULES
Loading

Datenfluss & Datenschutz-Isolation (Zero-Egress)

sequenceDiagram
    autonumber
    actor Dev as Entwickler / Nutzer
    participant App as DevCenter UI (PySide6)
    participant Core as AST- & Analyse-Engine
    participant Sec as Keyring Sicherheitswächter
    participant Disk as Lokales Dateisystem / SQLite
    participant Dist as Build- & Export-Pipeline
    participant Ext as Anthropic API (Opt-in)

    Dev->>App: Python-Projekt / Datei öffnen
    App->>Disk: Lokale Dateien in Speicher laden
    Disk-->>App: Quelltext-Puffer (UTF-8)

    Dev->>App: Statische Analyse & AST-Metriken starten
    App->>Core: Klassen, Methoden, Imports & Komplexität analysieren
    Core-->>App: Speicherinterne Diagnostik (0 Netzwerkaufrufe)

    opt Ein-Klick EXE Kompilierung
        Dev->>App: Projekt zu EXE kompilieren
        App->>Dist: Lokalen PyInstaller mit validierten Pfaden aufrufen
        Dist->>Disk: dist/Executable & Lizenzhinweise erzeugen
    end

    opt Redigierter Workspace-Export
        Dev->>App: Workspace-Snapshot exportieren
        App->>Dist: Pfade bereinigen, Tokens entfernen & devcenter-workspace-v1.json formatieren
        Dist->>Disk: Redigierte JSON speichern (0 Netzwerk-Egress)
    end

    opt Optionale KI-Unterstützung (Claude)
        Dev->>App: Prompt senden / Code-Review anfordern
        App->>Sec: API-Schlüssel aus Windows Keyring anfragen
        Sec-->>App: Entschlüsselter Schlüssel im Speicher (nie in JSON geschrieben)
        App->>Ext: Sicherer HTTPS-API-Aufruf (nur bei expliziter Nutzeraktion)
        Ext-->>App: Code-Vorschlag / Refactoring-Antwort
    end

    App-->>Dev: Ergebnisse, Metriken & fertiges Executable anzeigen
Loading

Governance & Laufzeit-Invarianten

DevCenter garantiert 10 verbindliche Architektur-, Sicherheits- und Lieferketten-Invarianten:

Invarianten-ID Name Operativer Bereich Garantie & Überprüfung
INV-LOCAL-01 Zero-Egress Standard Netzwerk & Telemetrie 100% Offline-Betrieb als Standard; keine Telemetrie, keine Nutzungsdaten, keine Hintergrundaufrufe.
INV-OPTIN-02 Opt-In KI-Grenze Externe KI-Dienste Claude/Anthropic API-Aufrufe erfolgen ausschließlich nach expliziter Nutzeraktion; kein stiller Datenabfluss.
INV-KEYRING-03 Keyring Secret Vault Credential-Speicherung API-Schlüssel werden ausschließlich im nativen OS-Tresor (Windows Credential Manager) verschlüsselt gespeichert.
INV-EXPORT-04 Redigierter Workspace-Export Serialisierung devcenter-workspace-v1.json bereinigt Tokens, Passwörter und absolute Pfade; sichere Weitergabe an Teams.
INV-STATIC-05 Inerte AST-Analyse Code-Analyse Statische Analysen prüfen Syntaxbäume und AST-Tokens inert, ohne fremden Benutzercode auszuführen.
INV-SECURITY-06 Vulnerability Floors Lieferkettensicherheit Erzwingt strikte Mindestversionen (Pillow >=12.3.0, keyring >=25.0.0, pytest >=9.1.1) gegen bekannte CVEs.
INV-PERM-07 100% Permissiv / Trennung Lizenzierung GPLv3-Suite mit dynamischer LGPL-Qt-Bindung und PyInstaller-Ausnahme; erstellte Benutzer-EXEs bleiben lizenzfrei.
INV-USER-08 Unprivilegiertes RunAsInvoker Betriebssystemsicherheit DevCenter läuft vollständig im Standard-Benutzerkontext; keine Administratorrechte, Treiber oder UAC-Prompts nötig.
INV-MULTI-09 Multi-Host Sync-Disziplin Repository-Hygiene Git-Repositories folgen strikt Plan D; .gitignore blockiert Cloud-Sync-Konflikte, Locks und temporäre Caches.
INV-SLA-10 48h / 5d Sicherheits-SLA Schwachstellenmeldung Verbindliche Sicherheitskanäle mit garantierter Erstreaktion innerhalb 48 Stunden und 5 Tagen Triage.

Warum DevCenter

  • Lokaler Arbeitsablauf: Projekte, Indizes, Konfigurationen und Build-Artefakte verbleiben standardmäßig auf Ihrem Rechner.
  • Python-Desktop-Fokus: PySide6-Oberfläche, Syntax-Highlighting, Projekt-Explorer, Terminalausgabe und persistente Einstellungen.
  • Integrierte statische Analyse: Erkennung von Methoden/Klassen, Komplexitätsprüfung, Importanalyse, TODO/FIXME-Suche und Encoding-Reparatur.
  • Build- und Release-Assistenten: PyInstaller-Wrapper, Icon-Konvertierung, Drittanbieter-Lizenzsammlung, Release-Notizen und Exportplanung.
  • Optionaler AI-Assistent: Claude/Anthropic-Integration ist opt-in und nutzt lokale Konfigurationen, Keyring oder Umgebungsvariablen.
  • Redigierter Workspace-Export: Erzeugt ein bereinigtes devcenter-workspace-v1.json (siehe EXPORTFORMAT.md).

Schnellstart

git clone https://github.com/dev-bricks/DevCenter.git
cd DevCenter
pip install -r requirements.txt
python main.py

Windows-Startskripte:

START_DevCenter.bat
build_exe.bat

Funktionen

Editor

  • Python-Syntax-Highlighting, Zeilennummern, Auto-Indent, Multi-Tab-Oberfläche.
  • Kommentar-Umschaltung (Strg+/), Drag-and-Drop Dateiladen.
  • Code-Faltung für eingerückte Codeblöcke (Strg+Alt+[ / Strg+Alt+] / Strg+Alt+0).
  • Nicht-modale Suche und Ersetzen mit Treffernavigation, Groß-/Kleinschreibung, ganzen Wörtern und Regex (Strg+F).

Statische Analyse

  • AST-basierte Erkennung von Methoden und Klassen.
  • Berechnung der zyklomatischen Komplexität und Prüfung ungenutzter Imports.
  • TODO/FIXME-Finder, Kodierungsvalidierung und automatische UTF-8-Reparatur (ftfy).

Build-System

  • Ein-Klick EXE-Kompilierung via PyInstaller (One-File / One-Directory Modi).
  • ICO-Konverter (PNG/JPG zu Multi-Resolution Windows ICO).
  • Drittanbieter-Lizenz-Kollektor für rechtssichere Distributionen.

AI-Assistent (Opt-in)

  • Claude/Anthropic API-Integration mit sicherer Windows Keyring-Speicherung.
  • Code-Generierung, Code-Review, Erklärung und interaktive Refactoring-Schleife.

Dateiverwaltung

  • SQLite-Dateiindex mit Volltextsuche (FTS5).
  • Hash-basierte Erkennung doppelter Dateien.
  • Intelligente Backup-Synchronisation mit automatischen SQLite WAL-Checkpoints.

Tastenkombinationen

Tastenkürzel Aktion
Strg+N Neue Datei
Strg+O Datei öffnen
Strg+S Datei speichern
Strg+Umschalt+N Neues Projekt
Strg+Umschalt+O Projekt öffnen
F5 Aktives Python-Skript ausführen
F6 EXE über PyInstaller kompilieren
Strg+/ Kommentar umschalten
Strg+F Suchen & Ersetzen öffnen
Strg+Alt+[ Aktuellen Codeblock falten
Strg+Alt+] Aktuellen Codeblock entfalten
Strg+Alt+0 Alle Codeblöcke entfalten
Strg+Umschalt+A AI-Assistent umschalten
Strg+, Einstellungen öffnen

Geschwister-Tools & Ökosystem-Matrix

DevCenter ist das Flaggschiff für Python-Desktop-Entwicklung im dev-bricks Ökosystem unter dem open-bricks Dachverband:

Ökosystem Tool Primärer Zweck Benutzeroberfläche
dev-bricks DevCenter Lokale Python-IDE, statische Analyse & PyInstaller-Build-Suite PySide6 / Windows GUI
dev-bricks MethodenAnalyser Eigenständiger AST-Methodenanalysator, Komplexitätsprüfer & Fixer Tkinter / CLI
dev-bricks CodeBox Schneller Desktop-Code-Betrachter und Editor mit Syntax-Highlighting PySide6 GUI
dev-bricks pythonbox Schlanke interaktive Python-IDE mit PDB-Debugger PySide6 GUI
dev-bricks safe-start-for-codex Preflight-Validierung & sicherer Bootloader für Codex Python CLI
dev-bricks automizer-for-claude-desktop Automationsbrücke und Startumgebung für Claude Desktop Python GUI
dev-bricks automation-master Flottenweite Automationsorchestrierung & Task-Scheduler Python Core
ellmos-ai ellmos-core Multi-Agenten-Koordinationskern, MCP-Brücken & Task-Runner Python Core
ellmos-ai clutch Subprozess-Management & PTY-Terminalbrücke Python CLI
ellmos-ai coma Multi-Host Konfliktlösung & verteilte Zustandssynchronisation Python CLI
ellmos-ai swarm-ai Verteilte Agentenschwarm-Koordination & Konsens-Engine Python Core
ellmos-ai ellmos-controlcenter-mcp MCP-Flottenverwaltung, Bundle-Auflösung & Zugriffskontrolle MCP Server
file-bricks ProFiler Multi-Tab lokaler Desktop-Dateimanager und Duplikatbereiniger PySide6 GUI
file-bricks ExplorerPro Hochleistungs-Windows-Explorer-Erweiterung & Datei-Indexierung PySide6 GUI
file-bricks ProSync SQLite-bewusste Backup-Engine & Multi-Ziel-Synchronisation PySide6 GUI
doc-bricks DokuZen Markdown-Dokumentenmanager, PDF-Konverter & Suchmaschine PySide6 GUI
doc-bricks PDFtoPDFocr Lokaler OCR-Textebenen-Injektor für gescannte PDF-Dokumente PySide6 / CLI
open-bricks open-bricks Dachverband für lokale, privatsphäreschützende Software Open Source

Drittanbieter-Lizenzen & Transparenz

DevCenter führt ein lückenloses Software-Inventar (SBOM) und eine Lizenztransparenzprüfung:

  • Detaillierte Übersicht aller 20 direkten, transitiven, Build- und Test-Pakete: THIRD_PARTY_LICENSES.md.
  • Maschinenlesbare Lizenzzuordnung: THIRD_PARTY_LICENSES.txt.
  • Alle Pakete sind unter permissiven Lizenzen (MIT, Apache-2.0, BSD-3-Clause, BSD-2-Clause, HPND-sell-variant) oder Standard-Copyleft mit Linking-/Bootloader-Ausnahme auditiert.

Marketing & Zielgruppen

Für ausführliche Zielgruppenprofile, High-Intent-Suchbegriffe, die Wettbewerbsmatrix gegenüber VS Code und PyCharm sowie die Ökosystem-Synergien siehe MARKETING-LOG.txt.

Haupt-Zielgruppen:

  1. Windows Python Desktop-Entwickler & GUI-Builder: Benötigen nahtlose PyInstaller-Paketierung, ICO-Generierung und automatische Encoding-Reparatur.
  2. Solo-Maintainer & Local-First-Ingenieure: Schätzen sofortigen Start, reaktive PySide6-Bedienung und null Hintergrund-Telemetrie.
  3. Sicherheitsbewusste Unternehmens- & Offline-Entwickler: Verlangen strikten Zero-Egress, unprivilegierten Betrieb und geprüfte Sicherheitsuntergrenzen.
  4. KI-unterstützte Python Prompt-Engineers: Profitieren von redigierten Workspace-Snapshots und nativer Keyring-Geheimnis-Isolation.

Installation & Testausführung

Voraussetzungen: Python 3.11+, Windows 10/11 (primäre Laufzeitumgebung; lauffähig auch unter Linux und macOS).

# Repository klonen & Abhängigkeiten installieren
git clone https://github.com/dev-bricks/DevCenter.git
cd DevCenter
pip install -r requirements.txt

# Automatisierte Testsuite ausführen
python -m pytest

Datenschutz & Sicherheit

DevCenter ist eine lokale Desktop-Anwendung. Projekte, Konfigurationen, Dateiindizes und Build-Ergebnisse verbleiben standardmäßig auf Ihrem Computer. Netzwerkzugriffe erfolgen ausschließlich dann, wenn sie vom Nutzer ausdrücklich angestoßen wurden (wie z. B. die optionale Claude-API).

Anthropic API-Schlüssel werden ausschließlich im nativen Betriebssystem-Schlüsselspeicher (Windows Credential Manager) hinterlegt und niemals unverschlüsselt auf Datenträgern gespeichert.

Vollständige Details unter SECURITY.md und PRIVACY_POLICY.md.


Mitwirken

Beiträge sind herzlich willkommen! Bitte beachten Sie folgende Richtlinien:

  • Lesen Sie CONTRIBUTING.md für Code-Standards und Commit-Konventionen.
  • Beachten Sie den CODE_OF_CONDUCT.md.
  • Führen Sie vor Pull-Requests ruff check . und pytest aus.

Lizenz & Haftung

  • Lizenz: GPL v3 — siehe LICENSE. PySide6 steht unter LGPL v3.
  • Haftungsausschluss: Dieses Projekt ist eine unentgeltliche Open-Source-Schenkung. Die Haftung ist auf Vorsatz und grobe Fahrlässigkeit beschränkt (§ 521 BGB). Die Nutzung erfolgt auf eigenes Risiko.