电子邮件 (IMAP)
Macro Deck 自带在面板上查看任意 IMAP 收件箱的未读邮件和最新邮件，并在收到邮件时做出响应。
电子邮件收件箱组件，显示最新邮件列表、未读邮件和未读数量
- 适用于 Gmail、iCloud Mail、GMX 和任何 IMAP 服务器
- 在电子邮件收件箱组件上显示未读数或邮件列表
- 收到邮件或邮件被阅读时触发
- 提供未读数、最新发件人和主题的变量
- 只读：绝不更改、移动或删除邮件
电子邮件 (IMAP) 集成可读取任何提供 IMAP 的服务商的邮箱中的一个文件夹（通常是收件箱），例如 Gmail、iCloud Mail 或自己域名的邮箱。Macro Deck 只读取邮件。它绝不会更改、移动或删除邮件，也绝不会将邮件标记为已读。
对于 Gmail、iCloud Mail、Yahoo Mail、AOL Mail、Fastmail、Zoho Mail、GMX、WEB.DE、T-Online、IONOS、mailbox.org 和 Posteo，只需选择服务商，Macro Deck 就会填好服务器设置。对于其他服务，请选择 自定义服务器，并输入服务商帮助页面中的 IMAP 设置。连接始终通过 SSL/TLS 或 STARTTLS 加密，并且始终会检查服务器证书。
可以做什么
- 电子邮件收件箱组件： 显示未读邮件数，或显示包含发件人、主题和时间的最新邮件列表。
- 触发器： 收到邮件、未读数已变化、邮件已读或未读、收件箱已断开 和 收件箱已连接 可以在自动化或组件上运行动作。收到邮件 可以限定为某个发件人或主题。
- 变量： 所有收件箱的未读邮件总数，以及每个收件箱的未读邮件数和邮件总数、最新邮件的发件人和主题，以及是否已连接。
一些示例设置：
- 面板上的一个电子邮件收件箱组件，显示工作收件箱中有多少封未读邮件。
- 一个在收到上级邮件时由 收到邮件 触发的自动化，显示一条通知。
- 一个由 收件箱已断开 触发的自动化，在无法访问邮件服务器时显示通知。
运行方式
如果服务器支持，Macro Deck 会保持连接，并在几秒内得知新邮件；如果不支持，则每分钟检查一次。Macro Deck 启动时已存在的邮件不会触发 收到邮件，因此重启不会重放整个收件箱。收件箱无法访问时，组件会保留最后的邮件并显示警告，Macro Deck 会持续尝试重新连接。
可以添加任意数量的账户，也可以添加同一账户的多个文件夹，每个都作为单独的配置。每个收件箱的变量以其配置名称命名，例如名为 Work 的收件箱对应 email_work_unread_count。
组件显示的所有内容，包括发件人、主题和预览，都可以在连接到 Macro Deck 的每台设备上看到。
准备工作
- Windows、macOS 或 Linux 上的 Macro Deck 3
- 已开启 IMAP 访问的邮箱账户
- 密码；如果账户使用两步验证，则需要应用专用密码
- 对于自定义服务器：IMAP 服务器名称、端口和安全设置
设置步骤
第 1 步: 如有需要，创建应用专用密码
开启两步验证后，大多数服务商会拒绝其他应用使用普通密码登录。请在账户的安全设置中创建应用专用密码，例如对于 Gmail，在 Google 账号的 应用专用密码 下创建；对于 iCloud Mail，在 account.apple.com 的 登录与安全性 下创建。
第 2 步: 打开电子邮件 (IMAP) 设置
在侧边栏中点击 集成，然后点击 电子邮件 (IMAP)。在 概览 选项卡的 配置 下点击 添加配置。打开右上角的开关也会打开同一个对话框，完成设置后集成即会启用。随后会打开 连接邮箱帐户 对话框。
第 3 步: 填写账户信息
输入：
- 配置名称：收件箱在 Macro Deck 中的名称，例如
Work。其变量以此命名。 - 邮件服务商：所用的邮件服务，或 自定义服务器。对于自定义服务器，还需填写 IMAP 服务器、端口（SSL/TLS 为
993，STARTTLS 通常为143）和 安全。 - 用户名：通常是完整的电子邮件地址。
- 密码：密码或应用专用密码。它会加密存储在这台电脑上。
- 文件夹：要监视的文件夹，默认为
INBOX。
点击 继续。Macro Deck 会登录一次以检查设置，如果无法登录，会说明出了什么问题。
- 配置名称：收件箱在 Macro Deck 中的名称，例如
第 4 步: 添加电子邮件收件箱组件
在 面板 页面添加一个 电子邮件收件箱 组件。在其设置中选择要显示的 收件箱 以及要 显示 的内容：未读数 或 邮件列表。将 收件箱 留空即可显示所有已连接的收件箱。
第 5 步: 添加刷新按键
在 面板 页面上，确认面板已解锁（右上角的按钮显示为 锁定），然后点击一个按键。编辑器打开时已选中 短按。点击 + 添加动作，在 添加动作 对话框左侧选择 电子邮件，然后选择 刷新邮件收件箱。点击 保存。按下该按键会立即检查每个已连接的收件箱。
第 6 步: 对新邮件做出响应
在按键或自动化的编辑器中，点击 + 添加事件触发器，然后选择 收到邮件。可以根据需要将其限定为某个 收件箱、发件人 或 主题，然后点击 + 添加动作 并选择要执行的操作，例如通知。
动作1
可以放在按键上，也可以在流程中运行。
- 刷新邮件收件箱
- 立即检查每个已连接的收件箱是否有新邮件，而不是等待下一次更新。
触发器5
按键或流程可以对这些事件做出响应。
- 收到邮件
- 收件箱中收到新邮件时运行。可以限定为某个收件箱、发件人和主题。
- 未读数已变化
- 收件箱中的未读邮件数发生变化时运行。
- 邮件已读或未读
- 邮件被标记为已读或未读时运行，例如在邮件应用中。
- 收件箱已断开
- 收件箱与邮件服务器断开连接时运行。
- 收件箱已连接
- 收件箱在断开后重新连接时运行。
变量5
在按键和组件上显示这些值，或在条件中使用它们。
email_unread_count- 所有收件箱的未读邮件总数。
email_inbox_count- 已连接的收件箱数量。
email_<inbox>_unread_count,email_<inbox>_total_count- 收件箱中的未读邮件数和全部邮件数，例如
email_work_unread_count和email_work_total_count。 email_<inbox>_latest_sender,email_<inbox>_latest_subject,email_<inbox>_latest_received_at- 收件箱中最新邮件的发件人、主题和时间。
email_<inbox>_is_connected- 收件箱是否已连接。
组件1
从组件选择器中将它们添加到面板。
- 电子邮件收件箱
- 显示有多少封未读邮件，或显示已连接收件箱中的最新邮件。
常见问题解答
Macro Deck 会将邮件标记为已读吗？
不会。Macro Deck 只读取邮件。它绝不会将邮件标记为已读，也绝不会更改、移动或删除邮件。
服务器为什么拒绝我的密码？
开启两步验证后，大多数服务商（包括 Gmail 和 iCloud Mail）会拒绝其他应用使用普通密码登录。请在账户的安全设置中创建应用专用密码，并将其填写为 密码。另外请检查 用户名 是否为完整的电子邮件地址。
可以连接 Outlook.com 或 Microsoft 365 邮箱吗？
Microsoft 只允许这类账户中的大多数通过 OAuth 登录 IMAP，而 Macro Deck 目前尚不支持。如果账户仍然提供应用专用密码，请选择 自定义服务器 并使用应用专用密码。
可以连接多个账户或文件夹吗？
可以。在电子邮件 (IMAP) 页面上，为每个账户或同一账户的另一个文件夹点击 添加配置。已连接的文件夹会被拒绝。
更改邮箱密码后会怎样？
集成 会为该账户显示 邮箱登录失败，其组件显示 离线。在该账户旁边选择 编辑连接，然后输入当前密码或新的应用专用密码。收件箱的名称保持不变，因此组件、触发器和变量会继续正常工作。
密码存储在哪里？
密码加密存储在运行 Macro Deck 的电脑上，只用于登录邮件服务器。
“日历和电子邮件”分类中的更多集成
Google Calendar
Macro Deck 自带在面板上显示 Google Calendar 事件，为下一场会议倒计时，并一键加入会议。
Outlook Calendar
Macro Deck 自带在面板上显示 Outlook 和 Microsoft 365 日历，一键加入 Teams 会议。