himalaya¶

Skill 简介¶

himalaya 是一个功能强大的命令行界面（CLI）电子邮件客户端，旨在帮助开发者通过终端高效地管理电子邮件。它支持 IMAP 和 SMTP 协议，并提供与 Notmuch 或 Sendmail 后端的集成，使得用户可以在终端环境下完成邮件的查看、撰写、回复、转发、搜索和组织等操作。himalaya 的设计理念是简化电子邮件管理流程，让用户无需依赖图形界面即可完成复杂的邮件操作，特别适合那些习惯使用终端进行日常工作的开发者。

通过 himalaya，用户可以轻松管理多个电子邮件账户，并使用 MIME Meta Language（MML）进行邮件撰写，从而实现更灵活和个性化的邮件内容编辑。此外，himalaya 还支持多种输出格式和调试选项，使得开发者可以更方便地集成和扩展其功能。

主要功能¶

himalaya 提供了丰富的功能，以下是其中几个核心功能的详细介绍：

1. 多账户管理¶

himalaya 支持同时管理多个电子邮件账户，用户可以通过简单的命令在不同账户之间切换。例如，用户可以列出所有配置的账户：

himalaya account list

并使用特定账户执行操作：

himalaya --account work envelope list

2. 邮件操作¶

himalaya 提供了全面的邮件操作功能，包括：

列出邮件：用户可以列出指定文件夹中的邮件，例如收件箱或已发送邮件：

bash himalaya envelope list --folder "Inbox" himalaya envelope list --folder "Sent"

搜索邮件：用户可以根据发件人、主题等条件搜索邮件：

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

阅读邮件：用户可以读取指定 ID 的邮件内容：

bash himalaya message read 42

回复和转发邮件：用户可以使用交互式编辑器回复或转发邮件：

bash himalaya message reply 42 himalaya message forward 42

3. 邮件撰写与发送¶

himalaya 支持使用 MML 语法撰写复杂的邮件，包括添加附件和自定义邮件头。用户可以通过以下命令启动交互式撰写流程：

himalaya message write

或者直接通过命令行发送邮件：

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

4. 附件管理¶

himalaya 提供了便捷的附件下载功能，用户可以下载指定邮件的所有附件，并选择保存目录：

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

5. 输出格式与调试¶

himalaya 支持多种输出格式，如 JSON 和纯文本，方便用户在不同场景下使用。此外，himalaya 还提供了强大的调试功能，用户可以通过设置环境变量来启用详细日志：

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

使用场景¶

himalaya 适用于多种开发和管理场景，以下是几个典型的使用场景：

1. 终端邮件管理¶

对于习惯使用终端进行日常工作的开发者，himalaya 提供了一个高效的方式来管理电子邮件，无需切换到图形界面。

2. 自动化脚本集成¶

himalaya 可以方便地集成到自动化脚本中，用于定期检查邮件、发送通知或处理特定类型的邮件。

3. 多账户邮件管理¶

对于需要管理多个电子邮件账户的用户，himalaya 提供了简洁的命令行接口，使得在不同账户之间切换和操作变得非常简单。

4. 邮件备份与归档¶

用户可以使用 himalaya 的邮件操作功能，定期备份和归档重要邮件，确保数据的安全和可访问性。

5. 邮件自动化处理¶

himalaya 的搜索和过滤功能可以帮助用户自动处理特定类型的邮件，例如自动标记、转发或删除。

如何使用¶

安装¶

himalaya 可以通过多种方式安装，以下是使用 Homebrew 安装的示例：

brew install himalaya

配置¶

在首次使用之前，需要配置 himalaya。可以通过交互式向导进行配置：

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 CLI 并验证版本：

bash himalaya --version

配置 ~/.config/himalaya/config.toml 文件。
确保 IMAP/SMTP 凭证已正确配置，密码应安全存储。

示例¶

示例 1：发送邮件¶

以下示例展示了如何使用 himalaya 发送一封简单的邮件：

himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Hello from Himalaya!"

示例 2：管理邮件¶

以下示例展示了如何列出邮件、阅读邮件并回复邮件：

# 列出收件箱中的邮件
himalaya envelope list --folder "Inbox"

# 读取指定 ID 的邮件
himalaya message read 42

# 回复邮件
himalaya message reply 42

总结¶

himalaya 是一个功能全面且易于使用的命令行电子邮件客户端，专为开发者设计。它不仅支持多账户管理和丰富的邮件操作功能，还提供了灵活的输出格式和强大的调试选项。通过 himalaya，开发者可以在终端环境下高效地管理电子邮件，提升工作效率。无论是日常邮件处理还是自动化脚本集成，himalaya 都能满足用户的多样化需求。对于那些希望在终端环境下获得更强大邮件管理能力的开发者来说，himalaya 是一个理想的选择。