Anleitung · Skripte und Agenten

Bitten Sie das laufende FileDO um etwas und lesen Sie die Antwort.

Ein Skript, eine geplante Aufgabe, eine Verknüpfung oder ein Entwicklerwerkzeug tippt filedo <Befehl>. Das bereits laufende FileDO-Fenster erledigt die Arbeit und antwortet mit einem Exitcode. Eine zweite Kopie öffnet sich nicht.

Die Befehle

Zehn Befehle decken ab, was ein Skript von FileDO braucht. Die meisten gehen an das laufende Fensterprogramm; commands und version antworten selbst. Jeder gibt seine Antwort aus und endet mit einem Exitcode, nach dem ein Skript verzweigen kann. Alle sind sicher: Sie ändern nur die eigenen Fenster und Läufe von FileDO und lesen keine Ihrer Dateien.

Befehl Was er tut Wenn FileDO nicht läuft
filedo commands Listet jeden Befehl auf, den FileDO annimmt; --json gibt das Manifest selbst aus. Funktioniert trotzdem; es öffnet sich kein Fenster.
filedo version Gibt den Produktnamen, seine Version und die Version des Befehlssatzes aus. Funktioniert trotzdem; es öffnet sich kein Fenster.
filedo status Sagt, ob das Fensterprogramm läuft und bereit ist; meldet Version, Prozess-ID, offene Fenster und die Zahl der laufenden Läufe. Exit 11: nichts läuft.
filedo show Holt das Hauptfenster in den Vordergrund und öffnet es, wenn das Programm ohne Fenster läuft. Startet FileDO und fragt es dann.
filedo quit Schließt das laufende FileDO sauber. Ein laufender Lauf führt zur Ablehnung (Exit 11), außer --stop-jobs beendet die Läufe vorher. Nichts zu schließen: Exit 0.
filedo disk-manager show Holt die Datenträgerverwaltung in den Vordergrund und öffnet sie allein, wenn das Programm kein Fenster hat. Startet FileDO nur mit der Datenträgerverwaltung.
filedo settings show Öffnet die Seite „Einstellungen“ des Hauptfensters. Startet FileDO und fragt es dann.
filedo tray start Startet FileDO verborgen, mit Symbol im Infobereich und ohne Fenster. Startet es; eine bereits laufende Kopie bleibt, wie sie ist.
filedo job list Listet die laufenden Läufe und die Vorgänge in der Warteschlange der Datenträgerverwaltung auf: Fenster, Verb, Zustand, Schritt und Prozent. Dateinamen enthält die Antwort nicht. Exit 11: nichts läuft.
filedo job stop Bittet die Läufe, wie die Schaltfläche Stopp sanft anzuhalten, leert die Warteschlange der Datenträgerverwaltung und wartet, bis kein Lauf mehr übrig ist. --where all|shell|manager wählt das Fenster. Nichts anzuhalten: Exit 0.
filedo status

Eine Containerdatei öffnen

Um einen virtuellen Datenträger .fdd oder einen Container .fd-sec in einem eigenen FileDO-Fenster zu öffnen, ohne an eine bereits laufende Kopie zu übergeben, verwenden Sie filedo_win.exe open. Ist der .fdd-Container bereits eingebunden, öffnet stattdessen der Explorer sein Laufwerk.

Befehl Was er tut
filedo_win.exe open --path <file> [--mode mount|mount-ro|unmount] Öffnet den Container im eigenen Fenster (oder öffnet das eingebundene Laufwerk) und endet mit 0 beim Schließen, 10 bei Aufruffehler oder 11, wenn die Datei fehlt.
filedo_win.exe <file>, --mount, --mount-ro, --unmount Beibehaltene ältere Schreibweisen für Doppelklick und Explorer-Menüeinträge; sie starten denselben Öffnungsvorgang ohne Exitcode-Vertrag.
filedo_win.exe open --path C:\v\work.fdd --mode mount-ro

Entwicklerwerkzeuge

Die fünf Schalter, die die Build-Skripte am Fensterprogramm aufrufen, sind ebenfalls Befehle und werden filedo_win.exe <Wörter> geschrieben. Sie laufen in einem eigenen Prozess, nie über ein laufendes Fenster, und die vier, die schreiben, erhalten den Zielordner über --out.

Befehl Was er tut
filedo_win.exe selftest run Führt die eigene Prüfung des Fensterprogramms aus und endet mit Exit 0, wenn alle Zeilen bestehen.
filedo_win.exe help-pages build --out <folder> Schreibt die Hilfeseiten des Fensters und ihre Bilder in jeder Sprache und beiden Designs.
filedo_win.exe screens capture --out <folder> Erzeugt die Screenshots der Anleitungen aus den echten Fenstern.
filedo_win.exe menu-icons write --out <folder> Schreibt die Symbole des Explorer-Menüs und gibt jede geschriebene Datei aus.
filedo_win.exe ui-drive run --out <folder> Steuert die echten Fenster auf dem Bildschirm für die visuelle Abnahme und schreibt deren Belege; Ihre eigenen Einstellungen werden danach wiederhergestellt.

