Himalaya 电子邮件命令行客户端

Himalaya 是一款命令行电子邮件客户端，可让您通过终端使用 IMAP、SMTP、Notmuch 或 Sendmail 后端管理电子邮件。

参考文档

• - references/configuration.md（配置文件设置 + IMAP/SMTP 身份验证）
• references/message-composition.md（编写电子邮件的 MML 语法）

前提条件

1. 1. 已安装 Himalaya CLI（运行 himalaya --version 验证）
2. 配置文件位于 ~/.config/himalaya/config.toml
3. 已配置 IMAP/SMTP 凭据（密码安全存储）

配置设置

运行交互式向导设置账户：
bash
himalaya account configure

或手动创建 ~/.config/himalaya/config.toml：
toml
[accounts.personal]
email = you@example.com
display-name = 您的姓名
default = true

backend.type = imap
backend.host = imap.example.com
backend.port = 993
backend.encryption.type = tls
backend.login = you@example.com
backend.auth.type = password
backend.auth.cmd = pass show email/imap # 或使用密钥环

message.send.backend.type = smtp
message.send.backend.host = smtp.example.com
message.send.backend.port = 587
message.send.backend.encryption.type = start-tls
message.send.backend.login = you@example.com
message.send.backend.auth.type = password
message.send.backend.auth.cmd = pass show email/smtp

常用操作

列出文件夹

bash
himalaya folder list

列出电子邮件

列出收件箱中的电子邮件（默认）：
bash
himalaya envelope list

列出特定文件夹中的电子邮件：
bash
himalaya envelope list --folder 已发送

分页列出：
bash
himalaya envelope list --page 1 --page-size 20

搜索电子邮件

bash
himalaya envelope list from john@example.com subject meeting

阅读电子邮件

按 ID 阅读电子邮件（显示纯文本）：
bash
himalaya message read 42

导出原始 MIME：
bash
himalaya message export 42 --full

回复电子邮件

交互式回复（打开 $EDITOR）：
bash
himalaya message reply 42

回复全部：
bash
himalaya message reply 42 --all

转发电子邮件

bash
himalaya message forward 42

编写新电子邮件

交互式撰写（打开 $EDITOR）：
bash
himalaya message write

使用模板直接发送：
bash
cat << EOF | himalaya template send
From: you@example.com
To: recipient@example.com
Subject: 测试消息

来自 Himalaya 的问候！
EOF

或使用头部标志：
bash
himalaya message write -H To:recipient@example.com -H Subject:测试 消息正文内容

移动/复制电子邮件

移动到文件夹：
bash
himalaya message move 42 归档

复制到文件夹：
bash
himalaya message copy 42 重要

删除电子邮件

bash
himalaya message delete 42

管理标志

添加标志：
bash
himalaya flag add 42 --flag seen

移除标志：
bash
himalaya flag remove 42 --flag seen

多账户管理

列出账户：
bash
himalaya account list

使用特定账户：
bash
himalaya --account work envelope list

附件管理

保存邮件中的附件：
bash
himalaya attachment download 42

保存到特定目录：
bash
himalaya attachment download 42 --dir ~/Downloads

输出格式

大多数命令支持 --output 参数实现结构化输出：
bash
himalaya envelope list --output json
himalaya envelope list --output plain

调试

启用调试日志：
bash
RUST_LOG=debug himalaya envelope list

带回溯的完整跟踪：
bash
RUSTLOG=trace RUSTBACKTRACE=1 himalaya envelope list

使用技巧

• - 使用 himalaya --help 或 himalaya --help 查看详细用法。
• 消息 ID 相对于当前文件夹；切换文件夹后需重新列出。
• 如需编写包含附件的富文本邮件，请使用 MML 语法（参见 references/message-composition.md）。
• 使用 pass、系统密钥环或输出密码的命令安全存储密码。