技能使用指南

himalaya（himalayaSkill）Skill 是什么？怎么用？

himalayaSkill 是一款在终端通过 IMAP/SMTP 管理邮件的命令行工具，支持多账户、搜索、回复转发、附件下载与 JSON 结构化输出。本文讲清安装步骤、配置方法、常用命令示例、竞品对比与典型应用场景，帮你快速上手命令行收发邮件，提升日常邮件处理效率。

himalayaSkillhimalaya
8 个章节 约 17 分钟阅读 AI 智能生成

himalayaSkill：在终端里用命令行高效收发与管理邮件

  • 一句话定位：himalayaSkill（英文名 himalaya）是一个通过 IMAP/SMTP 在终端中管理电子邮件的命令行界面工具，让你不离开命令行就能列出、阅读、撰写、回复、转发、搜索和整理邮件。
  • 核心能力：支持多账户、MML（MIME Meta Language）富邮件撰写、附件下载、标志（flag）管理、结构化输出（JSON/plain）与调试日志。
  • 安装方式：技能元数据提供了 brew 安装路径（公式 himalaya），安装后用 himalaya --version 验证。
  • 使用门槛：需要先准备 IMAP/SMTP 账户凭证并完成配置文件（~/.config/himalaya/config.toml），之后所有操作都是一条命令。
  • 适合谁用：长期在终端里工作的开发者、运维人员、需要管理多个邮箱账户的效率工具用户，以及希望把邮件处理接入脚本与自动化流程的团队。

1. 该技能叫什么？如何下载安装 AI 技能提升开发效率？

基本信息

项目 内容
技能中文名 himalayaSkill
技能英文名 himalaya
技能 ID 13586
官方主页 https://github.com/pimalaya/himalaya
依赖二进制 himalaya

它解决什么问题

日常开发中，邮件往往是最容易打断心流的一环：需要切换到浏览器或图形客户端，登录多个账号，翻找某封邮件，下载附件，再回到终端继续写代码。himalayaSkill 的思路是把整套邮件操作搬到终端里，用一条条命令完成收发与整理，并且可以和其他命令行工具、脚本串联起来。对习惯键盘操作的人来说，这能显著减少上下文切换成本。

一键安装的思路与步骤

  1. 确认前提：你需要一个支持 IMAP/SMTP 的邮箱账户，以及可用的包管理器（技能元数据中给出的是 brew 方式）。
  2. 安装技能所需二进制：技能元数据中提供的安装入口为 brew，公式名为 himalaya，安装后得到的二进制文件同样是 himalaya。若你的系统没有 brew，可参考官方主页 https://github.com/pimalaya/himalaya 上的其他安装方式，具体命令与支持平台以官方说明为准。
  3. 验证是否生效：安装完成后执行 himalaya --version，能正常输出版本号即表示安装成功。
  4. 完成账户配置：运行交互式配置向导 himalaya account configure，按提示填写邮箱地址、IMAP/SMTP 服务器、端口、加密方式与认证信息；也可以手动创建 ~/.config/himalaya/config.toml。
  5. 验证配置是否可用：执行 himalaya folder list 或 himalaya envelope list，如果能看到邮箱文件夹或收件箱邮件列表，说明安装与配置全部打通。

关于凭证安全：技能说明中明确建议不要把密码明文写入配置，而是通过 pass、系统密钥环，或执行命令输出密码的方式（配置项 backend.auth.cmd / message.send.backend.auth.cmd）来安全存储与读取密码。

