Gebrauchsanleitung: CodeZipManager

Gebrauchsanleitung: CodeZipManager

Inhaltsverzeichnis

  1. Einleitung & Zweck
    • Was ist der CodeZipManager?
  2. Das Hauptfenster & Globale Steuerung
  3. Tab 1: CodeFile Generator
  4. Tab 2: Ordner Zipper
  5. Profil-Management (Laden & Speichern)

1. Einleitung & Zweck

Der CodeZipManager ist ein spezialisiertes Werkzeug, das zwei Hauptaufgaben erfüllt:

  1. Code-Analyse-Dateien (Dumps) erstellen: Es liest einen gesamten Quellcode-Ordner ein und fasst alle relevanten Textdateien (wie .cs, .xaml, .md etc.) zu einer einzigen, großen .txt-Datei zusammen. Diese Datei ist speziell strukturiert (mit „Bereichen“ und Inhaltsverzeichnissen), um sie ideal für die Analyse durch KIs oder zur Erstellung von technischer Dokumentation zu machen.
  2. Projekt-Archivierung: Es erstellt standardisierte ZIP-Archive des Quellordners zur Sicherung oder Weitergabe.

Das Tool ist in zwei Haupt-Tabs unterteilt, die diese Funktionen abbilden.

2. Das Hauptfenster & Globale Steuerung

Das Hauptfenster dient als Zentrale und bietet globale Funktionen, die beide Tabs beeinflussen.

2.1 Die Kopfleiste

Ganz oben im Fenster findest du globale Werkzeuge:

  • Host Statusanzeige (links): Ein (meist) schreibgeschütztes Feld, das Statusmeldungen der globalen Aktionen anzeigt (z.B. „Profil geladen“).
  • Always on Top: Hält das Fenster immer im Vordergrund. Standardmäßig aktiv .
  • Theme wechseln: Schaltet das Design der Anwendung um (z.B. zwischen dem „LordKaDarkTheme“ und einem Standard-Theme) .
  • Profile laden / speichern: Lädt oder speichert alle Einstellungen beider Tabs (siehe Abschnitt 5).

2.2 Der „Projektstand“ (Geteilte Eigenschaft)

Rechts in der Kopfleiste findest du das Feld „Projektstand“.

  • Dieser Text wird live in beide Tabs übertragen:
    • Im „CodeFile Generator“ setzt er das (schreibgeschützte) Feld „Projektstand“.
    • Im „Ordner Zipper“ setzt er das (schreibgeschützte) Feld „Bezeichner (optional)“.
  • Wichtig: Der hier eingegebene Name wird als Standard-Dateiname für das Speichern von Profilen verwendet.

2.3 Die Master-Aktion: „Datei + Zip erstellen“

Der orangefarbene Haupt-Button führt die Kernfunktionen beider Tabs nacheinander aus:

  1. Zuerst führt er die Aktion „Datei erstellen“ aus dem „CodeFile Generator“-Tab aus.
  2. Danach (sobald die Datei(en) geschrieben wurden) führt er die Aktion „Ordner zippen“ aus dem „Ordner Zipper“-Tab aus.

3. Tab 1: CodeFile Generator

Dieser Tab ist das Herzstück des Programms und erstellt die strukturierten Text-Dumps.

3.1 Zweck

Das Ziel ist die Erstellung einer (oder mehrerer) .txt-Dateien (z.B. PROJEKTFILES+Code-20251025-120000-MeinProjekt_Teil1.txt). Diese Dateien enthalten den gesamten Quellcode, perfekt formatiert für Analysen durch eine KI.

3.2 Schritt-für-Schritt: Eine Projektdatei erstellen

  1. Pfade setzen: Wähle einen „Quellpfad“ (dein Projektordner) und einen „Zielpfad“ (wo die .txt-Datei gespeichert werden soll).
  2. Projekt benennen: Gib im Feld „Projektname“ einen Namen für das Projekt an (z.B. „CodeZipManager-v1“).
  3. (Optional) Filter anpassen: Definiere, welche Dateien ein- oder ausgeschlossen werden sollen (siehe 3.4).
  4. Auslesen: Klicke auf „Auslesen“. Das Programm scannt nun den Quellpfad (gemäß Filtern) und füllt die Dateiliste.
  5. Auswahl prüfen: Standardmäßig sind alle gefundenen Dateien ausgewählt. Du kannst einzelne Dateien in der Liste abwählen.
  6. Erstellen: Klicke auf „Datei erstellen“.
  7. Ergebnis: Das Programm schreibt die Datei(en) in den Zielpfad. Der Fortschritt und das Ergebnis werden im „Info“-Feld unten protokolliert.

3.3 Die Ausgabe: Die „Bereichs“-Struktur

Die erstellte .txt-Datei (implementiert in PAP Phase 2) hat eine spezifische, KI-freundliche Struktur:

  1. Header: // === Projektdaten: [Projektname] ===
  2. Inhaltsverzeichnis (Teil): Eine Liste aller Dateien, die in dieser spezifischen Datei (z.B. _Teil1.txt) enthalten sind, mit Verweis auf ihre Bereichsnummer.
  3. Projektübersicht (Gesamt): Nur in Teil 1: Eine vollständige, nach Ordnern gruppierte Übersicht aller Dateien im Projekt, ebenfalls mit Verweis auf ihre Bereichsnummer.
  4. Inhalt (Bereiche): Die eigentlichen Dateiinhalte, wie folgt strukturiert:Inhalt des Ordners: ViewModels Bereich [1] Datei Anfang - BaseViewModel.cs (ViewModels/BaseViewModel.cs) ----------------------------------- // ... Inhalt von BaseViewModel.cs ... ----------------------------------- Bereich [1] Datei Ende - BaseViewModel.cs Bereich [2] Datei Anfang - MainViewModel.cs (ViewModels/MainViewModel.cs) ...

