ZDisk CLI — это интерактивная консольная файловая система, развернутая поверх инфраструктуры национального мессенджера MAX (МАКС). Она превращает ваш чат в безлимитное облачное хранилище с привычным файловым интерфейсом, встроенным шифрованием и отказоустойчивой передачей данных.
- Полноценный Интерактивный Shell: Управляйте вашими облачными файлами так же легко, как локальной ОС, используя привычные команды навигации (
cd,ls,mkdir). - Сквозное AES-256 Шифрование: Защита приватных файлов паролем. Файлы шифруются локально на вашем компьютере перед отправкой и безопасно расшифровываются при скачивании.
- Многопоточное разбиение: Автоматическая нарезка файлов любого размера на части с последующей бесшовной сборкой при скачивании.
- Корзина:
- Безопасное двухэтапное удаление.
- Быстрое групповое удаление всех файлов и их частей из облака при очистке.
- Мгновенный QR-вход: Полная беспарольная авторизация через сканирование QR-кода прямо в окне терминала с помощью официального мобильного приложения.
Склонируйте репозиторий с проектом и выполните установку в режиме редактирования. Это автоматически сделает команду zdisk доступной глобально в вашей операционной системе:
pip install -e .Для запуска интерактивной консоли просто введите в терминале:
zdisk(Или воспользуйтесь явным вызовом zdisk shell)
Запустив интерактивный режим, вы попадаете в изолированное командное окружение.
| Команда | Описание | Пример использования |
|---|---|---|
ls [путь] |
Выводит список файлов и папок в текущей или указанной директории. Автоматически скрывает удаленные в корзину файлы. | ls /images |
cd [путь] |
Переход между виртуальными папками (cd .. — на уровень выше, cd / — в корень). |
cd /docs |
mkdir <имя> |
Создает новую виртуальную директорию (через служебный .keeper файл). |
mkdir music |
upload <файл> |
Загружает локальный файл в текущую облачную папку с интерактивным прогресс-баром. Запросит пароль, если необходимо шифрование. | upload photo.jpg |
download <файл> |
Скачивает выбранный файл в локальную папку с автоматической расшифровкой и объединением частей. | download photo.jpg . |
rm <файл> |
Удаляет файл. По умолчанию безопасно перемещает его в корзину. | rm report.pdf |
rm <файл> --permanent |
Окончательно удаляет файл и все его сегменты из истории чата мессенджера (допускается опечатка --permament). |
rm secret.txt --permanent |
trash |
Управление корзиной. Вызов без флагов отображает список удаленных элементов с индексами. | trash |
trash --list |
Аналог вызова trash — отображает удаленные файлы, пути их удаления и время. |
trash --list |
trash --restore <index> |
Восстанавливает выбранный по индексу файл из корзины на его прежнее место. | trash --restore 0 |
trash --clear [index] |
Окончательно стирает выбранный элемент по индексу. Если индекс не указан — выполняет полную мгновенную очистку всей корзины и связанных файлов в чате. | trash --clear 2 или trash --clear |
config --chat <ID> |
Привязывает ZDisk к ID чата вашего мессенджера МАКС (например, 0 для папки "Избранное"). |
config --chat 0 |
help |
Показывает интерактивную справку по доступным командам. | help |
exit / quit |
Безопасно завершает сессию и выходит из интерактивного режима. | exit |
Если вы предпочитаете выполнять разовые операции без входа в интерактивный режим, ZDisk поддерживает вызовы с аргументами командной строки:
- Настройка хранилища:
zdisk config --chat 0
- Авторизация через QR-код:
zdisk login
- Просмотр файлов в облаке:
zdisk ls /documents
- Загрузка с шифрованием AES-256:
zdisk upload confidential.pdf /secret_folder -p my_password
- Скачивание с расшифровкой:
zdisk download confidential.pdf ./local_dir -p my_password
- Окончательное удаление файла:
zdisk rm dangerous_file.zip --permanent
- Восстановление из корзины по индексу:
zdisk trash --restore 1
- Очистить корзину полностью:
zdisk trash --clear