2. 该技能的主要功能和特点

  • 多后端支持：可使用 IMAP、SMTP、Notmuch 或 Sendmail 作为后端，既能连接主流邮箱服务商，也能适配本地邮件存储方案。
  • 完整的邮件生命周期操作：列出文件夹（folder list）、分页列出邮件（envelope list）、按条件搜索、阅读（message read）、导出原始 MIME（message export --full）、回复（message reply）、回复全部（--all）、转发（message forward）、撰写新邮件（message write）、移动与复制、删除、标记已读等。
  • 搜索能力内建：可以直接在命令行里按发件人、主题等字段组合筛选，例如按发件人与主题关键词查询，省去在图形界面里反复点击筛选条件。
  • 多账户管理：通过 account list 查看所有账户，用 --account <名称> 在单条命令中切换账户，无需反复登录退出。
  • MML 富邮件撰写：支持 MML（MIME Meta Language）语法撰写带附件的丰富邮件，比纯文本拼接更可控；与 $EDITOR 集成，交互式撰写体验接近本地编辑器。
  • 模板化发送：可以通过标准输入直接投递一封完整邮件（含 From/To/Subject），非常适合脚本化、批量化发送通知。
  • 结构化输出：多数命令支持 --output json 与 --output plain，便于被 jq、Python 脚本等消费，天然适合自动化流水线。
  • 可观测性与排错：通过 RUST_LOG=debug 或 RUST_LOG=trace RUST_BACKTRACE=1 打开调试与完整追踪日志，排查连接、认证问题更方便。

和普通工具比强在哪：图形邮件客户端功能全面，但无法被脚本调用；自己写 IMAP 脚本灵活，但要处理协议细节和认证。himalaya 把二者之间的空档补上了：开箱即用的完整命令集 + 结构化输出 + 多账户，既适合人直接敲，也适合机器调用。

3. 如何使用该技能？

第 1 步：检查安装

himalaya --version

第 2 步：配置账户

推荐使用交互式向导：

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"

第 3 步：查看文件夹与邮件列表

himalaya folder list
himalaya envelope list
himalaya envelope list --folder "已发送"
himalaya envelope list --page 1 --page-size 20

第 4 步：搜索邮件

himalaya envelope list from john@example.com subject meeting

第 5 步：阅读与导出邮件

himalaya message read 42
himalaya message export 42 --full

第 6 步：回复与转发

himalaya message reply 42
himalaya message reply 42 --all
himalaya message forward 42

第 7 步：撰写新邮件

交互式撰写（会打开 $EDITOR）：

himalaya message write

用模板直接发送：

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

Hello from Himalaya!
EOF

或用标题参数一次性指定收件人与主题：

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

第 8 步：整理邮件（移动、复制、删除、标志）

himalaya message move 42 "存档"
himalaya message copy 42 "重要"
himalaya message delete 42
himalaya flag add 42 --flag seen
himalaya flag remove 42 --flag seen

第 9 步：处理附件与多账户

himalaya attachment download 42
himalaya attachment download 42 --dir ~/Downloads
himalaya account list
himalaya --account work envelope list

第 10 步：接入结构化输出

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

输出说明：默认输出为人类可读的表格/文本；加 --output json 后可直接交给 jq 或其他脚本处理。需要注意，消息 ID 是相对于当前文件夹的，切换文件夹后要重新列出以取得新的 ID。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
himalayaSkill（himalaya） 终端命令行邮件客户端 IMAP/SMTP/Notmuch/Sendmail 多后端、收发/搜索/整理、多账户、MML 撰写、JSON 输出 需安装二进制并手写或用向导生成 TOML 配置；无图形界面 终端重度用户、脚本与自动化场景 优势：命令全面、结构化输出友好、可脚本化；不足：需要理解配置项，初次上手有学习曲线
NeoMutt / Mutt 类终端客户端 老牌终端邮件客户端 收发邮件、索引视图、快捷键操作、高度可定制 依赖配置文件与较多插件，定制成本较高 习惯键盘流与高度自定义的老用户 优势：生态成熟、可定制性强；不足：配置复杂，现代默认体验与结构化输出能力偏弱
图形邮件客户端（如桌面客户端、网页邮箱） 大众化邮件管理 可视化浏览、拖拽归档、日历集成等 几乎零门槛，登录即用 日常办公、非技术用户 优势：直观易用、功能丰富；不足：难以脚本化，多账户切换与批量处理效率低
自行编写 IMAP 脚本 自定义自动化 按需实现特定收发与解析逻辑 需处理协议细节、认证与异常 单一重复任务的自动化 优势：完全贴合需求；不足：开发维护成本高，功能覆盖窄

5. 该技能的典型应用场景与实际体验情况

场景一：后端开发者的日常邮件处理

