蒲公英 CLI
蒲公英官方命令行工具 @pgyer/cli 的功能概览，涵盖应用上传、应用与历史版本管理、账户认证及自动化集成。
@pgyer/cli 是蒲公英官方命令行工具，您可以在终端中上传安装包、查询和管理应用及历史版本，也可以将这些操作接入构建脚本、CI/CD 流水线或 AI 助手。
本文提供功能概览与常用示例，完整命令、参数及版本信息请查看 npm 软件包页面。
如需选择 API、CLI、CI/CD 插件、MCP 或 Agent Skill，请先查看 自动上传 App 与 CI/CD 集成指南。
功能概览
| 功能 | 可以完成的操作 |
|---|---|
| 应用上传 | 通过快速上传 API 上传 IPA、APK、HAP，设置更新说明、安装方式和渠道等发布选项 |
| 应用管理 | 查看应用列表和详情、通过短链接查找应用、修改应用设置或删除应用 |
| 历史版本管理 | 查询历史版本、检查更新、设置或取消最新版本标记、删除指定版本 |
| 上传状态跟踪 | 默认等待发布处理完成，也可异步上传后单独查询或等待处理结果 |
| 账户认证 | 浏览器登录、查看认证状态、退出登录，以及通过 API Key 接入自动化环境 |
| 脚本与自动化 | 通过 --json 输出便于程序解析的结果，部分修改操作支持用 --dry-run 预览 |
安装
环境要求：Node.js >= 18.0.0。
npm install -g @pgyer/cli快速上手
登录账号
本地开发可通过浏览器完成授权：
pgyer auth login在 CI/CD 环境中，通过环境变量传入 API Key 即可：
export PGYER_API_KEY=YOUR_API_KEY上传应用
pgyer upload ./app-release.apk支持 .apk、.ipa、.hap 格式。
查询应用与历史版本
# 查看应用列表
pgyer apps list
# 查看应用详情
pgyer apps info YOUR_APP_KEY
# 查看应用的历史版本
pgyer versions list YOUR_APP_KEY将 YOUR_APP_KEY 替换为目标应用的 App Key。需要在脚本中处理结果时，可添加 --json，例如 pgyer apps list --json。
更多用法
应用设置、渠道上传、异步任务、版本管理等完整示例，请查看 npm 上的 CLI 使用说明。本地也可运行 pgyer --help 查看命令列表，或运行 pgyer upload --help 查看某个命令的参数。具体能力以您安装的版本为准。