第 1 章：什么是 ipatool
先建立预期：它下载的是你账号有权获得的加密 ipa，不是破解包。
1一句话定义
ipatool 对着 App Store 搜索应用，并把安装包（ipa）下载下来。README 写明支持 iOS、iPadOS、tvOS、visionOS。
搜索
search 按关键词找应用，可指定平台。
登录
auth 用 Apple ID 登录、查看、注销。
授权
purchase 为应用获取商店许可；list-purchases 列出已购。
下载
download 拉取加密 ipa；可指定历史版本。
2它不是什么
- 不是盗版工具。官方 FAQ：不能下载你没有购买 / 未获得许可的付费应用
- 不是解密器。README 写的是下载 encrypted（加密）包
- 不是替代 TestFlight / 企业分发的商店
- 不是「用应用专用密码登录」的客户端——FAQ 明确不支持 app-specific password
3七条子命令
| 命令 | 做什么 |
|---|---|
auth | 登录、查看当前账号、注销 |
search | 按关键词搜索 |
purchase | 为指定 bundle id 获取商店许可 |
list-purchases | 列出账号已拥有的应用（v2.5.0 新增） |
list-versions | 列出可下载的版本 |
get-version-metadata | 用外部版本号查元数据 |
download | 下载加密 ipa |
新手先走：安装 →
auth login → search → download。版本和 JSON 输出放到后面。