角色是一名长期在终端里工作的后端工程师，痛点是每次查收邮件都要切窗口、登录、翻列表。使用 himalaya envelope list 一眼看完收件箱，himalaya message read 42 直接读信，himalaya message reply 42 用编辑器回信，整个过程不离开终端。 实际体验：命令语义清晰，envelope、message、flag 的分层设计符合直觉，熟悉后几乎不需要查帮助。首次配置是最耗时的一步，尤其是加密方式与端口需要与邮箱服务商匹配。

场景二：多账户统一管理

角色是需要同时处理个人邮箱与工作邮箱的用户。通过 himalaya account list 查看全部账户，用 himalaya --account work envelope list 在同一条命令里指定账户。 实际体验：多账户切换成本极低，避免了反复登录退出。建议在配置文件中为常用账户设置 default = true，减少参数输入。

场景三：运维与自动化通知

角色是负责发布与告警的运维人员，需要脚本化发送通知邮件。借助 himalaya template send 配合标准输入直接投递邮件，可以把邮件发送嵌入 shell 脚本。 实际体验：模板发送非常直接，适合"内容确定、只需投递"的通知场景。注意凭证应通过 pass 或密钥环读取，避免把密码写死在脚本里。

场景四：批量归档与附件整理

角色是项目负责人，需要把某类邮件归档、把附件批量保存到本地。用 himalaya envelope list from ... subject ... 先筛出目标邮件，再用 himalaya message move 归档、himalaya attachment download 42 --dir ~/Downloads 保存附件。 实际体验：搜索条件组合灵活，配合 --output json 可以进一步交给脚本做统计。需要注意的是消息 ID 与当前文件夹相关，批量操作前先确认所在文件夹，避免对错误对象执行移动或删除。

6. 该技能能为用户带来的价值

  • 效率提升：把"打开客户端 → 登录 → 找邮件 → 操作"的多步流程压缩为一条命令，高频邮件处理场景下每天可节省大量窗口切换与等待时间。
  • 门槛降低：相比自己用 IMAP 库写脚本，himalaya 已经封装好文件夹、信封、消息、标志、附件等概念，用户只需记忆少量命令即可完成绝大多数操作。
  • 可自动化：--output json 与 template send 让邮件处理能进入脚本和流水线，原本只能人工完成的通知、归档、筛选工作有机会变成可重复执行的任务。
  • 多账户低成本：一套配置管理多个邮箱，配合 --account 参数按需切换，适合同时维护工作与个人邮箱的用户。
  • 长期价值：基于标准 IMAP/SMTP 协议，不绑定特定服务商；配置以 TOML 文件形式保存在本地，便于版本化管理与迁移，长期使用成本低。

7. 常见问题 FAQ

Q1：怎么安装 himalayaSkill？ A：技能元数据提供的是 brew 安装方式，公式名为 himalaya，安装完成后可执行 himalaya --version 验证。如果你的系统没有 brew，请参考官方主页 https://github.com/pimalaya/himalaya 上提供的其他安装方式，具体支持平台与命令以官方说明为准。

Q2：安装后提示没有账户或连接失败怎么办？ A：先确认是否完成了配置。可以运行 himalaya account configure 走交互式向导，或手动创建 ~/.config/himalaya/config.toml。连接类问题建议用 RUST_LOG=debug himalaya envelope list 打开调试日志，必要时使用 RUST_LOG=trace RUST_BACKTRACE=1 获取完整追踪信息，重点检查服务器地址、端口与加密方式是否与邮箱服务商要求一致。

Q3：密码能直接写在配置文件里吗？ A：不推荐。技能说明中建议使用 pass、系统密钥环，或通过执行命令输出密码的方式（backend.auth.cmd、message.send.backend.auth.cmd）来安全存储与读取凭证。

Q4：这个技能收费吗？ A：himalaya 是开源项目，项目主页为 https://github.com/pimalaya/himalaya。技能本身是否涉及额外费用、以及安装渠道的具体计费方式，请以官方说明为准。

Q5：适合谁用？和图形客户端、终端客户端怎么选？ A：如果你长期在终端工作、希望把邮件处理接进脚本，或者需要同时管理多个邮箱，himalayaSkill 会明显更顺手；如果你更看重可视化浏览、日历集成等体验，图形客户端依然更合适。若你已经在用 Mutt 类终端客户端，可以从"是否需要结构化输出和更简洁的现代配置"这一点来判断是否迁移。