Guide · scripts and agentsРуководство · скрипты и агентыПосібник · скрипти й агенти

Ask the running FileDO to do something, and read the answer.Попросите уже запущенный FileDO что-нибудь сделать и прочитайте ответ.Попросіть уже запущений FileDO щось зробити й прочитайте відповідь.

A script, a scheduled task, a shortcut or a development tool types filedo <command>. The FileDO window program that is already running does the work and answers with an exit code. No second copy opens.Скрипт, задача планировщика, ярлык или инструмент разработчика вводят filedo <команда>. Уже запущенное окно FileDO выполняет работу и отвечает кодом завершения. Вторая копия не открывается.Скрипт, завдання планувальника, ярлик або інструмент розробника вводять filedo <команда>. Уже запущене вікно FileDO виконує роботу та відповідає кодом завершення. Друга копія не відкривається.

The commandsКомандыКоманди

Ten commands cover what a script needs from FileDO. Most go to the running window program; commands and version answer on their own. Each prints its answer and ends with an exit code, so a script can branch on it. Every one is safe: it changes only FileDO’s own windows and runs and reads none of your files.Десять команд покрывают то, что скрипту нужно от FileDO. Большинство идут к запущенному окну; commands и version отвечают сами. Каждая печатает ответ и завершается кодом, по которому скрипт может ветвиться. Все они безопасны: меняют только окна и запуски самого FileDO и не читают ваши файлы.Десять команд покривають те, що скрипту потрібно від FileDO. Більшість ідуть до запущеного вікна; commands і version відповідають самі. Кожна друкує відповідь і завершується кодом, за яким скрипт може розгалужуватися. Усі вони безпечні: змінюють лише вікна й запуски самого FileDO та не читають ваших файлів.

CommandКомандаКоманда What it doesЧто делаетЩо робить When FileDO is not runningЕсли FileDO не запущенЯкщо FileDO не запущено
filedo commands Lists every command FileDO accepts; --json prints the manifest itself.Выводит все команды, которые принимает FileDO; --json печатает сам манифест.Виводить усі команди, які приймає FileDO; --json друкує сам маніфест. Works anyway; no window opens.Работает и так; окно не открывается.Працює й так; вікно не відкривається.
filedo version Prints the product name, its version and the version of the command set.Печатает название продукта, его версию и версию набора команд.Друкує назву продукту, його версію та версію набору команд. Works anyway; no window opens.Работает и так; окно не открывается.Працює й так; вікно не відкривається.
filedo status Says whether the window program is running and ready; reports its version, process id, open windows and the number of runs in progress.Сообщает, запущено ли окно и готово ли оно; даёт его версию, идентификатор процесса, открытые окна и число идущих запусков.Повідомляє, чи запущено вікно й чи воно готове; дає його версію, ідентифікатор процесу, відкриті вікна та кількість запусків, що йдуть. Exit 11: nothing is running.Код 11: ничего не запущено.Код 11: нічого не запущено.
filedo show Brings the main window forward, opening it if the program runs without one.Выводит главное окно на передний план, открывая его, если программа работает без окна.Виводить головне вікно на передній план, відкриваючи його, якщо програма працює без вікна. Starts FileDO, then asks it.Запускает FileDO и затем обращается к нему.Запускає FileDO і потім звертається до нього.
filedo quit Closes the running FileDO cleanly. A run in progress makes it refuse (exit 11) unless --stop-jobs stops the runs first.Чисто закрывает запущенный FileDO. Идущий запуск вызывает отказ (код 11), если --stop-jobs не остановил запуски заранее.Чисто закриває запущений FileDO. Запуск, що йде, спричиняє відмову (код 11), якщо --stop-jobs не зупинив запуски наперед. Nothing to close: exit 0.Закрывать нечего: код 0.Закривати нічого: код 0.
filedo disk-manager show Brings the Disk Manager forward, opening it alone when the program has no window.Выводит Диспетчер дисков на передний план, открывая только его, если у программы нет окна.Виводить Диспетчер дисків на передній план, відкриваючи лише його, якщо в програми немає вікна. Starts FileDO with only the Disk Manager.Запускает FileDO только с Диспетчером дисков.Запускає FileDO лише з Диспетчером дисків.
filedo settings show Opens the Settings page of the main window.Открывает страницу «Настройки» главного окна.Відкриває сторінку «Налаштування» головного вікна. Starts FileDO, then asks it.Запускает FileDO и затем обращается к нему.Запускає FileDO і потім звертається до нього.
filedo tray start Starts FileDO hidden, with its tray icon and no window.Запускает FileDO скрытно, со значком в трее и без окна.Запускає FileDO приховано, зі значком у треї й без вікна. Starts it; a copy that already runs is left as it is.Запускает его; уже работающая копия остаётся как есть.Запускає його; уже працююча копія лишається як є.
filedo job list Lists the runs in progress and the operations queued in the Disk Manager: window, verb, state, step and percent. It carries no file names.Перечисляет идущие запуски и операции в очереди Диспетчера дисков: окно, команду, состояние, шаг и проценты. Имён файлов в ответе нет.Перелічує запуски, що йдуть, і операції в черзі Диспетчера дисків: вікно, команду, стан, крок і відсотки. Імен файлів у відповіді немає. Exit 11: nothing is running.Код 11: ничего не запущено.Код 11: нічого не запущено.
filedo job stop Asks the runs to stop gracefully, as the Stop button does, empties the Disk Manager’s queue and waits until no run is left. --where all|shell|manager picks the window.Просит запуски остановиться мягко, как кнопка «Стоп», очищает очередь Диспетчера дисков и ждёт, пока не останется ни одного запуска. --where all|shell|manager выбирает окно.Просить запуски зупинитися м’яко, як кнопка «Стоп», очищає чергу Диспетчера дисків і чекає, доки не лишиться жодного запуску. --where all|shell|manager обирає вікно. Nothing to stop: exit 0.Останавливать нечего: код 0.Зупиняти нічого: код 0.
filedo status

