Himalaya

Himalaya CLI：通过终端使用 IMAP/SMTP 收发邮件。

技能元数据

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

参考：完整的 SKILL.md

정보

以下是在触发此技能时 Hermes 加载的完整技能定义。这是技能激活时 Agent 看到的指令。

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"  # 或使用 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+ 语法）。当服务器的文件夹名称与 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 以非零退出。 任何在该退出码上重试的调用者（Agent、脚本、用户）都会重新执行整个发送过程 ——包括 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

列出邮件

列出收件箱（默认）中的邮件：

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/^$/\n您的回复内容放在这里\n/' | himalaya template send

或者手动构建回复：

cat << 'EOF' | himalaya template send
From: you@example.com
To: sender@example.com
Subject: Re: 原始主题
In-Reply-To: <原始邮件ID>

在此处填写回复内容。
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: 测试邮件

来自 Himalaya 的问候！
EOF

或者使用标题标志：

himalaya message write -H "To:recipient@example.com" -H "Subject:测试" "邮件正文在此"

注意：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、系统钥匙串或能输出密码的命令安全存储密码。