Подключённые устройства и перенос данных

Доступность Amazi Desktop

Amazi Desktop доступен для Windows x64, Linux amd64 (Debian/Ubuntu) и macOS 13 или новее на Apple Silicon. Скачайте установщик во вкладке Устройства проекта. На macOS откройте DMG и перенесите Amazi в Applications. Чтобы обновить Amazi на macOS, скачайте и установите новую версию DMG.

Установите и откройте Amazi Desktop, войдите через браузер и сохраните доступ для проекта в Desktop. Затем выберите устройство во вкладке Устройства и нажмите Сохранить. Скачать приложение может каждый; работа с подключёнными устройствами зависит от тарифа.

Если к аккаунту уже подключены устройства, выбрать или отключить одно из них для проекта можно и офлайн. Измените переключатель устройства, затем нажмите Сохранить справа вверху вкладки Устройства. Изменения применяются только после сохранения; выбор другого устройства заменяет предыдущее. Обновление статуса не сбрасывает несохранённые изменения, а при ошибке сохранения их можно отправить повторно. Хедер показывает состояние сохранённого выбора: «Подключено», «Не в сети» или «Не подключено». Подключайте новые устройства и задавайте уровень доступа и разрешённые папки для проекта в Amazi Desktop. Агент работает только в этих границах, когда устройство в сети. Сам выбор устройства не выдаёт разрешений. Если подключённых устройств нет, вкладка показывает заглушку.

Доступ к устройству

Попросите Amazi перечислить устройства владельца проекта, чтобы узнать состояние связи и настройки доступа, включая устройства, которые сейчас не выбраны. Команды выполняются только на выбранном устройстве; просмотр списка не подключает устройства к проекту и не меняет их права.

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

Amazi может проверить сведения о выбранном устройстве, даже если доступ Выключен или разрешения ещё не сохранены. Агент пояснит, нужно ли включить доступ, сохранить настройки или восстановить связь. Устройство может быть подключено, но доступ для этого проекта всё ещё выключен.

В Desktop подсказка о выборе устройства в веб-приложении находится вверху настроек проекта. Выключен запрещает команды и доступ к файлам. Ограниченный запускает команды в sandbox с выбранными правами для папок и сети. Агент также может запросить команду в обычном терминале без этих ограничений: её разрешает сохранённое правило либо владелец устройства подтверждает запуск в чате. Полный доступ позволяет командам работать с файлами, программами и сетью с правами вашей учётной записи ОС, без этих ограничений папок и сети. Сохраните права в Desktop, а выбор устройства — отдельно во вкладке Устройства веб-проекта.

Режим доступа показан рядом со статусом устройства и в сведениях о нём: «Выключен», «Ограниченный» или «Полный доступ». Для ограниченного доступа также показаны права папок и сети. Права каждой папки — «Только чтение» или «Чтение и запись» — обозначены тегами разных оттенков серого. Для ограниченного доступа также показаны сохранённые правила команд терминала. Выбор устройства не меняет сохранённые настройки папок и сети. Отключение выбора в веб-разделе отзывает правила команд и ожидающие подтверждения для проекта.

Владелец аккаунта или администратор может раскрыть Сведения об устройстве и нажать Отключить устройство справа внизу. Подтвердите действие, затем нажмите Сохранить, чтобы отвязать устройство от аккаунта владельца и всех проектов и выполнить выход в Desktop. До сохранения действие можно отменить кнопкой Отменить удаление. Для повторного подключения нужно снова войти и выбрать устройство в нужных проектах. Приглашённые участники, в том числе с полным доступом к проекту, не могут отвязывать устройство от аккаунта владельца.

В Amazi Desktop откройте меню аккаунта и выберите Выйти и удалить устройство. После подтверждения устройство удаляется из аккаунта и всех проектов, а сеанс Desktop завершается. Если удалить устройство не удалось, сеанс сохраняется и действие можно повторить.

