办公与团队

用脚本自动化手机与电脑之间的传输

使用 pdb 命令行,或 TypeScript 和 Python SDK,在你自己的脚本中向已配对设备发送文件、文本和链接。

预览版可用 更新于 适用于
  • Windows
  • Linux

简单的自动化,可以在脚本中调用 pdb 命令行,例如 pdb send <device> <file>。更深入的集成,可使用 TypeScript 和 Python SDK:它们与同一台电脑上的 Personal Device Bridge 代理程序通信,能列出设备,发送文件、剪贴板文本和链接,并响应事件。SDK 尚未发布到 npm 或 PyPI,目前需通过帮助中心申请。

要点速览

  • pdb 命令支持 --json,输出机器可读的结果。
  • 提供 TypeScript(@personaldevicebridge/sdk)和 Python(personaldevicebridge)SDK。
  • 脚本使用与应用相同的操作,受相同的设备权限约束。
  • 只有你自己的用户账户能访问本地代理程序。

操作步骤

  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 上吗?

暂时还没有。请按照 使用 SDK 构建自己的集成 中的说明申请软件包和 API 参考文档。

另一台电脑上的脚本能使用我的代理程序吗?

不能。代理程序的通道仅限本机且仅限所有者使用;脚本需在同一台电脑上、以你的用户账户运行。

支持哪些系统?

代理程序和 pdb 可在 Windows 和 64 位 Linux 上运行,并能发送到任何已配对设备,包括你的安卓手机。