Deine Automatisierung. Dieselbe native Engine.

Mit der installierten App beginnen

Diese Anleitung gilt für Mac. DiskPress for Files für iPhone und iPad hat keine CLI oder laufende Ordnerüberwachung. Zur Automatisierung dort siehe Apple-Kurzbefehle und ihre iOS-Anforderungen.

Mac App Store und Setapp bieten dieselben CLI-Funktionen. Download auswählen. Die CLI ist die ausführbare Datei im App-Bundle, kein separater Download. Die Beispiele verwenden die Mac-App-Store-Kopie unter /Applications/DiskPress.app. Passe den Pfad an, wenn deine Kopie woanders liegt.

"/Applications/DiskPress.app/Contents/MacOS/DiskPress" --help

Bei Setapp nutze die ausführbare Datei deiner Setapp-Installation. Bundle-Name und Ort können abweichen. Beide Editionen speichern Einstellungen und Freigaben getrennt. Konfiguriere die tatsächlich aufgerufene Edition. Ihr eingebautes --help zeigt Beispiele mit dem eigenen Programmpfad.

1. Öffne diese DiskPress-Kopie und gehe zu Einstellungen, dann Autorisierte Pfade.
2. Füge die konkreten Dateien oder Ordner hinzu, die der Befehl lesen und schreiben darf. Bei komprimierten Dateien autorisiere den übergeordneten Ordner.
3. Prüfe die Auswahl mit scan, bevor du optimize wählst.

Befehle

Setze diese Befehle hinter den Programmpfad. Nur scan und optimize akzeptieren Zielpfade, höchstens 500 pro Anfrage.

paths meint Berechtigungen, locations gespeicherte Optimierungsziele. Sie sind nicht austauschbar. Konfiguration und neue Freigaben erfolgen weiterhin in den App-Einstellungen.

Optionen

--json und --quiet gelten für alle acht Befehle. Berichtsbefehle nehmen weder Zielpfade noch --gui oder --ignore-exclusions an.

Was während der Optimierung passiert

Die erste Duplikatprüfung kann länger dauern

Wenn Einstellungen und Ortsmodi beide Verfahren erlauben, kombiniert DiskPress sie in einem Lauf. Die erste Duplikatprüfung großer Ordner kann lange dauern, auch bei bereits komprimierten Dateien. Spätere Läufe nutzen zwischengespeicherte Fingerprints unveränderter Dateien, auch nach einem Neustart. Vor dem Ersetzen werden Inhalt und Metadaten weiterhin geprüft.

DiskPress verwendet Scanergebnisse innerhalb einer Optimierung erneut und kann sich unveränderte Dateien ohne Kompressionsgewinn merken. Ein ausgelassener weiterer Kompressionsversuch schließt diese Dateien nicht von der Duplikatprüfung aus.

Ortsmodi gelten auch für CLI-Ziele

Wähle den Modus in der Orte-Tabelle der App. Die CLI beachtet ihn auch bei einzeln übergebenen Dateien oder mit --ignore-exclusions.

• Komprimieren + Deduplizieren erlaubt beide Verfahren gemeinsam.
• Nur komprimieren erlaubt Kompression, keine Deduplizierung.
• Nur deduplizieren erlaubt Deduplizierung, keine Kompression.
• Deaktiviert sperrt beide Vorgänge für passende Dateien.

Der spezifischste passende Ort hat Vorrang. Eine gespeicherte Datei überschreibt ihren Ordner, ein Unterordner seinen Elternordner, auch einen deaktivierten. Eine nichtrekursive Regel gilt nur für den Ordner und direkte Kinder. Außerhalb gespeicherter Orte gelten allgemeine Einstellungen und Sicherheitsprüfungen.

Deduplizierung erfordert einen passenden Ortsmodus und die globale Einstellung. Deaktiviere dafür global "Identische Dateien deduplizieren". Das aktiviert keine Kompression für Nur deduplizieren oder Deaktiviert. Es gibt weder einen Nur-Kompression-Schalter pro Befehl noch einen CLI-Befehl zum Ändern der Modi. Die erstmalige Deduplizierungsbestätigung erscheint in der CLI auch mit --gui nicht.

locations --json meldet enabled, enthält derzeit aber keinen Optimierungsmodus je Ort. settings.deduplicationEnabled ist der globale Schalter, kein Ortsmodus. Prüfe erlaubte Vorgänge in der Orte-Tabelle.

Schutz neuer Dateien verzögert keine CLI-Anfragen

