PhoneBase 文档

简体中文

English

简体中文

English

主题

安装 ​

系统要求 ​

要求说明
操作系统macOS (Apple Silicon / Intel)、Linux (x86_64 / arm64)、Windows (x86_64)
Gitpb skills new 脚手架需要
Node.js可选，仅在通过 npx 安装 skills 时需要
网络需要能访问 GitHub（安装和更新）

安装 ​

bash
curl -fsSL https://get.phonebase.cloud | sh
bash
curl -fsSL https://get.phonebase.cloud | sh
bash
# 从 GitHub Releases 下载：
# https://github.com/phonebase-cloud/phonebase-cli/releases
# 重命名为 pb.exe 并加入 PATH

预期输出：

  PhoneBase CLI Installer
  ───────────────────────

  Version:    v1.0.5
  Platform:   macos-arm64
  Install to: /usr/local/bin

  Downloading...
  ✓ Installed: /usr/local/bin/pb

  Get started:

    pb login          # Login via browser
    pb apikey <key>   # Or set API Key
    pb devices        # List devices

手动安装

从 GitHub Releases 下载对应平台的二进制文件，赋予执行权限后移动到 PATH 目录。

可用版本：

  • phonebase-v{version}-macos-arm64 — macOS Apple Silicon (M1/M2/M3/M4)
  • phonebase-v{version}-macos-x64 — macOS Intel
  • phonebase-v{version}-linux-x64 — Linux x86_64
  • phonebase-v{version}-linux-arm64 — Linux ARM64
  • phonebase-v{version}-windows-x64.exe — Windows x86_64
bash
chmod +x phonebase-v*
sudo mv phonebase-v*-macos-arm64 /usr/local/bin/pb

验证 ​

bash
pb --version

预期输出：

PhoneBase CLI 1.0.5

升级 ​

bash
pb update

有新版本时的输出：

当前版本: 1.0.3

✓ 最新版本: 1.0.5 (2026-04-09  3.2 MB  macos-arm64)

  Changelog:
    ...

是否更新？ (Y/n) Y

正在下载 phonebase-v1.0.5-macos-arm64...

更新成功！当前版本: 1.0.5

已是最新时的输出：

当前版本: 1.0.5

当前版本: 1.0.5，已是最新

卸载 ​

bash
sudo rm $(which pb)
rm -rf ~/.phonebase/
bash
# 从 PATH 目录删除 pb.exe
rmdir /s /q %USERPROFILE%\.phonebase

常见问题 ​

"command not found: pb" ​

pb 不在系统 PATH 中。

bash
# 检查安装位置
which pb

# 移动到 PATH 目录
sudo mv ./pb /usr/local/bin/pb

权限不足 ​

bash
chmod +x /usr/local/bin/pb

macOS 上如果提示"无法打开，因为无法验证开发者"：

bash
xattr -d com.apple.quarantine /usr/local/bin/pb

代理 / 企业网络 ​

bash
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

Copyright © 2026 PhoneBase