多账户统一邮件管理 CLI 工具,支持 Gmail/Outlook/Exchange 的搜索、收发、转发、标签管理,系统密钥环存储凭证,AI 优化输出
说明:
## 核心功能
`porteden email` 是一款跨平台命令行邮件管理工具,支持 Gmail、Microsoft 365/Outlook 和 Exchange 多账户统一管理。核心能力覆盖完整邮件生命周期:
– **查询检索**:`messages` 命令支持按发件人、收件人、主题、标签、未读状态、附件等维度过滤,配合 `-q` 全文搜索及日期范围(`–today/–yesterday/–week/–days N`/`–after/–before`)快速定位
– **单件/线程操作**:`message ` 获取详情,`thread ` 获取完整对话流,支持 `–include-body` 获取完整正文
– **发送与回复**:`send` 支持 HTML/纯文本、CC/BCC、优先级标记;`reply/reply-all` 和 `forward` 保持线程上下文
– **状态管理**:`modify` 支持已读/未读切换、添加/移除标签;`delete` 永久删除
**AI 优化设计**:`-jc`(`–json –compact`)标志专为 LLM 场景优化,自动剥离附件详情、截断正文预览、限制标签数量,显著降低 token 消耗。
## 显著优势
1. **安全架构**:凭证存储于系统密钥环(macOS Keychain/Windows Credential Manager/Linux Secret Service),非明文文件;支持 `PE_API_KEY` 环境变量注入,适合 CI/CD 场景
2. **多账户原生支持**:Provider 前缀标识(`google:`, `m365:`),单命令切换 `–profile`
3. **流式分页**:`–all` 自动处理分页,JSON 输出含 `hasMore`/`nextPageToken` 便于程序续拉
4. **安装灵活**:Homebrew 一键安装或 Go 直接编译,零依赖外部运行时
## 局限与风险
– **功能边界**:不支持 Exchange 本地部署(仅云 M365),IMAP/POP3 协议未提及;附件操作仅限详情查看,无上传/下载命令
– **删除不可逆**:`delete` 为硬删除(非移至垃圾箱),无二次确认机制(文档提示”Confirm before”但未说明交互方式)
– **隐私合规**:第三方服务 `porteden.com` 作为 OAuth 代理,需信任其 token 中转;数据流经该服务,非纯本地直连邮件服务商
– **稳定性**:`gog-cli secure alternative` 暗示竞品兼容层,API 稳定性依赖上游维护
## 适合人群
– 需要脚本化邮件处理的开发者/运维(告警聚合、自动回复)
– 多邮箱账户的技术用户追求 CLI 效率
– AI Agent 开发者需结构化邮件数据输入
## 常规风险
| 风险类型 | 说明 |
|———|——|
| 凭证泄露 | `PE_API_KEY` 若硬编码于脚本/日志,存在暴露风险;建议配合 secrets manager |
| 误操作删除 | 批量脚本中 `delete` 缺乏回收站保护,需前置 `–dry-run` 逻辑(工具未内建) |
| 服务可用性 | OAuth 代理故障将导致认证失效,存在单点依赖 |
| 数据隐私 | 邮件主题、发件人等元数据可能流经第三方服务器,敏感场景需评估合规性 |