Der Schutz kürzlich geänderter Dateien verzögert diese bei gespeicherten Orten, auch bei Überwachung und Jetzt optimieren. CLI-scan und optimize sind ausdrückliche einmalige Anfragen ohne diese Verzögerung, mit oder ohne --gui. Das gilt auch bei gespeicherten Zielorten.

recentFileProtectionSeconds beschreibt die Verzögerung gespeicherter Orte, keine CLI-Wartezeit. Plane Befehle nach Ende der Schreibarbeit des erzeugenden Programms. Erkennung aktiver Schreiber, Änderungsprüfungen und Verifikation gelten weiterhin.

Verknüpfte Apps schützen weiterhin ihre Orte

Ist eine App verknüpft, werden Dateien des Ortes übersprungen, solange sie läuft. Auch einzeln per CLI benannte Dateien sind geschützt. --ignore-exclusions umgeht dies nicht. Beende die verknüpfte App zuerst.

locations --json enthält linkedApplication mit bundleIdentifier, path und name, sonst null. Das beschreibt die gespeicherte Verknüpfung, nicht den Live-Status der App. Ein vorläufiger scan garantiert keine bestandenen Prüfungen während der Optimierung. Siehe FAQ zu verknüpften Apps.

Nützliche Beispiele

Speichere den Programmpfad zur Bequemlichkeit in einer Variable dieser Terminal-Sitzung. Das installiert keinen Befehl und ändert keine Shell-Konfiguration.

DISKPRESS="/Applications/DiskPress.app/Contents/MacOS/DiskPress"

Berechtigungen und Einstellungen prüfen

"$DISKPRESS" --version
"$DISKPRESS" paths --json
"$DISKPRESS" settings --json
"$DISKPRESS" locations --json

Scannen ohne Optimierung

Die Beispiele nutzen einen Ordner mit fertigen Daten. Ersetze den Pfad durch einen konkreten, weitgehend stabilen Ordner und autorisiere ihn zuerst. Ein Scan sagt keine endgültige Kompressionsrate voraus. Manche Kompatibilitätsprüfungen erfolgen erst bei der Optimierung.

"$DISKPRESS" scan --json -- "$HOME/Documents/Completed Data"

Einmalige Optimierung ausführen

Das ändert die Speicherung unterstützter Dateien und kann zusätzliche Schreibzugriffe erzeugen. Vermeide wiederholte Optimierung häufig wechselnder Orte. Lies vor geplanten Befehlen die SSD-Schreibhinweise.

"$DISKPRESS" optimize --json --quiet -- "$HOME/Documents/Completed Data"

Fortschritt bei Bedarf anzeigen

"$DISKPRESS" optimize --gui -- "$HOME/Documents/Completed Data"

Ergebnisse lesen

"$DISKPRESS" overview --json
"$DISKPRESS" savings --json
"$DISKPRESS" activity --limit 20 --json

Das Befehlsergebnis beschreibt den fertigen Auftrag. Ortssummen können noch aktualisiert werden. Prüfe savings.refreshing und Messdaten, bevor du sie als aktuell behandelst.

Ausgabe verstehen

Lesbarer Fortschritt geht an Standardfehler, die Endzusammenfassung an Standardausgabe. Mit --json enthält Standardausgabe einzelne JSON-Objekte, eines pro Zeile. Parse sie als NDJSON, nicht als ein großes JSON-Dokument.

• Ereignisse enthalten schemaVersion, requestID, sequence und event. Aktuelle Schemaversion ist 1.
• Ereignistypen sind progress, result und error. Fortschritt wird abgetastet, daher können Sequenznummern Lücken haben.
• Das Endereignis enthält exitCode und message. Ein result-Ereignis kann Teilerfolg oder Abbruch bedeuten. Prüfe auch den Exit-Code.
• CLI-Bezeichnungen, Hilfe und erzeugte Meldungen sind Englisch. Gespeicherte Einträge und gemeinsame Diagnosen behalten ihren Originaltext. Das optionale Fortschrittsfenster folgt der App-Sprache.
• Nutze JSON-Feldnamen, verfügbare strukturierte Ursachencodes und Exit-Codes für Automatisierung. Gleiche keine übersetzten oder menschenlesbaren Meldungen ab.

Scan- und Optimierungsergebnisse

scan liefert totalFiles, eligibleFiles, potentialDeduplicationFiles, logicalBytes, allocatedBytes, alreadySavedBytes sowie angewandte minimumFileBytes und maximumFileBytes. Mögliche Kandidaten sind weder bestätigte Duplikate noch eine Ersparnisprognose.

