文件操作

推送文件

pb push <path> [--dest <dest>]

推送文件到设备。支持本地文件和 URL。

参数	类型	必填	说明
path	string	是	本地文件路径或 HTTP(S) URL
--dest	string	视情况	设备上的目标路径

路由策略

输入类型	--dest	行为
http:// / https:// URL	必须提供	设备自行下载文件（走 file/download）
本地文件	可选	shell 分块上传。默认目标：/sdcard/Download/<文件名>
本地文件	以 / 结尾	保留原始文件名，拼接到目录路径

WARNING

推送 URL 时必须提供 --dest 来指定设备上的保存路径。

示例：

# 推送本地文件（默认目标：/sdcard/Download/photo.jpg）
pb push ./photo.jpg

# 推送到指定位置
pb push ./photo.jpg --dest /sdcard/Pictures/photo.jpg

# 推送到目录（保留文件名）
pb push ./photo.jpg --dest /sdcard/Pictures/

# 推送 URL（设备自行下载）
pb push https://example.com/file.zip --dest /sdcard/Download/file.zip

Text

✓ 已推送到 /sdcard/Download/photo.jpg (102400 bytes)

JSON

{
  "code": 200,
  "data": { "path": "/sdcard/Download/photo.jpg", "size": 102400 },
  "msg": "已推送到 /sdcard/Download/photo.jpg (102400 bytes)"
}

拉取文件

pb pull <path>

从设备拉取文件到本地。

参数	类型	必填	说明
path	string	是	设备上的文件路径

示例：

pb pull /sdcard/Download/screenshot.png

执行命令

pb shell <command>

在设备上执行 shell 命令。

参数	类型	必填	说明
command	string	是	要执行的 shell 命令

示例：

# 列出已安装包
pb shell "pm list packages"

# 获取系统属性
pb shell "getprop ro.build.version.release"

# 查看磁盘使用
pb shell "df -h"

Text

package:com.android.chrome
package:com.android.settings

JSON

{
  "code": 200,
  "data": {
    "output": "package:com.android.chrome\npackage:com.android.settings\n",
    "exit_code": 0
  },
  "msg": "OK"
}

列出文件

pb ls <path>

列出设备上的文件。

参数	类型	必填	说明
path	string	是	设备上的目录路径

示例：

pb ls /sdcard/Download/