mail

多邮箱收发

规则

用户要看/读/发/标记邮件 → 跑 cyeam mail 命令 → 返回结果。

• 看邮件：默认用 --all 列出所有邮箱，用户指定具体邮箱才用 <账户>
• 读邮件：必须指定 <账户> <uid>，可加 --mark-read 同时标记已读
• 发邮件：必须指定 <账户>
• 标记已读/未读：必须指定 <账户> 和 UID，或用 --uids 批量

用户: "看看我有什么新邮件"                  →  cyeam mail list --all
用户: "看看我 cyeam 邮箱有什么邮件"         →  cyeam mail list cyeam
用户: "读一下 UID 123 那封"                →  cyeam mail read cyeam 123
用户: "读一下 UID 123 并标记已读"           →  cyeam mail read cyeam 123 --mark-read
用户: "把 UID 123 标记为已读"              →  cyeam mail mark-read cyeam 123
用户: "把 UID 123,456,789 都标记为已读"    →  cyeam mail mark-read cyeam --uids 123,456,789
用户: "把 cyeam 邮箱所有邮件一键已读"       →  cyeam mail mark-all-read cyeam
用户: "把 UID 123 标记为未读"              →  cyeam mail mark-unread cyeam 123
用户: "给 [email protected] 发封邮件"                →  cyeam mail send cyeam --to [email protected] --subject "..." --body "..."

读邮件分两步：先 list --all 拿到 UID 和对应账户，再 read <账户> <uid> 读正文。

命令

cyeam mail list --all [--limit 20]                列所有邮箱的最近邮件：账户/UID/发件人/主题/时间/未读
cyeam mail list <账户> [--limit 20]               列指定邮箱的最近邮件
cyeam mail read <账户> <uid> [--mark-read]        读单封：发件人/收件人/主题/日期/正文，可选标记已读
cyeam mail mark-read <账户> <uid>                 标记单封为已读
cyeam mail mark-read <账户> --uids <uid1,uid2>    批量标记已读，逗号分隔
cyeam mail mark-all-read <账户>                   一键标记 INBOX 全部未读邮件为已读
cyeam mail mark-unread <账户> <uid>               标记单封为未读
cyeam mail mark-unread <账户> --uids <uid1,uid2>  批量标记未读
cyeam mail send <账户> --to <地址> --subject <主题> --body <正文>
    [--cc <地址>] [--body-file <文件>]             发送邮件（--to/--cc 可重复）

配置

账户列表写在 ~/.cyeam/mail.json，推荐用户名和密码都从环境变量读取，避免明文写入配置文件：

{
  "accounts": [
    {
      "name": "cyeam",
      "imap_host": "imap.zoho.com",
      "imap_port": 993,
      "username_env": "CYEAM_MAIL_USERNAME",
      "password_env": "CYEAM_MAIL_PASS",
      "smtp_host": "smtp.zoho.com",
      "smtp_port": 465
    }
  ]
}

• username_env：用户名所在的环境变量名，运行前需 export [email protected]
• username：用户名明文写在配置中（不推荐），如设置则优先级高于 username_env
• password_env：应用专用密码所在的环境变量名，运行前需 export CYEAM_MAIL_PASS=xxx
• smtp_host/smtp_port 可省略：默认把 imap. 换成 smtp.，端口默认 465
• 多账户就在 accounts 里多加几项，命令里用 name 指定

常见邮箱 IMAP/SMTP：

邮箱	IMAP	SMTP
Zoho	imap.zoho.com	smtp.zoho.com
Gmail	imap.gmail.com	smtp.gmail.com
iCloud	imap.mail.me.com	smtp.mail.me.com

前置条件（用户侧）

• 邮箱后台开启 IMAP 访问
• 生成「应用专用密码」（不是登录密码），设到对应环境变量
• 端口 465 用 TLS，587 用 STARTTLS

输出

所有命令输出 JSON 信封，加 --pretty 去掉信封。

不做的事

• 删除、移动邮件
• 附件下载、全文搜索