用途：说明如何在开发阶段构建并运行 Mail CLI。CLI 工作区位于仓库根目录下的 services/cli/，仓库没有顶层 Cargo.toml，因此需进入该目录或使用 --manifest-path。
构建：可在仓库任意位置执行 cargo build --manifest-path services/cli/Cargo.toml，或进入工作区后执行 cd services/cli && cargo build。
二进制目标：mail-cli 对应 cli/，是纯 CLI 二进制；mail-app 对应 app/，是 CLI 与 TUI 合并的二进制。
运行命令：不在 services/cli/ 内时始终传 --manifest-path，例如 cargo run --manifest-path services/cli/Cargo.toml --bin mail-cli -- <args>；在工作区内可执行 cargo run --bin mail-cli -- <args>。
全局参数放在子命令之前：--server <url>（环境变量 MAIL_SERVER，gRPC 后端地址）、--format <table|json>（输出格式，默认 table）、--auth-backend <auto|keyring|file>（环境变量 MAIL_AUTH_BACKEND，令牌存储后端）、-v/--verbose（启用调试日志）。
子命令：auth 提供 login（OAuth 设备流登录）、status（显示认证状态与后端）、logout（清除已存令牌）；accounts 提供 list、get --provider <google|outlook>、delete --provider <google|outlook>；emails 提供 folders、list、read、body，均需 --provider、--email，list/read/body 还需 --folder 与 --uid；sync 提供 status、trigger、history，均需 --account-id；threads 提供 list 与 get，需 --account-id，get 还需 --thread-id。
测试认证后端：默认 auto 先尝试 keyring，失败回退 file；可用 --auth-backend file 强制文件存储，用 --auth-backend keyring 强制 keyring（不可用时报错），加 -v 可查看后端选择。
常见问题：提示 could not find Cargo.toml 说明不在 services/cli/，需用 --manifest-path services/cli/Cargo.toml；Keyring write failed: locked collection 表示 GNOME Keyring 被锁，可改用 --auth-backend file 或解锁；Could not open browser 出现在无头或 SSH 会话，需手动复制打印出的 URL。