Файлы между Mac
и Nintendo Switch

PlugOnce даёт AI-агенту доступ к подключённому Switch через команды на вашем Mac. Агент может посмотреть хранилища и свободное место, открыть список файлов, найти нужный файл, получить избранные папки и проверить состояние передачи. Файлы передаёт само приложение PlugOnce; оно должно оставаться открытым.

Например, попросите: «Найди main.elf в папке /switch», «Подготовь отправку этой папки с Mac в моё избранное на Switch» или «Покажи прогресс последней передачи». Для этого агент должен уметь выполнять локальные команды и прочитать инструкцию ниже.

Как начать

1. Подключите Switch по USB, откройте DBI → Run MTP responder и подключите найденное устройство в PlugOnce.
2. Откройте «Настройки» → Agent Access. Включите доступ и выберите нужные действия и папки на Switch. Для отправки отдельно разрешите папку с исходными файлами на Mac.
3. Передайте агенту инструкцию (.md) по ссылке ниже и опишите задачу: что найти или какие файлы отправить и в какую папку.

Перед записью PlugOnce составляет план: какие файлы отправятся, куда, сколько места потребуется и какие имена уже существуют. По умолчанию передача ждёт вашего подтверждения в приложении. Разрешения на чтение и на отправку задаются отдельно.

В версии 0.6.7 (45) можно отдельно разрешить автономную передачу новых файлов и замену существующих. Оба права по умолчанию выключены. Даже с ними агент работает только с папками и действиями, которые вы разрешили в Agent Access.

Raycast — панель быстрых команд на Mac. Расширение PlugOnce позволяет открывать избранные папки устройства, отправлять в них выбранные файлы из Finder, просматривать хранилища и искать файлы на Switch. Для часто используемой папки можно создать Quicklink и назначить ему горячую клавишу в Raycast.

Open Favorites показывает то же избранное, которое вы добавили в PlugOnce. Send Files to Switch принимает файлы и папки из Finder или через окно выбора. Browse and Search Device помогает найти файл, а Transfer Operations показывает прогресс, скорость и оставшееся время; здесь же можно отменить свою передачу. Device Status показывает подключение, объём хранилищ и свободное место.

Если в вашем Raycast доступны AI-инструменты, можно запросить те же действия текстом: например, «Открой мою избранную папку» или «Подготовь отправку выбранных файлов на Switch». Обычные команды работают без Raycast AI.

Как начать

1. Установите Raycast и отдельно импортируйте расширение PlugOnce по инструкции ниже. Для этого нужна локальная копия расширения; публичный архив пока не опубликован.
2. Запустите PlugOnce, подключите Switch через DBI и включите нужные папки и действия в «Настройки» → Agent Access. Для передачи разрешите также источники файлов на Mac.
3. Вызовите команду в Raycast, выберите файлы и папку назначения. Проверьте план передачи и подтвердите запись в PlugOnce, если она требует подтверждения.

Расширение использует разрешения Agent Access и очередь PlugOnce. Оно не включает новые разрешения самостоятельно. Передачу выполняет PlugOnce, поэтому закрытие приложения делает команды недоступными.

Версия приложения — 0.6.8, номер сборки — 46. Beta означает версию для тестирования. Если что-то работает не так, укажите эти номера в сообщении на форуме.

Нотарификация — автоматическая проверка приложения Apple на известное вредоносное ПО. У этой сборки её нет, поэтому macOS может заблокировать первый запуск и сообщить, что не может проверить приложение. Подробнее о таком предупреждении — в инструкции Apple.