用途：pp-gmail 用于安全地理解和清理 Gmail 邮箱，适合智能体或运维人员做分类摘要、发件人与存储分析、批量移入垃圾箱或打标签，以及一键退订并跟进验证。它不能撰写、发送、回复、转发或起草邮件，也不能永久删除邮件或清空垃圾箱，不能删除标签，不能管理 Gmail 设置、过滤器、转发或休假回复，线程为只读。
安装：先安装 CLI，默认二进制位于 macOS/Linux 的 $HOME/.local/bin 或 Windows 的 %LOCALAPPDATA%\Programs\PrintingPress\bin： npx -y @mvanhorn/printing-press-library install gmail --cli-only 验证：gmail-pp-cli --version 若 npx 安装失败，可用 Go 1.26.5 或更新版本直接安装： go install github.com/mvanhorn/printing-press-library/library/productivity/gmail/cmd/gmail-pp-cli@latest
主要能力：本地智能报告包括 delta（自上次检查以来的新邮件）、storage report（存储占用排名）、trash report（垃圾箱中剩余撤销天数）、score（卫生指标）、sort suggest（按既有打标签历史建议归类）。清理流程为 cleanup plan → cleanup apply，可用 undo --ledger <id> 撤销；rules 支持命名本地清理配方；unsub audit|plan|run|verify 支持一键退订与验证。
用法：任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes。可用 --select 筛选字段，--dry-run 预览请求。认证使用已安装应用 OAuth 与多账号配置，仅请求 gmail.modify 范围。运行 gmail-pp-cli doctor 检查设置。路径可用 --home 或 GMAIL_HOME 等环境变量重定位。
限制：发送、草稿、设置和永久删除在二进制中不存在；标签仅支持创建和重命名；线程不可变更；mailto 退订仅列为待办，不执行。一键退订要求退订 URL 主机与发件人可注册域一致，第三方托管目标默认跳过，除非使用 --allow-third-party。