Opening a container fileОткрытие файла контейнераВідкриття файлу контейнера

To open a .fdd virtual disk container or a .fd-sec container in its own FileDO window without handing over to an already running copy, use filedo_win.exe open. If the .fdd container is already mounted, Explorer opens its drive instead.Чтобы открыть виртуальный диск .fdd или контейнер .fd-sec в собственном окне FileDO без передачи управления уже запущенной копии, используйте filedo_win.exe open. Если контейнер .fdd уже подключён, вместо этого откроется его диск в Проводнике.Щоб відкрити віртуальний диск .fdd або контейнер .fd-sec у власному вікні FileDO без передавання керування вже запущеній копії, використовуйте filedo_win.exe open. Якщо контейнер .fdd уже підключено, натомість відкриється його диск у Провіднику.

CommandКомандаКоманда What it doesЧто делаетЩо робить
filedo_win.exe open --path <file> [--mode mount|mount-ro|unmount] Opens the container in its own window (or opens the mounted drive) and exits 0 when closed, 10 on usage error, or 11 if the file does not exist.Открывает контейнер в собственном окне (или открывает подключённый диск) и завершается кодом 0 после закрытия, 10 при ошибке вызова или 11, если файл не найден.Відкриває контейнер у власному вікні (або відкриває підключений диск) і завершується кодом 0 після закриття, 10 у разі помилки виклику або 11, якщо файл не знайдено.
filedo_win.exe <file>, --mount, --mount-ro, --unmount Kept legacy spellings for double-click and Explorer menu entries; they start the same open flow without an exit-code contract.Сохранённые прежние записи для двойного щелчка и пунктов меню Проводника; запускают то же открытие без контракта кода завершения.Збережені давні записи для подвійного клацання та пунктів меню Провідника; запускають те саме відкриття без контракту коду завершення.
filedo_win.exe open --path C:\v\work.fdd --mode mount-ro

Developer toolsИнструменты разработчикаІнструменти розробника

The five switches that the build scripts call on the window program are commands too, written filedo_win.exe <words>. They run in their own process, never through a running window, and the four that write take the folder to write as --out.Пять переключателей, которые сценарии сборки вызывают у оконной программы, тоже являются командами и пишутся filedo_win.exe <слова>. Они выполняются в собственном процессе, никогда через запущенное окно, а четыре из них, пишущие файлы, получают папку для записи через --out.П’ять перемикачів, які сценарії збирання викликають у віконної програми, теж є командами й пишуться filedo_win.exe <слова>. Вони виконуються у власному процесі, ніколи через запущене вікно, а чотири з них, що пишуть файли, отримують теку для запису через --out.

CommandКомандаКоманда What it doesЧто делаетЩо робить
filedo_win.exe selftest run Runs the window program’s own check and exits 0 when every row passes.Запускает собственную проверку оконной программы и завершается кодом 0, если все строки пройдены.Запускає власну перевірку віконної програми й завершується кодом 0, якщо всі рядки пройдено.
filedo_win.exe help-pages build --out <folder> Writes the in-app help pages and their pictures, in every language and both themes.Записывает страницы справки окна и их картинки на всех языках и в обеих темах.Записує сторінки довідки вікна та їхні картинки всіма мовами й в обох темах.
filedo_win.exe screens capture --out <folder> Renders the guide screenshots from the real windows.Рисует снимки экрана для руководств с настоящих окон.Малює знімки екрана для посібників зі справжніх вікон.
filedo_win.exe menu-icons write --out <folder> Writes the Explorer menu icons and prints each file written.Записывает значки меню Проводника и печатает каждый записанный файл.Записує значки меню Провідника й друкує кожен записаний файл.
filedo_win.exe ui-drive run --out <folder> Drives the real windows on the screen for the visual acceptance run and writes its evidence; your own settings are restored afterwards.Управляет настоящими окнами на экране для визуальной приёмки и записывает её результаты; ваши настройки потом восстанавливаются.Керує справжніми вікнами на екрані для візуальної приймання й записує її результати; ваші налаштування потім відновлюються.

