sog — Standards Ops Gadget

面向 IMAP/SMTP/CalDAV/CardDAV/WebDAV 的命令行工具（CLI）。 开放标准替代方案，对应 gog（Google）与 mog（Microsoft）。

快速开始

sog auth add you@fastmail.com --discover
sog auth test
sog mail list

全局标志

--account, -a    要使用的账户邮箱（$SOG_ACCOUNT）
--json           JSON 格式输出（适用于脚本调用）
--plain          TSV 格式输出（可解析）
--force          跳过确认提示
--no-input       从不交互提示（CI 模式）
--verbose, -v    启用调试日志
--ai-help        显示详细帮助文本

认证管理

sog auth add  [flags]
  --discover       通过 DNS 自动发现服务器
  --imap-host      IMAP 服务器主机名
  --imap-port      IMAP 端口（默认：993）
  --smtp-host      SMTP 服务器主机名
  --smtp-port      SMTP 端口（默认：587）
  --caldav-url     CalDAV 服务器 URL
  --carddav-url    CardDAV 服务器 URL
  --webdav-url     WebDAV 服务器 URL
  --password       密码（安全存储于系统凭据库中）

sog auth list                    # 列出所有账户
sog auth test [email]            # 测试连接
sog auth remove           # 删除账户
sog auth password         # 设置协议专用密码
  --imap, --smtp, --caldav, --carddav, --webdav

邮件（IMAP/SMTP）

sog mail list [folder]
  --max N          最大消息数（默认：20）
  --unseen         仅列出未读邮件

sog mail get 
  --headers        仅显示邮件头
  --raw            原始 RFC822 格式

sog mail search 
  # 使用 IMAP SEARCH 语法：FROM、TO、SUBJECT、SINCE、BEFORE 等
  # 示例：sog mail search "FROM john SINCE 1-Jan-2026"

sog mail send --to  --subject  [flags]
  --to             收件人（支持多个）
  --cc             抄送收件人（支持多个）
  --bcc            密送收件人（支持多个）
  --subject        邮件主题
  --body           邮件正文
  --body-file      从文件读取正文（- 表示从 stdin 读取）
  --body-html      HTML 格式的邮件正文

sog mail reply  --body 
sog mail forward  --to 
sog mail move  
sog mail copy  
sog mail flag         # 可用标记：seen、flagged、answered、deleted
sog mail unflag  
sog mail delete 

文件夹

sog folders list
sog folders create 
sog folders delete 
sog folders rename  

草稿

sog drafts list
sog drafts create [flags]        # 参数同 sog mail send
sog drafts send 
sog drafts delete 

日历（CalDAV）

sog cal list [calendar]
  --from           起始日期（默认：今日）
  --to             结束日期（默认：+30d）
  --max            最大事件数

sog cal get 
sog cal search            # 在标题、描述、地点中搜索
sog cal today [calendar]
sog cal week [calendar]

sog cal create