Scan-reasons enthalten code, count und message. Gründe können sich überschneiden. Ein ausgeschlossener Ordner zählt einmal, da sein Inhalt nicht aufgelistet wird.

optimize liefert targets, totalFiles, processedFiles, compressedFiles, deduplicatedFiles, skippedFiles, failedFiles, die anfängliche scan-Zusammenfassung und den booleschen Wert cancelled. Oberste reasons sind jüngste lesbare Überspring- oder Fehlerzusammenfassungen, nicht die vollständige Dateihistorie. Einzelne Ergebnisse stehen in activity.

Weitere Ergebniszähler sind alreadyCompressedFiles, insufficientSavingsFiles und noBenefitFiles. Sie erklären Ergebnisse, sind aber keine zusätzlichen Dateien für die Gesamtsumme.

Ersparnisse stehen in compressionSavedBytes, estimatedDeduplicationSavedBytes und totalEstimatedSavedBytes, Größen in Bytes. Kompression und Deduplizierung können dieselbe Datei betreffen. Addiere ihre Dateizähler nicht für eine eindeutige Gesamtzahl. Deduplizierungsersparnis schätzt geteilten Speicher, garantiert aber keinen gleich großen Zuwachs freien Speichers. Auch null Ersparnis kann Erfolg bedeuten.

Fortschritt als Momentaufnahme lesen

Jedes Ereignis beschreibt den neuesten Stand, keinen Zuwachs zum vorherigen. Nutze Phasenzähler für Balken und auftragsweite Zähler für den Gesamtauftrag.

Scrolle die Tabelle auf kleinen Bildschirmen horizontal für die vollständige Referenz.

Duplikatsuche und Gruppierung brauchen auch ohne aktiven Dateinamen Zeit. Lösche alte Dateibezeichnungen, wenn die neue Momentaufnahme kein aktuelles Objekt hat. Erwarte weder feste Phasenreihenfolge noch Befehlsende bei voller Phasenzahl. Nur Endereignis und Prozessende bestätigen den Abschluss.

Messungen sind nicht immer Live-Scans

locations, savings und overview lesen gespeicherte Messungen ohne Dateiscan, neue Rechte oder Überwachungsstart. Sie enthalten readAt, dataSource, locationCount, enabledLocationCount und savings. Daten sind ISO 8601 in UTC.

Fehlend und veraltet sind verschieden

• measurementAvailable zeigt eine gespeicherte Messung an. Unbekannte Werte sind null, nicht null als Zahl.
• measurementStale markiert eine nach fehlgeschlagener Aktualisierung behaltene Messung. DiskPress ersetzt den letzten Erfolg nicht durch null. measurementError und measuredAt liefern Kontext.
• savings.complete ist false, sobald ein Ort ungemessen oder veraltet ist. unmeasuredLocationCount, staleLocationCount und oldestMeasurementAt beschreiben Abdeckung und Alter.
• statusSource eines gespeicherten Ortes ist last_saved. Sein Status ist kein frischer Zielscan.

Aktuelle Ersparnis umfasst gemessene Orte, auch deaktivierte, mit einmaliger Zählung überlappender Dateien. Ein Ort kann Größe, aber keine zugerechnete Ersparnis haben, weil gemeinsame Dateien anderswo zählen. Kürzliche Ersparnis beschreibt erledigte Arbeit. Addiere keine Aktivitätseinträge zur aktuellen Summe und behandle nicht jeden als eigene Datei.

Unter Catalina ist aktuelle Deduplizierungsersparnis nicht messbar. deduplicationMeasurementAvailable ist false, Werte sind null. Deduplizierung funktioniert dennoch, und kürzliche Ersparnis kann erledigte Arbeit enthalten.

Verfügbarkeit und Autorisierung von Orten

Jeder Eintrag aus locations --json hat availability mit available, unavailable, stale_bookmark, missing oder invalid_authorization. Das sind gespeicherte Zustände, keine neue Rechteprüfung. Sie sind vom booleschen available in der paths-Ausgabe getrennt.

invalid_authorization bedeutet, dass das Objekt am Pfad nicht mehr der ursprünglich autorisierten Datei oder dem Ordner entspricht, etwa nach einem Backup-Restore. Prüfe das Ziel in DiskPress, entferne den gespeicherten Ort und füge ihn neu hinzu. Das löscht keine Dateien. Umgehe die Identitätsprüfung nicht.

Aktualisierung nach der Optimierung