Das Fensterprogramm hat keine eigene Konsole; den Exitcode lesen Sie, indem Sie auf es warten:

(Start-Process .\filedo_win.exe -ArgumentList 'selftest run' -Wait -PassThru).ExitCode

Die Antwort lesen

Ein Befehl gibt einen Satz für Menschen aus. Mit --json erhalten Sie stattdessen eine JSON-Zeile mit status, exitCode, reason, message und, wo der Befehl etwas zurückgibt, data. Ein Skript sollte nach dem Exitcode verzweigen.

Exitcode Bedeutung
0 Erledigt.
1 Der Befehl lief, aber der Vorgang ist fehlgeschlagen.
2 Nicht belegt: Die Zeitgrenze ist ohne Antwort verstrichen. Das laufende FileDO arbeitet möglicherweise noch.
10 Aufruf falsch: ein unbekannter Befehl, eine unbekannte Option oder ein unbekannter Wert, eine fehlende Option oder eine zu große Anfrage.
11 Nicht bereit: FileDO läuft nicht oder ist beschäftigt - ein Dialog ist offen, es schließt sich oder beantwortet einen anderen Befehl.
12 Keine Berechtigung: Die Risikoklasse des Befehls ist in den Einstellungen ausgeschaltet, oder das laufende FileDO ist erhöht und der Aufrufer nicht.

Jeder der zehn Befehle oben wartet nur begrenzt auf die Antwort - von 2 Sekunden bei filedo status bis 60 Sekunden bei filedo job stop. Jeden von ihnen nach Exit 2 zu wiederholen ist sicher: Er hinterlässt denselben Zustand wie ein einzelner Lauf.

filedo status
(filedo job list --json | ConvertFrom-Json).data.jobs.Count
filedo quit --stop-jobs

Worum andere Programme bitten dürfen

Jeder Befehl gehört zu einer von vier Risikoklassen. Sicher ändert nur die eigenen Fenster und Läufe von FileDO. Liest Ihre Daten legt Bildschirminhalt, die Zwischenablage oder Dateiinhalte und -namen in eine Antwort. Schreibt Ihre Daten erstellt, ändert oder löscht Ihre Dateien oder Einstellungen oder handelt innerhalb eines anderen Programms. Verlässt den Rechner sendet irgendetwas von diesem Computer fort.

Die zehn Befehle oben, filedo_win.exe open und filedo_win.exe selftest run sind sicher, deshalb nimmt ein laufendes FileDO sie (oder öffnet den Container im eigenen Prozess) ohne jede Einstellung an. Die vier Entwicklerwerkzeuge, die in einen von Ihnen genannten Ordner schreiben, gehören zur Klasse schreibt Ihre Daten: Sie laufen in einem eigenen Prozess, wenn Sie sie selbst starten, und kein anderes Programm erreicht sie über das laufende Fenster.

Die eine Einstellung

Ein Befehl jeder anderen Klasse als sicher wird mit Exit 12 abgelehnt, bis Sie in den „Einstellungen“, Gruppe Windows und Fensterpositionen, Anderen Programmen erlauben, FileDO um Arbeit mit meinen Dateien, dem Bildschirm, der Zwischenablage oder dem Netzwerk zu bitten einschalten. Sie ist aus, bis Sie sie einschalten, nur Sie können sie einschalten, und kein Befehl ändert sie. filedo status meldet, ob sie an ist.

Derselbe Benutzer, nie das Netzwerk

Die Befehle laufen über eine lokale Pipe, die nur Ihr eigenes Windows-Konto in Ihrer eigenen Sitzung erreicht. Nichts geht über das Netzwerk, und ein als Administrator laufendes FileDO antwortet nur Aufrufern, die ebenfalls als Administrator laufen (Exit 12).

Wo ein Skript oder ein Agent die Liste findet

filedo commands --json gibt das ganze Manifest aus - jeden Befehl mit Optionen, Antwort, Risiko, Exitcodes und Beispielen - aus der installierten Kopie, ohne Fenster. Dieselbe Liste steht als docs/CLI.md geschrieben vor.

Um zu erfahren, was FileDO gerade tut, bevor Sie handeln, nutzen Sie lieber filedo status, filedo job list und filedo vd status json statt eines Screenshots. Die übrigen Verben von FileDO - filedo E: info, filedo copy, filedo vd mount und alles, was filedo -? zeigt - sind eigene Programme mit eigenen Exitklassen; der Schnellstart listet sie auf.