Передача файлов

Обзор

Когда вы запускаете Spck CLI на компьютере, он действует как хаб синхронизации между файловой системой компьютера и локальными проектами на телефоне. Обе стороны отображаются рядом в файловом менеджере Spck Editor — локальные проекты телефона слева, а файлы компьютера как подключённый удалённый сервер — и вы можете копировать файлы или целые папки в любом направлении с помощью стандартных команд копирования и вставки.

Не требуется AirDrop, Bluetooth, USB-кабель или сторонние облачные хранилища. Передача шифруется end-to-end через WebSocket-соединение и остаётся в локальной Wi-Fi-сети, когда оба устройства находятся в одной сети.

Как это работает

CLI предоставляет каталог компьютера как проект удалённого сервера в файловом менеджере Spck Editor. Локальные проекты, сохранённые на телефоне, хранятся в локальном хранилище приложения. Spck Editor обрабатывает оба как полноценные расположения проектов, поэтому любая файловая операция, работающая в рамках одного проекта — включая копирование и вставку — работает и между ними.

Телефон (локальное хранилище)  Компьютер (через CLI)
──────────────────────────     ─────────────────────
my-project/               ↔   ~/projects/my-project/
  ├── index.html                 ├── index.html
  ├── style.css                  ├── style.css
  └── assets/                    └── assets/
      └── logo.png                   └── logo.png

Каталоги передаются рекурсивно — все файлы внутри копируются, а подкаталоги автоматически создаются в месте назначения.

С компьютера на мобильное устройство

Используйте это, когда хотите перенести файлы с компьютера на телефон — например, для работы офлайн, передачи проекта коллеге с только мобильным приложением или сохранения снимка работы на устройстве.

1. Запустите CLI на компьютере, указав папку, из которой хотите передать файлы:

   spck --root ~/projects
   

2. Подключите телефон, отсканировав QR-код камерой и открыв ссылку в Spck Editor.

3. В Spck Editor папка компьютера отображается как проект удалённого сервера в панели Проекты.

4. Удерживайте файл или папку в удалённом проекте, затем нажмите Копировать.

5. Перейдите к локальному проекту на телефоне (или создайте новый через Новый проект).

6. Удерживайте папку назначения, затем нажмите Вставить.

Файлы загружаются с компьютера и сохраняются в локальное хранилище телефона.

С мобильного устройства на компьютер

Используйте это, когда хотите отправить работу с телефона обратно на компьютер — например, после редактирования в дороге или для объединения проектов, созданных на устройстве.

1. Запустите CLI на компьютере, указав папку, куда должны попасть файлы:

   spck --root ~/Desktop/from-phone
   

2. Подключите телефон, отсканировав QR-код.

3. В Spck Editor откройте локальный проект на телефоне с файлами, которые хотите отправить.

4. Удерживайте файл или папку, затем нажмите Копировать.

5. Перейдите к проекту удалённого компьютера в панели Проекты.

6. Удерживайте папку назначения, затем нажмите Вставить.

Файлы читаются из локального хранилища телефона и записываются на компьютер через CLI.

Передача целых проектов

Вы можете скопировать целую папку проекта за одну операцию вставки. Удерживайте корень проекта в дереве файлов и выберите Копировать, затем перейдите к месту назначения и Вставьте. Передаётся всё дерево каталогов — включая все файлы во всех подкаталогах.

Это полезно для:

• Резервного копирования мобильного проекта на компьютер перед внесением крупных изменений
• Инициализации нового проекта на телефоне из существующей кодовой базы на компьютере
• Объединения работы с нескольких устройств в одном месте

Советы

Ограничение размера файла

Максимальный размер файла по умолчанию составляет 10 МБ на файл. Для передачи больших файлов — изображений, архивов или скомпилированных бинарных файлов — увеличьте ограничение в конфигурации CLI:

{
  "filesystem": {
    "maxFileSize": "200MB"
  }
}

Подробности см. в Конфигурация CLI.

Скорость передачи

Скорость полностью зависит от вашего локального Wi-Fi или интернет-соединения. Для больших каталогов передача выполняется файл за файлом, поэтому общая пропускная способность зависит от количества файлов. В обычной домашней Wi-Fi-сети небольшие текстовые проекты (сотни файлов) завершаются за несколько секунд.

Безопасность

Все передачи шифруются через WSS (WebSocket Secure), и каждый запрос подписывается посессионным секретным ключом. Сервер ретрансляции пересылает сообщения между устройствами, но никогда не получает незашифрованный контент. Подробности см. в Безопасность CLI.

Одновременное выполнение нескольких передач

CLI предоставляет единый корневой каталог. Для одновременной передачи из нескольких мест запустите отдельные экземпляры CLI в разных терминалах:

# Терминал 1: открыть ~/projects
spck --root ~/projects

# Терминал 2: открыть ~/Documents
spck --root ~/Documents

Каждый экземпляр генерирует собственный QR-код и подключение, и оба удалённых сервера одновременно отображаются в панели Проекты Spck Editor.