The window program has no console of its own, so read its exit code by waiting for it:У оконной программы нет собственной консоли, поэтому код завершения читают, дожидаясь её:У віконної програми немає власної консолі, тому код завершення читають, дочекавшись її:

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

Read the answerПрочитайте ответПрочитайте відповідь

A command prints one sentence for a person. Add --json to get one JSON line instead, with status, exitCode, reason, message and, where the command returns something, data. A script should branch on the exit code.Команда печатает одно предложение для человека. Добавьте --json, чтобы получить вместо него одну строку JSON с полями status, exitCode, reason, message и, если команда что-то возвращает, data. Скрипту стоит ветвиться по коду завершения.Команда друкує одне речення для людини. Додайте --json, щоб отримати замість нього один рядок JSON з полями status, exitCode, reason, message і, якщо команда щось повертає, data. Скрипту варто розгалужуватися за кодом завершення.

Exit codeКод завершенияКод завершення MeaningЗначениеЗначення
0 Done.Готово.Готово.
1 The command ran and the operation failed.Команда выполнялась, но операция не удалась.Команда виконувалася, але операція не вдалася.
2 Not proven: the time bound passed with no answer. The running FileDO may still be working.Не доказано: срок вышел, ответа нет. Запущенный FileDO, возможно, ещё работает.Не доведено: строк минув, відповіді немає. Запущений FileDO, можливо, ще працює.
10 Usage: an unknown command, option or value, a missing option, or a request that is too large.Ошибка вызова: неизвестная команда, параметр или значение, пропущенный параметр или слишком большой запрос.Помилка виклику: невідома команда, параметр чи значення, пропущений параметр або завеликий запит.
11 Not ready: FileDO is not running, or it is busy - a dialog is open, it is closing, or another command is being answered.Не готово: FileDO не запущен или занят - открыт диалог, он закрывается или отвечает на другую команду.Не готово: FileDO не запущено або він зайнятий - відкрито діалог, він закривається чи відповідає на іншу команду.
12 Permission: the command’s risk class is switched off in Settings, or the running FileDO is elevated and the caller is not.Нет разрешения: класс риска команды выключен в настройках, или запущенный FileDO работает с повышенными правами, а вызывающий - нет.Немає дозволу: клас ризику команди вимкнено в налаштуваннях, або запущений FileDO працює з підвищеними правами, а той, хто викликає, - ні.

Each of the ten commands above waits for its answer for a fixed time - from 2 seconds for filedo status to 60 seconds for filedo job stop. Running one of them again after exit 2 is safe: each leaves the same state as a single run.Каждая из десяти команд выше ждёт ответа ограниченное время - от 2 секунд у filedo status до 60 секунд у filedo job stop. Повторить любую из них после кода 2 безопасно: состояние такое же, как после одного запуска.Кожна з десяти команд вище чекає на відповідь обмежений час - від 2 секунд у filedo status до 60 секунд у filedo job stop. Повторити будь-яку з них після коду 2 безпечно: стан такий самий, як після одного запуску.

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

What other programs may askО чём могут просить другие программыПро що можуть просити інші програми

Every command belongs to one of four risk classes. Safe changes only FileDO’s own windows and runs. Reads your data puts screen content, the clipboard, or file contents and names into an answer. Writes your data creates, changes or deletes your files or settings, or acts inside another program. Leaves the machine sends anything off this computer.Каждая команда относится к одному из четырёх классов риска. Безопасная меняет только окна и запуски самого FileDO. Читает ваши данные помещает в ответ содержимое экрана, буфер обмена либо содержимое и имена файлов. Пишет ваши данные создаёт, меняет или удаляет ваши файлы либо настройки или действует внутри другой программы. Выходит за пределы компьютера отправляет что-либо с этого компьютера.Кожна команда належить до одного з чотирьох класів ризику. Безпечна змінює лише вікна й запуски самого FileDO. Читає ваші дані поміщає у відповідь вміст екрана, буфер обміну або вміст та імена файлів. Пише ваші дані створює, змінює чи видаляє ваші файли або налаштування чи діє всередині іншої програми. Виходить за межі комп’ютера надсилає щось із цього комп’ютера.

