Himalaya 邮件

Himalaya 是一个 CLI 邮件客户端，让你可以通过 IMAP、SMTP、Notmuch 或 Sendmail 后端从终端管理邮件。

参考资料

• references/configuration.md（配置文件设置 + IMAP/SMTP 认证）
• references/message-composition.md（撰写邮件的 MML 语法）

前置条件

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

安装

# 预编译二进制（Linux/macOS——推荐）
curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh | PREFIX=~/.local sh

# macOS 通过 Homebrew
brew install himalaya

# 或通过 cargo（任何有 Rust 的平台）
cargo install himalaya --locked

配置 Setup

运行交互式向导设置账号：

himalaya account configure

或手动创建 ~/.config/himalaya/config.toml：

[accounts.personal]
email = "you@example.com"
display-name = "Your 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"  # 或使用 keyring

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"

# 文件夹别名（himalaya v1.2.0+ 语法）
folder.aliases.inbox = "INBOX"
folder.aliases.sent = "Sent"
folder.aliases.drafts = "Drafts"
folder.aliases.trash = "Trash"

关于别名语法的注意。v1.2.0 之前的文档使用 [accounts.NAME.folder.alias] 子节（单数 alias）。v1.2.0 会静默忽略那种形式——始终使用 folder.aliases.X（复数、点分隔键、直接在 [accounts.NAME] 下）。

Hermes 集成说明

• 阅读、列表、搜索、移动、删除都可以直接通过终端工具完成
• 撰写/回复/转发——推荐使用管道输入（cat << EOF | himalaya template send）以确保可靠性
• 使用 --output json 获得结构化输出，程序化解析更方便
• himalaya account configure 向导需要交互式输入——使用 PTY 模式

常用操作

列出文件夹

himalaya folder list

列出邮件

列出 INBOX 中的邮件（默认）：

himalaya envelope list

列出特定文件夹中的邮件：

himalaya envelope list --folder "Sent"

搜索邮件

himalaya envelope list from john@example.com subject meeting

阅读邮件

按 ID 阅读邮件（显示纯文本）：

himalaya message read 42

回复邮件

cat << 'EOF' | himalaya template send
From: you@example.com
To: sender@example.com
Subject: Re: Original Subject
In-Reply-To: 

Your reply here.
EOF

写新邮件

cat << 'EOF' | himalaya template send
From: you@example.com
To: recipient@example.com
Subject: Test Message

Hello from Himalaya!
EOF

移动/复制邮件

himalaya message move 42 "Archive"
himalaya message copy 42 "Important"

删除邮件

himalaya message delete 42

多账号

himalaya account list
himalaya --account work envelope list

附件

himalaya attachment download 42
himalaya attachment download 42 --dir ~/Downloads

输出格式

himalaya envelope list --output json
himalaya envelope list --output plain

调试

RUST_LOG=debug himalaya envelope list
RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list

使用技巧

• 使用 himalaya --help 或 himalaya --help 获取详细用法。
• 消息 ID 相对于当前文件夹；文件夹变更后需重新列出。
• 要撰写带附件的富邮件，使用 MML 语法（见 references/message-composition.md）。
• 使用 pass、系统 keyring 或输出密码的命令安全存储密码。