用途：通过命令行访问本机 Apple iCloud 数据，主要覆盖照片图库管理与 iMessage 历史查询两类场景。
主要能力：photos 子命令可查看图库总量与大小统计（stats）、按媒体类型和年份的存储分布（storage）、最占空间的文件（top）、最大视频列表（videos）、将项目移到“最近删除”（delete，需 --confirm），以及把原图导出到本地目录（download）。messages 子命令可直接读取 ~/Library/Messages/chat.db，支持列出会话（list-chats）、全文搜索消息正文（search）、统计消息/会话/联系人（stats）和将会话导出为 JSON（export）。
使用方式：先安装并验证。安装命令为 npx -y @mvanhorn/printing-press-library install icloud --cli-only，验证用 icloud-pp-cli --version；若 npx 失败可用 go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/icloud/cmd/icloud-pp-cli@latest。使用前先运行 icloud-pp-cli doctor 做预检。任意命令加 --agent 可切换为 JSON、无颜色、紧凑输出，便于管道处理；命令也会在检测到管道时自动输出 JSON。
适用场景：定位并清理大文件、分析图库存储构成、导出原图、检索和导出 iMessage 对话用于后续处理。
限制：仅面向 macOS；messages 子命令需要为终端授予完全磁盘访问权限（Full Disk Access），否则会报错；照片操作依赖 Photos.app 及图库路径，非默认位置可用 --library 指定；删除操作需 --confirm。其他平台支持与收费情况暂未提供。