Nach Optimierung aktualisiert DiskPress die Ersparnis im Hintergrund. Das CLI-Endergebnis kann vor Ende dieser lesenden Aktualisierung eintreffen. Berichte zeigen savings.refreshing und savings.refreshError. Prüfe auch Messdaten und Abdeckungsflags, denn eine beendete Aktualisierung beweist nicht erfolgreiche Messung jedes Ortes.

Der Host wartet auf Befehle und Aktualisierung, ohne Überwachung zu aktivieren. Ein Auswahl-scan oder Bericht allein fordert sie nicht an. Für separate Messaktualisierung nutze Erneut scannen in der Übersicht.

Speicher und Überwachung

savings und overview enthalten recentSavings für 24 Stunden, 7 und 30 Tage. overview ergänzt storage für das Benutzerordner-Volume und monitoring. Kapazität wird beim Aufruf unabhängig von gespeicherten Dateimessungen abgefragt.

monitoring.enabled ist eine gespeicherte Einstellung, kein CLI-Überwachungsstart. Prüfe monitoring.serviceRunning und monitoring.liveStatusAvailable vor einer Live-Anzeige. Ohne Live-Status sind Fortschrittsfelder null.

Einstellungen und Aktivität prüfen

settings --json liefert ein settings-Objekt mit deduplicationEnabled, scanHiddenSystemFiles, recentFileProtectionSeconds, monitoringEnabled und scanIntervalSeconds. Lesen ändert keine Werte.

Kompressionsgrenzen werden als minimumFileBytes, maximumFileBytes, minimumCompressionSavingsFraction und minimumCompressionSavingsBytes gemeldet. Sie beschreiben Eignung, garantieren aber keine Ersparnis für jede Datei.

settings.performance enthält level, batteryLevel, separatePowerSettings und pauseMonitoringOnBattery. Profilwerte sind low_cpu, balanced, fast oder fastest. Stromquelle und macOS können die aktive Leistung beeinflussen.

Diese Profile gelten auch für die CLI. Am schnellsten skaliert Parallelität nach Performance-Kernen, ersatzweise physischen Kernen. Niedrige CPU-Last taktet Arbeit auch innerhalb großer Dateien, nicht nur dazwischen. Es ist keine feste CPU-Prozentgrenze.

settings.exclusions enthält typisierte Regeln mit id, enabled, type, target, pattern, description und extensions. Typen sind file_type, wildcard, regular_expression und file_group. Ziele sind file_name oder full_path. Dateigruppen enthalten ihre Erweiterungen.

Standardausschlüsse enthalten die Gruppe databases. Aktiviert erfasst sie erkannte Datenbank-Begleitdateien wie database.sqlite-wal, database.sqlite-shm und database.sqlite-journal. Die extensions-Liste enthält Basiserweiterungen, nicht alle Begleitmuster. Lies deine Regeln und prüfe Ausschlüsse mit scan. Übergehe sie bei aktiven Datenbanken nicht.

Gespeicherte Ergebnisse durchblättern

activity --json liefert activity.records aus GUI und CLI, neueste zuerst. Jeder Eintrag enthält id, date, path, name, outcome, originalAllocatedBytes, resultAllocatedBytes, savedBytes, durationSeconds, detail und locationID. Ergebnisse sind compressed, deduplicated, skipped, failed oder recovered.

Übergebe den exakten activity.nextBefore-Wert an --before, bis activity.hasMore false ist. Standard sind 50 Einträge, --limit akzeptiert 1 bis 500. Große Einträge können Seiten verkürzen. Folge dem Cursor, nicht der Anzahl. Neue Einträge verschieben vorhandene Cursor nicht.

Gelöschte oder abgelaufene Cursor liefern Fehler. Starte ohne --before neu. Aktivität ist gespeicherte Historie, kein vollständiges Dateiinventar. Mehrere Einträge können dieselbe Datei meinen. Ein fehlender Eintrag beweist nicht, dass sie nie optimiert wurde.

Exit-Codes und sicherer Abbruch

Ctrl+C, SIGTERM, Abbrechen oder Schließen des Fortschrittsfensters fordern einen sicheren Stopp an. Lass den Prozess enden. Optimierte Dateien bleiben optimiert. Verlust des Terminal-Clients oder der Ausgabepipe bricht ebenfalls ab.

