用途：通过命令行整理 Gmail，包括标签增删、归档、已读/未读、加星、移入或恢复回收站，以及管理标签列表。
主要能力：Gmail 没有文件夹，一切状态都是标签。modify 提供可读动词并执行底层编辑：archive 移除 INBOX，unarchive 添加 INBOX，read/unread 移除/添加 UNREAD，star/unstar 添加/移除 STARRED，spam/unspam 添加/移除 SPAM。--action 可重复，并与 --add、--remove 组合。标签按名称（不区分大小写）或 id 解析；不存在的名称会报错而非静默跳过，需创建时加 --create。嵌套标签用斜杠，如 clients/acme。--thread 把 id 视为线程 id，作用于会话中所有邮件。
用法示例：gmail label list | create <name> | delete <name>；gmail modify <id...> [--add L] [--remove L] [--action archive|read|star|...] [--trash] [--untrash] [--thread] [--create] [--dry-run]。--json 输出 Envelope，modify 可一次接收多个 id。批量操作建议先搜索再对 id 执行，并用 --dry-run 预演，确认标签增删与数量后再实际运行。
限制：--trash 移入回收站，Gmail 保留 30 天，--untrash 可恢复；没有永久删除命令，如需彻底删除应让用户在 Gmail 中自行清空回收站。删除用户标签会从所有邮件移除该标签，但不会删除邮件；系统标签（INBOX、UNREAD、STARRED）不可删除。创建已存在的标签会报告 exists，不算错误。不应自行决定哪些邮件该归档或删除，分拣规则来自用户。命令失败时查看 error.hint，认证类问题运行 gmail doctor。