Файлы и папки

Как работает Files & Folders

Files & Folders — отдельная категория действий и сигналов для работы с локальными файлами и папками. Core выполняет операции и следит за разрешёнными папками, даже когда Editor закрыт. Действия с файлами можно запускать любым сигналом; для этого не нужно включать наблюдение за папкой.

Для этой функции доступ к папкам разрешается отдельно. Context storage остаётся отдельным источником файлов контекста Database и AI: разрешение на папку не добавляет её содержимое в запросы к AI.

Разрешите доступ к папке

1. Откройте и сохраните проект, который будет работать с файлами.
2. В меню Core в системном трее откройте Core Settings → Files & Folders.
3. Нажмите Add folder access…. Укажите постоянный Location ID, например recordings, отображаемое имя и локальную папку.
4. Выберите операции, разрешённые проекту. Чтобы работать с вложенными файлами или следить за подпапками, включите Allow access to subfolders.
5. Оставьте Remember for this project on this PC выключенным, если доступ нужен только до перезапуска Core. Включите его, чтобы сохранить решение для этого файла проекта на данном компьютере.
6. Нажмите Apply access. Core приостановит и дождётся завершения выполняющихся автоматизаций, изменит разрешения и восстановит прежнее состояние выполнения.

В действиях и сигналах используйте Location ID. Можно выбрать разрешённый ID из списка или заранее указать неизвестный ID для другого компьютера. Сам ввод ID не даёт доступа к папке.

Edit / rebind folder… меняет привязку к локальной папке, но не перемещает файлы. Revoke folder access отзывает разрешение.

Какие разрешения доступны

• List and inspect — проверять наличие, просматривать свойства и получать список содержимого.
• Watch for changes — получать сигналы об изменениях; также требуется List and inspect.
• Read files — читать файлы или использовать их как источник копирования.
• Create files and folders — создавать файлы и папки в месте назначения.
• Modify / overwrite — изменять существующие файлы, дописывать текст или заменять файлы назначения.
• Rename / move source — переименовывать элементы и удалять исходники после успешного переноса.
• Send to Recycle Bin — отправлять элементы в корзину Windows там, где это поддерживается.
• Permanently delete — удалять разрешённые элементы без корзины.

Разрешения на источник и место назначения проверяются отдельно. Для копирования нужны Read files у источника и Create files and folders у назначения. Для перемещения дополнительно нужен Rename / move source, а для замены — Modify / overwrite. Разрешение наблюдать за папкой само по себе не даёт права читать или изменять файлы.

Абсолютные пути в действиях, переходы к родительским папкам, альтернативные потоки и ссылки файловой системы отклоняются. Неизвестный Location ID не подменяется другой папкой. Удалять или изменять саму корневую привязку нельзя — выбирайте файл или подпапку внутри неё.

Эти разрешения ограничивают встроенные файловые действия. Они не ограничивают возможности доверенных скриптов и плагинов в Windows.

Действия

• Path Exists — проверить, существует ли файл или папка.
• Get Path Info — получить тип, размер, даты и атрибуты.
• List Files / List Directories — получить список с учётом масок, вложенности и ограничений.
• Wait for File Ready — дождаться появления файла, стабильного состояния и возможности чтения.
• Create Directory — создать папку, при необходимости вместе с отсутствующими родительскими папками.
• Copy File / Copy Directory — скопировать файлы или папки между отдельно разрешёнными расположениями.
• Move File / Move Directory — перенести файлы и удалить успешно перенесённые исходники.
• Rename File or Folder — переименовать элемент в текущей папке.
• Move to Recycle Bin — отправить элемент в корзину без перехода к необратимому удалению.
• Delete Permanently — удалить элемент; рекурсивное удаление папки включается отдельно.
• Read Text File — прочитать текстовый файл с выбранной кодировкой и ограничением размера.
• Write Text File / Append Text File — записать текст в файл или добавить его в конец.

Выберите путь

Путь задаётся относительно выбранного расположения: например, teams/{vars.team}.png внутри logos. Пути и текст поддерживают обычную подстановку полей; Location ID указывается буквально.

