用途
Himalaya 是一款命令行电子邮件客户端，让用户可以在终端中通过 IMAP、SMTP、Notmuch 或 Sendmail 后端管理邮件。它适用于希望在终端内完成收件、读信、发信、回复、转发、搜索和整理等邮件操作的用户。
主要能力
- 邮件与文件夹管理：列出文件夹、列出邮件、按文件夹列出邮件、分页列出。
- 搜索：可按发件人、主题等条件搜索邮件。
- 读取与导出：按 ID 读取邮件纯文本内容，或导出原始 MIME。
- 撰写与发送：交互式撰写（打开 $EDITOR）、使用模板直接发送，或通过 headers 标志指定收件人与主题。
- 回复与转发：支持回复、回复全部和转发。
- 整理：移动、复制、删除邮件，以及添加或移除标记（如 seen）。
- 多账户：可列出账户，并通过 --account 指定使用某个账户。
- 附件：下载邮件附件，可指定保存目录。
- 输出格式：多数命令支持 --output，可输出 json 或 plain 等结构化结果。
- 调试：通过 RUST_LOG 环境变量启用调试日志，结合 RUST_BACKTRACE 获取回溯信息。
使用方式
前置条件：已安装 Himalaya CLI（可用 himalaya --version 验证）；存在 ~/.config/himalaya/config.toml 配置文件；已配置 IMAP/SMTP 凭据并安全存储密码。
配置：可运行交互式向导 himalaya account configure 设置账户，或手动创建 ~/.config/himalaya/config.toml。配置示例中需填写账户邮箱、显示名、默认账户、IMAP 后端的主机、端口、加密类型、登录名与认证方式，以及 SMTP 发送后端的主机、端口、加密类型、登录名与认证方式。认证命令可使用 pass 或系统 keyring 等方式提供密码。
常见操作示例：
- 列出文件夹：himalaya folder list
- 列出 INBOX 邮件：himalaya envelope list
- 列出指定文件夹邮件：himalaya envelope list --folder "Sent"
- 分页列出：himalaya envelope list --page 1 --page-size 20
- 搜索：himalaya envelope list from john@example.com subject meeting
- 读取邮件：himalaya message read 42
- 导出原始 MIME：himalaya message export 42 --full
- 回复：himalaya message reply 42；回复全部加 --all
- 转发：himalaya message forward 42
- 交互式撰写：himalaya message write
- 模板发送：通过 himalaya template send 从标准输入提供 From、To、Subject 和正文
- 带 headers 撰写：himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"
- 移动：himalaya message move 42 "Archive"
- 复制：himalaya message copy 42 "Important"
- 删除：himalaya message delete 42
- 添加标记：himalaya flag add 42 --flag seen
- 移除标记：himalaya flag remove 42 --flag seen
- 列出账户：himalaya account list
- 指定账户：himalaya --account work envelope list
- 下载附件：himalaya attachment download 42；指定目录加 --dir ~/Downloads
- 结构化输出：himalaya envelope list --output json
- 调试：RUST_LOG=debug himalaya envelope list；完整回溯：RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list
适用场景
适合在终端环境中处理邮件的用户，例如需要通过脚本或命令行完成邮件列表、检索、回复、转发、整理与附件下载的场景；也适合使用多账户、需要通过配置文件与安全凭据管理认证的用户。
限制与提示
资料未提供收费、价格、平台限制或具体效果等信息，暂未提供。使用前需确保已安装 CLI 并完成配置文件与凭据设置；邮件 ID 相对于当前文件夹，切换文件夹后需重新列出；撰写带附件的富文本邮件需使用 MML 语法（参考 references/message-composition.md）；密码应通过 pass、系统 keyring 或能输出密码的命令安全保存。可使用 himalaya --help 或 himalaya <command> --help 查看详细用法。