WizTree Datenträgerbereinigung

Was macht WizTree Datenträgerbereinigung?

Nutzen Sie WizTree als Quelle für Datenträger-Nutzungsfakten und halten Sie Analyse, Genehmigung, Ausführung und Überprüfung getrennt. Passen Sie Berichte an die Sprache des Benutzers an.

Nicht verhandelbare Sicherheitsschranken

• Standardmäßig nur analysieren. Nehmen Sie beim Importieren oder Überprüfen von CSV-Daten keine Änderungen an der Festplatte vor.
• Behandeln Sie Stufe 1 als risikoarm, aber nicht genehmigungsfrei. Fordern Sie vor jeder Löschung eine explizite Benutzerfreigabe an.
• Leiten Sie nie eine Genehmigung aus einer allgemeinen Anfrage wie "Bereinige meine Festplatte" ab. Zeigen Sie zuerst genaue Ziele und Aktionen an.
• Führen Sie nie Löschbefehle aus, die aus Modellprosa kopiert wurden. Erstellen Sie einen Plan mit scripts/New-CleanupPlan.ps1, zeigen Sie dessen plan_id an und führen Sie ihn erst aus, nachdem der Benutzer genau diesen Plan bestätigt hat.
• Lehnen Sie Wildcards, relative Pfade, Laufwerkswurzeln, breite Benutzerprofilwurzeln, Systemverzeichnisse, Programmverzeichnisse und Ziele der Stufe 3 ab.
• Bereinigen Sie keinen Live-Rechner mit einem CSV, das auf einem anderen Rechner exportiert wurde. Analysieren Sie nur, wenn die Existenz lokaler Pfade und der Maschinenkontext geklärt sind.
• Laden Sie WizTree nicht ohne Aufforderung des Benutzers herunter oder installieren Sie es. Verteilen Sie die ausführbare WizTree-Datei nicht mit diesem Skill.
• Verwenden Sie durchgängig native PowerShell-Dateioperationen. Validieren Sie kanonische Ziele unmittelbar vor der rekursiven Löschung erneut.

Lesen Sie references/safety-policy.md, bevor Sie Ziele klassifizieren oder genehmigen. Lesen Sie references/wiztree-csv.md beim Exportieren oder Analysieren von WizTree-Daten.

Arbeitsablauf

1. Ein aktuelles CSV beschaffen

Bevorzugen Sie ein CSV, das vom aktuellen Rechner und aktuellen Datenträgerzustand exportiert wurde.

• Wenn der Benutzer bereits einen Export hat, erfassen Sie den absoluten Pfad und den Zeitstempel.
• Wenn WizTree installiert ist und der Benutzer Automatisierung wünscht, führen Sie scripts/Export-WizTree.ps1 aus.
• Andernfalls weisen Sie den Benutzer an, das Ziellaufwerk in WizTree zu scannen und den offiziellen CSV-Export zu verwenden.

Verwenden Sie keine Screenshots als maßgebliches Inventar, wenn ein CSV-Export verfügbar ist.

2. Den ersten Bericht erstellen

Führen Sie aus:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Analyze-WizTreeCsv.ps1 `
  -CsvPath <absoluter-csv-pfad> `
  -OutputDirectory <absolutes-berichtsverzeichnis>

Verwenden Sie das generierte JSON als maschinenlesbaren Nachweis und den Markdown-Bericht als benutzerorientierte Aufzeichnung. Kopieren Sie die Struktur in assets/cleanup-report-template.md, falls zusätzlicher Text erforderlich ist.

Überprüfen Sie diese Punkte, bevor Sie eine Bereinigung empfehlen:

• Zählen Sie die belegten Bytes aus den Dateizeilen; summieren Sie keine verschachtelten Ordnersummen.
• Behandeln Sie Hardlink-belegte Werte mit dem führenden Null-Marker von WizTree als null zusätzliche Belegung.
• Unterscheiden Sie einen Cache von benutzererstellten Inhalten, die lediglich unter einem Cache-ähnlichen Namen gespeichert sind.
• Markieren Sie Unsicherheiten explizit. Verschieben Sie ein Element in eine höhere Risikostufe, wenn die Beweislage unvollständig ist.