Действия на устройстве доступны только через чат Amazi. В режиме «Ограниченный» запрос запуска в обычном терминале без подходящего правила показывает подтверждение до выполнения. После ошибки sandbox также запрашивается новый запуск в обычном терминале — по сохранённому правилу или после согласия владельца. Причина ошибки может быть другой; повторная попытка может повторить уже выполненные изменения. Команда выделена отдельным блоком: у длинных команд показываются первые 100 символов с многоточием. Варианты ответа показываются без описаний, а префикс программы выделен. Сокращается только отображение; после согласия выполняется полная исходная команда с полным доступом. Владелец устройства может выбрать Запретить, Разрешить только в этот раз, Разрешить эту команду в будущем или Разрешить все команды программа * в будущем. Если Amazi не может определить явно указанную программу, последний вариант остаётся видимым, но заблокированным. Только два варианта разрешения на будущее сохраняют правило. Правило exact сопоставляет всю команду, включая аргументы и символы * в самой строке. Правило prefix разрешает программу с дополнительными буквальными аргументами из любой рабочей папки для проекта и устройства; цепочки, подстановки и перенаправления автоматически не разрешаются. Amazi увидит сохранённое разрешение при следующей проверке устройства. Для отмены выберите «Запретить» или остановите задачу. После согласия Amazi автоматически продолжит сохранённую команду: дополнительное сообщение или запрос агента не нужны. Отмена, потеря связи и отзыв доступа не вызывают запрос повторного запуска. Ошибки обычного терминала не запускают новый круг подтверждения. Успешная команда sandbox может не видеть процессы или службы основной системы; при необходимости Amazi явно запросит проверку в терминале. Переключение режима отменяет ожидающие и разовые подтверждения и останавливает текущие команды. Сохранённые правила команд и настройки папок и сети режима «Ограниченный» хранятся отдельно и не теряются, в том числе после перезапуска Desktop. Полный доступ включает файлы, программы и сеть с правами вашей учётной записи операционной системы.

В Amazi Desktop Доступ к сети расположен над вкладками настроек и управляет сетью песочницы. В режиме Ограниченный есть две вкладки: Папки песочницы для разрешений папок и Разрешённые команды терминала для команд вне ограничений песочницы, включая разрешения из чата. Нажмите Добавить команду, введите команду и выберите точное совпадение или префикс; префиксы вроде git или git status вводятся без *. Удаляйте ненужные правила кнопкой удаления. Для изменения правила удалите его и добавьте новое. Изменения списка применяются сразу при подключённом устройстве, отдельно от сохранения настроек проекта. Веб показывает этот список без редактирования. Правила действуют для терминала в Ограниченном режиме и сохраняются при переключении режимов. Префикс программы разрешает любые буквальные аргументы, включая разрушительные операции и код, переданный интерпретатору.

Подтвердить команду на устройстве или сохранить правило разрешения может только владелец проекта. Остальные участники видят это ограничение внутри карточки вопроса. Любой участник с правом писать в чат может нажать Пропустить: команда не выполнится, разрешение не сохранится. Поле ввода чата остаётся видимым, пока вопрос ожидает ответа.

При первом сохранении прав устройства для проекта в список разрешённых команд добавляется небольшой набор точных диагностических команд для его операционной системы: текущая папка, список файлов, пользователь, имя компьютера и запущенные процессы. Эти правила разрешают запуск в терминале в режиме «Ограниченный» и удаляются так же, как остальные сохранённые правила. Дополнительные аргументы они не разрешают. Существующие настройки связок «проект — устройство» не меняются. Повторное сохранение, переключение режима или переподключение не восстанавливает удалённые правила.

Раздел Подключение браузера в Amazi Desktop позволяет подключить личный Chrome или Edge. Выберите браузер, нажмите Установить расширение, затем Открыть страницу подключения, скопируйте токен расширения в Desktop и нажмите Сохранить и проверить. Компоненты для работы с браузером входят в Amazi: настраивать терминал не нужно. Статус Подключён появляется после проверки соединения. Токен остаётся на устройстве и не передаётся в чат. Если защищённое хранилище недоступно, после перезапуска Amazi потребуется подключить браузер снова.

Пока Desktop остаётся в аккаунте и в сети, он повторно подключает сохранённый браузер после отмены действия или неудачной проверки соединения. Перезапускать Desktop и заново вводить токен не нужно. Отменённые действия не повторяются. Отключить для всех проектов удаляет сохранённое подключение и прекращает автоматическое переподключение.

Подключение браузера общее для всех проектов и режимов доступа на устройстве. Включайте Доступ к браузеру для этого проекта отдельно в каждом проекте: по умолчанию он выключен, изменения применяются сразу. Разрешение распространяется на страницы с выполненным входом и действует независимо от ограничений файлов и сети песочницы, в том числе при выключенном доступе к командам. Устройство должно быть выбрано для проекта и находиться в сети. Выключение доступа в одном проекте сохраняет разрешения остальных; Отключить для всех проектов удаляет общее подключение. Агент видит состояние при проверке устройства и уточняет нужную вкладку перед действиями.

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

