Работа и команды

Автоматизация передачи между телефоном и ПК скриптами

Используйте командную строку pdb или SDK для TypeScript и Python, чтобы отправлять файлы, текст и ссылки на сопряжённые устройства из своих скриптов.

Доступно в превью Обновлено Работает на
  • Windows
  • Linux

Для простой автоматизации вызывайте из скрипта командную строку pdb, например pdb send <device> <file>. Для более глубокой интеграции есть SDK для TypeScript и Python: они общаются с агентом Personal Device Bridge на том же компьютере, умеют получать список устройств, отправлять файлы, текст из буфера обмена и ссылки, а также реагировать на события. В npm и PyPI SDK пока нет — их можно запросить через справочный центр.

Коротко о главном

  • Команды pdb принимают --json для машиночитаемого вывода.
  • SDK для TypeScript (@personaldevicebridge/sdk) и Python (personaldevicebridge).
  • Скрипты выполняют те же действия, что и приложение, с теми же разрешениями устройств.
  • Локальный агент доступен только вашей учётной записи пользователя.

Пошагово

  1. Запустите агент

    Его запускает приложение для ПК, либо запустите его командой pdb agent. pdb agent install запускает агент при входе в систему.

  2. Попробуйте командную строку

    pdb devices выводит сопряжённые устройства; pdb send <device> <files or folders>, pdb clip <device> "text" и pdb url <device> <address> отправляют данные.

  3. Получите SDK

    Пока пакеты не опубликованы, их и справочник по API высылают по запросу; см. Собственные интеграции с помощью SDK.

  4. Подключитесь и отправьте

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

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

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

Вопросы и ответы

Есть ли SDK в npm или PyPI?

Пока нет. Запросите пакеты и справочник по API, как описано в Собственные интеграции с помощью SDK.

Может ли скрипт на другом компьютере использовать мой агент?

Нет. Канал агента локальный и доступен только владельцу; скрипты работают на том же компьютере под вашей учётной записью.

В каких системах это работает?

Агент и pdb работают в Windows и 64-битном Linux и отправляют на любое сопряжённое устройство, включая ваш Android-телефон.