3. Stufe 2 untersuchen

Überprüfen Sie jedes relevante Kandidaten der Stufe 2, bevor Sie es präsentieren. Prüfen Sie, falls verfügbar:

• die zugehörige Anwendung oder Windows-Komponente;
• ob die Anwendung oder der Dienst derzeit ausgeführt wird;
• Aktualität der Änderungen und ob Dateien aktiv geändert werden;
• ob die Anwendung einen eigenen Bereinigungsbefehl bereitstellt;
• Wiederherstellungskosten, Auswirkungen auf die Anmeldung, Auswirkungen im Offline-Modus sowie Wiederherstellungsoptionen;
• genauen Pfad, vorgeschlagene Aktion, geschätzte Bytes und erwartete Nebenwirkungen.

Bevorzugen Sie anwendungseigene Bereinigung, Windows-Speichereinstellungen, Datenträgerbereinigung, Paketmanager-Cache-Befehle oder dokumentierte dienstbewusste Verfahren gegenüber einer direkten Löschung.

4. Einzelposten-Genehmigung einholen

Präsentieren Sie zuerst Stufe 1. Fügen Sie für jeden auswählbaren Posten Folgendes hinzu:

• genauen Pfad;
• Aktion: clear_directory_contents oder delete_file;
• Stufe und Grund;
• geschätzte freigebbaren Bytes;
• bemerkenswerte Nebenwirkungen.

Erstellen Sie ein Genehmigungsmanifest aus assets/approval-manifest.example.json. Fügen Sie nur die Elemente hinzu, die der Benutzer explizit ausgewählt hat, und setzen Sie approved auf true.

5. Planvorschau und Bindung

Führen Sie aus:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/New-CleanupPlan.ps1 `
  -ApprovalFile <genehmigungs-json> `
  -PlanFile <plan-json>

Zeigen Sie die validierten Elemente, die geschätzte Gesamtsumme, abgelehnte Elemente und die plan_id an. Stoppen Sie, wenn ein Ziel breiter ist als die Auswahl des Benutzers oder vom Bericht abweicht.

6. Nur den bestätigten Plan ausführen

Nachdem der Benutzer die angezeigte plan_id bestätigt hat, führen Sie aus:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/Invoke-ApprovedCleanup.ps1 `
  -PlanFile <plan-json> `
  -ConfirmPlanId <bestätigte-plan-id> `
  -Execute

Ohne -Execute bleibt das Skript ein Probelauf. Fügen Sie -Execute nie hinzu, bevor die genaue Planbestätigung im Gespräch sichtbar ist.

7. Überprüfen und Bericht aktualisieren

• Notieren Sie Erfolge, Übersprungenes, Fehler und den Prüfprotokollpfad.
• Notieren Sie geschätzte Löschbytes und beobachtete Speicherplatzänderung getrennt; Hintergrundaktivitäten können zu Abweichungen führen.
• Exportieren Sie WizTree erneut oder führen Sie einen erneuten Scan durch, wenn praktikabel.
• Aktualisieren Sie den Ausführungsverlauf des Markdown-Berichts und die verbleibenden Stufe-2-Optionen.
• Wiederholen Sie den Genehmigungszyklus für Stufe 2. Befördern Sie Stufe 3 nie in einen ausführbaren Plan.

Ressourcenübersicht

• scripts/Export-WizTree.ps1: Führt den offiziellen WizTree-CSV-Export aus.
• scripts/Analyze-WizTreeCsv.ps1: Streamt den Export und generiert JSON sowie Markdown.
• scripts/New-CleanupPlan.ps1: Validiert ausgewählte Ziele und erstellt einen integritätsgesicherten Plan.
• scripts/Invoke-ApprovedCleanup.ps1: Validiert erneut und führt den bestätigten Plan mit JSONL-Prüfprotokollierung aus.
• references/safety-policy.md: Klassifizierungs- und Löschgrenzen.
• references/wiztree-csv.md: Offizielle Exportsemantik und Erwartungen an den Parser.
• assets/cleanup-report-template.md: Berichtsstruktur.
• assets/approval-manifest.example.json: Genehmigungseingabeschema.