Для переноса файлов нужен режим «Ограниченный» с правами на соответствующие папки либо «Полный доступ»; правила терминала не разрешают перенос файлов или исключения из его ограничений папок.

В Desktop режим Ограниченный позволяет выбрать права для папок и доступ к сети. На Windows Все папки всегда включены с правом Только чтение: выключить его или заменить общим правом записи нельзя. Команды могут читать за пределами выбранных папок, кроме защищённых данных Amazi, с учётом прав Windows. Для изменений добавьте отдельные папки с правом Чтение и запись. Если нужно только чтение, можно сохранить настройки без отдельных папок. Linux и macOS ограничивают чтение пользовательских файлов выбранными папками, сохраняя доступ к необходимым для команд системным ресурсам.

На Linux/macOS перед сохранением добавьте хотя бы одну папку или включите Все папки. На этих системах переключатель охватывает домашнюю папку, а не все диски; выбор прав чтения и записи становится доступен при включении. На всех системах список Выбранные папки остаётся доступен вместе с общим разрешением: можно добавлять и удалять папки, менять их отдельные права. Все эти настройки сохраняются вместе. Изменение или выключение общего доступа на Linux/macOS сохраняет отдельные папки и их права. Путь к домашней папке и пояснение о доступе остаются над режимами доступа. Ошибки и успешное сохранение показываются внутри Desktop. В фоне Desktop также запрашивает системные уведомления. В Web раскройте папки и разрешённые команды, чтобы посмотреть списки; их настройки меняются в Desktop. Неверный токен расширения браузера вызывает ошибку и остаётся в поле для исправления. Вставить его можно через контекстное меню поля. Настройки можно исправить, сохранив черновик.

Если Desktop показывает Обновите Amazi Desktop, нажмите Проверить обновления или скачайте новый установщик во вкладке Устройства. Уведомление показывает установленную и минимальную поддерживаемую версии. Пока версии несовместимы, доступ к устройству приостановлен; повторный вход это не исправит. Если требуется обновление сервера, обновите локальный сервер или обратитесь к его администратору.

Обновление Desktop

Начиная с версии 0.25.0, установленные приложения Windows и Linux проверяют обновления при запуске и периодически во время работы. Проверку также можно запустить кнопкой Проверить обновления в меню аккаунта или на экране входа. Нажмите Скачать обновление, дождитесь загрузки, затем выберите Обновить и перезапустить и подтвердите. Перед перезапуском Amazi остановит выполняемые команды и передачи файлов. Сначала сохраните несохранённые настройки. Вход в аккаунт, устройство и сохранённые настройки доступа остаются. Linux может запросить системный пароль. Обновление можно отложить: обычное закрытие приложения не запускает установку.

Для версии 0.24.0 нужно один раз вручную установить новую версию, чтобы появился этот функционал. Закройте Amazi и запустите новый установщик под той же учётной записью операционной системы, не удаляя настройки Amazi. На Debian/Ubuntu откройте новый DEB в установщике пакетов или выполните sudo apt install ./<скачанный-файл>.deb. Переносные сборки обновляются вручную. Если проверка или скачивание завершились ошибкой, продолжайте пользоваться установленной версией и повторите попытку, когда появится соединение.

Импорт и экспорт данных базы проекта

Перенос сохраняет содержимое файлов без разбора и преобразования. Для импорта в базу сначала скопируйте файл в проект, затем попросите Amazi написать и запустить парсер под конкретную задачу в среде проекта. Для экспорта сначала подготовьте и проверьте файл в среде проекта, затем скопируйте его на устройство. Файлы, уже находящиеся в проекте, можно обработать без Desktop; см. База данных и хранилище.

Укажите таблицу или запрос, путь к файлу проекта и способ импорта. Добавление строк, обновление совпадающих, замена строк и восстановление базы имеют разные последствия. Разработка и продакшен используют общую базу; подтвердите существенные изменения после уточнения их объёма. См. База данных и хранилище.

Дождитесь завершения перед использованием результата. Начало переноса ещё не означает успех. Отмена или ошибка могут прервать работу; при неопределённом результате попросите Amazi проверить состояние перед повтором. Для переноса файлов с вашего устройства или на него нужно подключённое устройство с доступом к нужным папкам.