The ten commands above, filedo_win.exe open and filedo_win.exe selftest run are safe, so a running FileDO accepts them (or opens the container in its own process) without any setting. The four developer tools that write a folder you name are in the class writes your data: they run in their own process when you start them yourself, and no other program can reach them through the running window.Десять команд выше, filedo_win.exe open и filedo_win.exe selftest run безопасны, поэтому запущенный FileDO принимает их (или открывает контейнер в собственном процессе) без всякой настройки. Четыре инструмента разработчика, пишущие в названную вами папку, относятся к классу пишет ваши данные: они выполняются в собственном процессе, когда вы запускаете их сами, и никакая другая программа не может добраться до них через запущенное окно.Десять команд вище, filedo_win.exe open та filedo_win.exe selftest run безпечні, тому запущений FileDO приймає їх (або відкриває контейнер у власному процесі) без жодного налаштування. Чотири інструменти розробника, що пишуть у названу вами теку, належать до класу пише ваші дані: вони виконуються у власному процесі, коли ви запускаєте їх самі, і жодна інша програма не може дістатися до них через запущене вікно.

The one settingЕдинственная настройкаЄдине налаштування

A command of any class other than safe is refused with exit 12 until you turn on Let other programs ask FileDO to work with my files, screen, clipboard or the network in Settings, group Windows and window positions. It is off until you turn it on, only you can turn it on, and no command can change it. filedo status reports whether it is on.Команда любого класса, кроме безопасного, отклоняется с кодом 12, пока вы не включите на странице «Настройки», в группе «Windows и положение окон», пункт Разрешить другим программам просить FileDO работать с моими файлами, экраном, буфером обмена или сетью. Он выключен, пока вы его не включите, включить его можете только вы, и никакая команда его не меняет. filedo status сообщает, включён ли он.Команда будь-якого класу, крім безпечного, відхиляється з кодом 12, доки ви не ввімкнете на сторінці «Налаштування», у групі «Windows і розташування вікон», пункт Дозволити іншим програмам просити FileDO працювати з моїми файлами, екраном, буфером обміну або мережею. Він вимкнений, доки ви його не ввімкнете, ввімкнути його можете лише ви, і жодна команда його не змінює. filedo status повідомляє, чи він увімкнений.

Same user, never the networkТот же пользователь, никогда не сетьТой самий користувач, ніколи не мережа

The commands travel over a local pipe that only your own Windows account, in your own session, can reach. Nothing goes over the network, and a FileDO running as administrator answers only callers that run as administrator too (exit 12).Команды идут по локальному каналу, до которого может добраться только ваша учётная запись Windows в вашем сеансе. Ничего не уходит по сети, а FileDO, запущенный от администратора, отвечает только тем, кто тоже запущен от администратора (код 12).Команди йдуть локальним каналом, до якого може дістатися лише ваш обліковий запис Windows у вашому сеансі. Нічого не йде мережею, а FileDO, запущений від адміністратора, відповідає лише тим, хто теж запущений від адміністратора (код 12).

Where a script or an agent finds the listГде скрипту или агенту найти списокДе скрипту чи агенту знайти список

filedo commands --json prints the whole manifest - every command with its options, answer, risk, exit codes and examples - from the installed copy, with no window. The same list is written out as docs/CLI.md.filedo commands --json печатает весь манифест - каждую команду с параметрами, ответом, риском, кодами завершения и примерами - из установленной копии, без окна. Тот же список записан в файле docs/CLI.md.filedo commands --json друкує весь маніфест - кожну команду з параметрами, відповіддю, ризиком, кодами завершення та прикладами - зі встановленої копії, без вікна. Той самий список записано у файлі docs/CLI.md.

To learn what FileDO is doing before you act, prefer filedo status, filedo job list and filedo vd status json to a screenshot. FileDO’s other verbs - filedo E: info, filedo copy, filedo vd mount and the rest of filedo -? - are separate programs with exit classes of their own; the quick start lists them.Чтобы узнать, что делает FileDO, прежде чем действовать, лучше filedo status, filedo job list и filedo vd status json, чем снимок экрана. Остальные команды FileDO - filedo E: info, filedo copy, filedo vd mount и всё, что показывает filedo -? - отдельные программы со своими классами кодов завершения; их перечисляет быстрый старт.Щоб дізнатися, що робить FileDO, перш ніж діяти, краще filedo status, filedo job list і filedo vd status json, ніж знімок екрана. Решта команд FileDO - filedo E: info, filedo copy, filedo vd mount і все, що показує filedo -? - окремі програми зі своїми класами кодів завершення; їх перелічує швидкий старт.