Himalaya

Himalaya CLI: 终端中的 IMAP/SMTP 邮件客户端。

技能元数据

来源	内置（默认安装）
路径	skills/email/himalaya
版本	1.1.0
作者	社区
许可证	MIT
平台	linux, macos, windows
标签	Email, IMAP, SMTP, CLI, Communication

参考：完整的 SKILL.md

信息

以下是当此技能被触发时，Hermes 加载的完整技能定义。这是技能激活时智能体所看到的指令。

Himalaya 邮件 CLI

Himalaya 是一个 CLI 邮件客户端，允许您使用 IMAP、SMTP、Notmuch 或 Sendmail 后端从终端管理电子邮件。

参考资料

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

先决条件

1. 已安装 Himalaya CLI（运行 himalaya --version 以验证）
2. 配置文件位于 ~/.config/himalaya/config.toml
3. 已配置 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

配置设置

运行交互式向导来设置账户：

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"  # 或使用密钥环

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+ 语法）。当服务器的文件夹名称
# 与 himalaya 的规范名称（inbox/sent/drafts/trash）不匹配时是必需的。
# Gmail 是常见情况——请参阅 `references/configuration.md` 中关于
# `[Gmail]/Sent Mail` 的映射。
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 会静默忽略该形式 — TOML 解析正常，但别名解析器 从不读取它，因此每次查找都会回退到规范名称。在 Gmail 上， 这意味着保存到“已发送”会在 SMTP 投递成功 之后 失败， 并且 himalaya message send 会以非零状态退出。 任何基于该退出码进行重试的调用方（智能体、脚本、用户） 都会重新运行整个发送过程 — 包括 SMTP — 从而导致收件人 收到重复的邮件。请务必使用 folder.aliases.X（复数、点分键， 直接位于 [accounts.NAME] 下）。

Hermes 集成说明

• 读取、列出、搜索、移动、删除 都可以直接通过终端工具完成
• 撰写/回复/转发 — 建议使用管道输入（cat << EOF | himalaya template send）以确保可靠性。交互式的 $EDITOR 模式在 pty=true + 后台 + 进程工具下可行，但需要了解编辑器及其命令
• 使用 --output json 获取结构化输出，便于程序解析
• himalaya account configure 向导需要交互式输入 — 请使用 PTY 模式：terminal(command="himalaya account configure", pty=true)

常见操作

列出文件夹

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

读取邮件

通过 ID 读取邮件（显示纯文本）：

himalaya message read 42

导出原始 MIME：

himalaya message export 42 --full

回复邮件

要从 Hermes 非交互式地回复，请读取原始邮件，撰写回复，并通过管道传递：

# 获取回复模板，编辑它，然后发送
himalaya template reply 42 | sed 's/^$/\nYour reply text here\n/' | himalaya template send

或手动构建回复：

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

Your reply here.
EOF

回复全部（交互式 — 需要 $EDITOR，请改用上述模板方法）：

himalaya message reply 42 --all

转发邮件

# 获取转发模板并通过管道传递修改后的内容
himalaya template forward 42 | sed 's/^To:.*/To: newrecipient@example.com/' | himalaya template send

撰写新邮件

非交互式（从 Hermes 使用此方式） — 通过 stdin 管道传递消息：

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

Hello from Himalaya!
EOF

或使用 headers 标志：

himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"

注意：不带管道输入的 himalaya message write 会打开 $EDITOR。这在 pty=true + 后台模式下可行，但管道方式更简单可靠。

移动/复制邮件

移动到文件夹：

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

保存到特定目录：

himalaya attachment download 42 --dir ~/Downloads

输出格式

大多数命令支持 --output 以获得结构化输出：

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 <command> --help 获取详细用法。
• 邮件 ID 相对于当前文件夹；在文件夹更改后需要重新列出。
• 要撰写带附件的富文本邮件，请使用 MML 语法（参见 references/message-composition.md）。
• 使用 pass、系统密钥环或输出密码的命令来安全存储密码。