Das Entfernen eines beteiligten Ortes in der App kann einen CLI-Lauf abbrechen. Die CLI meldet Abbruch auch ohne Ctrl+C. Fortschritt kann phase mit cancelling und cancelled mit true zeigen. Das Endergebnis hat exitCode 130 und cancelled mit true. Erledigte Optimierungen bleiben erhalten. Vollständig gestoppt ist erst nach Prozessende.

Kann Standardausgabe kein Endergebnis annehmen, bleibt der Exit-Code maßgeblich. Schneide laufende Ausgabe nicht absichtlich mit etwa head ab. Nutze --quiet, wenn nur das Endergebnis benötigt wird.

Akzeptierte Anfragen werden nach Host-Absturz nicht wiederholt. Exit 75 beweist nicht, dass Dateien unverändert blieben. Bei fehlendem Ergebnis prüfe Aktivität und Wiederherstellung, bevor du erneut startest.

Ein sinnvoller KI-Agenten-Workflow

DiskPress stellt Befehle bereit. Dein Agent entscheidet über den Aufruf. Setze deshalb klare Grenzen. Eine hilfreiche Startanweisung folgt.

Lies --version und --help meiner installierten DiskPress-Datei.
Nutze dieselbe Edition für Rechte, Einstellungen und Befehle.
Prüfe Pfade, Einstellungen und Orte mit --json.
Beachte Ortsmodi. CLI-Berichte zeigen diese nicht.
Bitte mich, den Modus in Orte zu bestätigen, wenn der Ablauf davon abhängt.
Scanne nur ausdrücklich von mir gewählte Dateien oder Ordner.
Beachte, dass CLI-Anfragen den Schutz kürzlich geänderter Dateien nicht anwenden.
Erkläre die Eignung und frage vor der Optimierung.
Beachte verknüpfte Apps und warte bis zum Ende von Schreibzugriffen.
Erteile keine Rechte und nutze keine erhöhten Privilegien.
Übergehe Ausschlüsse nur auf meine ausdrückliche Bitte.
Berichte das Ergebnis anhand des finalen JSON-Ereignisses und Exit-Codes.
Warte nach Abbruch auf Prozessende, auch bei appseitigem Stopp.
Prüfe refreshing, Veraltet-Flags und Daten vor gemeldeten Gesamtsummen.
Prüfe bei fehlendem Endergebnis oder Wiederherstellungsfehler die Aktivität vor einem erneuten Versuch.

Übergib jeden Pfad als eigenes Argument nach --. Hänge niemals ungeschützte Dateinamen an Shell-Befehle an. Fehlen Rechte, bitte um Freigabe in DiskPress statt Schleifenversuchen oder sudo.

Lies nach Warnungen oder Fehlern die Aktivität für Dateigründe. Erfolgreiche Läufe können nichts sparen, sichere Auslassungen sind nicht unbedingt Fehler. Bewahre bei Wiederherstellungsfehlern Dateien und melde den Text. Warte nach Abbruchanforderung auf Prozessende.

Berechtigungen und Sicherheit gelten weiterhin

Vor Optimierungsbeginn brauchen alle Ziele nutzbare gespeicherte Lese-/Schreibrechte. Fehlt einem Ziel Zugriff, scheitert der Befehl vor anderen Optimierungen. Die CLI öffnet keine Rechteauswahl, erteilt keine Rechte und umgeht keine geschützten Pfade. Ordnerfreigaben können Nachkommen abdecken, einzelne Dateien aber nicht ihre Nachbarn.

paths --json liefert authorizations mit path, directory, access und available. Der Zugriffswert ist readWrite. Bei fehlender Freigabe muss eventuell das Volume verbunden oder der Pfad in derselben Edition erneut autorisiert werden.

App und CLI teilen Engine, Verifikation, Wiederherstellung, Ausschlüsse und Dateigrenzen. Apps und ausführbare Dateien bleiben ungeeignet. Deduplizierung gruppiert nur innerhalb desselben kompatiblen Dateisystems, nie über Volumes. Ausschluss-Overrides deaktivieren keine Sicherheit, App-Verknüpfung oder Ortsmodi.

Terminal-Scans und Optimierungen laufen einzeln in der aktuellen macOS-Sitzung mit gemeinsamer CPU-Planung, Wiederherstellung und Bilanzierung. Lesende Statistik-, Einstellungs- und Aktivitätsbefehle können parallel laufen. Es gibt keine CLI-Befehle für Daemon-Aktivierung, Einstellungsänderungen oder Rücknahme fertiger Speicheränderungen.

Halte ein unabhängiges Backup. Lies vor Automatisierung wichtiger Daten die FAQ zu Verifikation und Wiederherstellung.