3.4 Alle Optionen im Detail (Filter & Splitting)

  • Filter (kommagetrennt):
    • Dies ist die „Whitelist“ (Include). Nur Dateinamen, die auf ein Muster passen, werden eingelesen (z.B. *.cs,*.xaml,*.md).
  • Negativ-Filter (kommagetrennt):
    • Dies ist die „Blacklist“ (Exclude). Dateien oder Ordner, die diesem Muster entsprechen, werden ignoriert (z.B. .git,.vs,bin,obj,*.Designer.cs).
  • Split-Optionen:
    • Datei aufteilen (Splitting aktivieren): Wenn diese Option aktiv ist, wird die Ausgabe bei Erreichen eines Limits in mehrere Dateien (_Teil1.txt, G/_Teil2.txt…) aufgeteilt.
    • Nach Zeilenanzahl: Teilt die Datei, wenn das Limit aus der ComboBox (z.B. 3000 Zeilen) erreicht wird.
    • Nach Zeichenanzahl: Teilt die Datei, wenn das Limit aus der TextBox (z.B. 150000 Zeichen) erreicht wird.

4. Tab 2: Ordner Zipper

Dieser Tab erstellt ZIP-Archive des Projektordners.

4.1 Zweck

Erzeugung einer .zip-Datei des Quellordners für Backup, Versionierung oder Weitergabe.

4.2 Schritt-für-Schritt: Ein ZIP-Archiv erstellen

  1. Quellpfad prüfen: Der „Quellpfad“ wird automatisch vom „CodeFile Generator“-Tab übernommen. Du musst ihn hier nicht manuell auswählen (kannst es aber).
  2. Zielpfad wählen: Wähle den „Zielpfad“, in dem das fertige ZIP-Archiv gespeichert werden soll.
  3. (Optional) Debug-Ordner wählen: Wähle einen „Debug-Ordner-Pfad“. Wenn gesetzt, wird eine Kopie des ZIP-Archivs (mit DEBUG_ Präfix) auch dort abgelegt.
  4. Modus wählen: Entscheide dich für „Vollsicherung“ oder „Filter-Sicherung“.
  5. Zippen: Klicke auf „Ordner zippen“.
  6. Ergebnis: Der Status („ZIP erstellt“, „Datei übersprungen“) erscheint in der Label-Anzeige und alle Details werden in der Log-Liste darunter protokolliert.

4.3 Die Automatik: „Auf Änderungen prüfen“

Dies ist die „Wächter“-Funktion des Zippers.

  • Aktivierung: Wenn du die Checkbox „Auf Änderungen prüfen“ aktivierst:
    1. Scannt das Tool sofort alle Dateien im Quellpfad und merkt sich deren Zustand (via MD5-Hash).
    2. Ein Timer startet, der das Intervall des Schiebereglers (1-600 Sekunden) verwendet.
  • Überwachung: Das Tool prüft nun im eingestellten Intervall den Ordner.
  • Aktion: Sobald eine Datei geändert, hinzugefügt oder gelöscht wird, erkennt das Tool die geänderten Hashes und startet automatisch einen neuen Zip-Vorgang („AUTO“).

Wichtiger Hinweis zu Filtern: Die Auto-Check-Funktion respektiert den unter 4.4 beschriebenen „Sicherungsmodus“. Wenn „Filter-Sicherung“ aktiv ist, werden auch nur Änderungen an den gefilterten Dateien einen Auto-Zip auslösen.

4.4 Alle Optionen im Detail (Modus & Debug)

  • Debug löschen: Dieser Button löscht den Inhalt des Ordners, der im Feld „Debug-Ordner-Pfad“ angegeben ist (und leert danach das Feld).
  • Sicherungsmodus:
    • Vollsicherung: Zippt alle Dateien im Quellordner.
    • Filter-Sicherung: Zippt nur die Dateien, die den Endungen im Feld „Dateiendungen (z.B. .cs,.txt)“ entsprechen.

5. Profil-Management (Laden & Speichern)

Mit den globalen Buttons in der Kopfleiste kannst du alle Einstellungen der Anwendung sichern.

  • Profil speichern:
    1. Öffnet einen „Speichern unter…“-Dialog.
    2. Schlägt automatisch den Namen aus dem Feld „Projektstand“ als Dateinamen vor (z.B. MeinProjekt-v1.0.json).
    3. Speichert alle Einstellungen aus beiden Tabs (alle Pfade, Filter, Split-Optionen, Checkbox-Status, Intervall) in dieser einen JSON-Datei.
  • Profile laden:
    1. Öffnet einen „Öffnen…“-Dialog, um eine .json-Profildatei auszuwählen.
    2. Lädt alle Einstellungen aus der Datei und füllt automatisch alle Felder in beiden Tabs wieder aus.
    3. Der „Projektstand“ wird ebenfalls wiederhergestellt.
    4. Die Pfad-Verknüpfung (Generator zu Zipper) wird ebenfalls aktualisiert.
Translate »
Nach oben scrollen