Нажмите … рядом с полем пути, чтобы открыть дерево и поиск. Слева выберите разрешённое расположение, затем найдите или раскройте папку, выберите файл либо папку и нажмите Select. Для нового файла или папки путь назначения можно ввести вручную. Cancel отменяет выбор. Для просмотра содержимого нужно разрешение List and inspect, даже если само действие только записывает данные.

Ручной ввод и шаблоны по-прежнему доступны. Окно выбора не выдаёт разрешений и не заменяет проверку доступа при выполнении.

Конфликты файлов

При совпадении имён выберите Fail, Skip, UniqueName или Replace. Объединение папок включается отдельно: конфликты решаются для отдельных файлов, а остальные файлы папки назначения сохраняются. Вся папка назначения целиком не заменяется. Для Append Text File действует собственное правило добавления текста.

На иллюстрации Copy File включён Preview only: показана настройка, а не результат копирования.

Сигналы папок

Доступны File Created, File Changed, File Ready, File Renamed, File Deleted, Directory Created, Directory Renamed, Directory Deleted, Watch Availability Changed и Watch Rescan Completed.

Укажите расположение, относительный путь к папке, маски включения и исключения, вложенность, ограничения глубины и числа элементов, интервал проверки и период стабильности. Маски разделяются точкой с запятой, например *.mkv;*.mp4. Файлы, которые уже существуют при запуске наблюдения, пропускаются, если не включён Process existing files.

События могут содержать Location ID, относительный путь, имя, расширение, тип, последние замеченные размер и время записи, а при наличии — прежний путь. Сигналы доступности передают состояние доступности и безопасный код статуса. После удаления часть свойств может быть недоступна.

File Created не означает, что запись завершена. File Ready проверяет стабильность размера и времени записи, а также доступность файла; это приблизительная проверка. Если программа записи сообщает о завершении явно, лучше использовать её событие, а затем при необходимости Wait for File Ready.

Наблюдение сочетает ограниченные сканирования с доступными уведомлениями о переименовании. Изменения, целиком произошедшие между проверками, могут быть пропущены. Повторное сканирование восстанавливает текущее состояние, но не полную историю. После паузы или перезапуска исходное состояние строится заново с учётом Process existing files. Изменения самого Streaming Hub тоже видны наблюдателю: разделяйте входные и выходные папки и используйте фильтры, чтобы избежать циклов.

Предпросмотр и результаты

Включите Preview only, чтобы проверить пути и разрешения без изменения файлов. Если другой процесс изменит файл после проверки, план может устареть. Обычный Test выполняет реальные операции — это не предпросмотр.

По умолчанию результат записывается в runtime.files.last: там доступны operationId, status, относительные path и destinationPath, ограниченный список items, а также count, bytes, truncated и, при наличии, text или errorCode. Чтобы сохранить несколько результатов, задайте другой буквальный путь Result path под runtime.*. Результаты можно посмотреть в Runs.

Возможные статусы: completed, skipped, preview, partial, cancelled, failed. Операции с папками не являются транзакциями: после отмены или ошибки часть файлов назначения может остаться. Перед повтором проверьте результаты отдельных элементов. Исходник при перемещении удаляется только после записи и проверки файла назначения; при фильтрации несовпавшие файлы могут остаться, а результат будет частичным.

Корзина доступна только в Windows и не работает для UNC-путей или съёмных расположений; автоматического перехода к необратимому удалению нет. Чтение и запись текста ограничиваются настраиваемым размером до 16 МиБ. На копирование файлов это ограничение не распространяется.

Перенос проекта

Проект хранит логические ID и относительные пути, но не локальные привязки и разрешения. После копирования, импорта или Save As в другое место доступ нужно разрешить заново. На другом компьютере привяжите recordings, archive и другие ID к нужным папкам; относительные пути в действиях сохранятся.

Повторная привязка не перемещает папку физически. Чтобы переместить выбранные элементы между разрешёнными расположениями, используйте Move File или Move Directory. Команды переноса корневой папки и разрешения на один запуск нет.