fastmail

📧 Fastmail 邮箱日历全能管家

基于 JMAP/CalDAV 的 Fastmail 邮件日历管理工具,支持批量操作与智能提醒,提供安全可靠的自动化邮箱管理能力。

收藏
672
安装
320
版本
v1.0.1
CLS 安全性认证2026-05-05
点击查看完整报告 >

使用说明

核心用法

该 Skill 通过 JMAP 和 CalDAV 协议与 Fastmail 服务深度集成,提供完整的邮件与日历管理功能。邮件模块支持 10 项基础操作(包括列表查看、搜索、发送、回复、移动、标签管理、删除)和 3 项批量操作(批量移动、标签设置、删除),特别支持邮件线程查看功能。日历模块提供 10 项事件管理工具(创建、更新、删除、recurring 事件)和 4 项提醒工具,支持自动时区检测和 IANA 时区配置。所有操作均通过 CLI 命令行界面执行,返回标准 JSON 格式数据,便于与其他自动化工具集成。

显著优点

首先,功能覆盖全面,几乎涵盖了日常邮件和日历管理的所有高频场景,从单封邮件处理到批量操作,从简单事件创建到周期性提醒设置,满足个人和团队的自动化需求。其次,安全性设计规范,采用环境变量管理敏感凭据,无硬编码风险,所有 API 通信均强制 HTTPS 加密。第三,技术实现可靠,依赖版本锁定(tsdav ^2.1.6, uuid ^13.0.0),无动态代码加载或危险函数使用。第四,用户体验友好,支持自动时区检测,提供清晰的决策树指引,错误处理机制完善且信息结构化。

潜在缺点或局限性

该 Skill 专为 Fastmail 平台设计,不具备跨平台通用性,非 Fastmail 用户无法使用。功能上暂不支持邮件附件处理和联系人管理,对于需要完整 CRM 或复杂附件自动化的场景存在局限。作为 T3 来源的个人开发者项目,长期维护稳定性和社区支持能力相较企业级项目存在不确定性。此外,依赖外部 npm 包(tsdav、uuid)需要用户持续关注安全更新,存在供应链安全风险。

适合的目标群体

主要面向 Fastmail 付费用户中的技术从业者、开发者、自动化工作流爱好者,以及需要通过 CLI 批量处理邮件的运维人员。特别适合需要自动化邮件分类归档、定期发送报告、批量管理日历邀请的场景。对于追求邮箱数据主权、使用 Fastmail 替代 Gmail 的隐私敏感型用户,该工具提供了本地化的自动化管理能力。

使用风险

性能方面,批量操作大量邮件时可能触发 Fastmail API 速率限制,建议分批处理。依赖风险方面,tsdav 库的更新可能影响 CalDAV 功能兼容性,需定期更新 Skill 版本。凭据管理风险方面,环境变量若配置不当(如意外提交到 Git)可能导致账户泄露,建议配合 .env 文件和 .gitignore 使用,并启用 Fastmail 应用密码而非主密码。时区配置方面,虽然支持自动检测,但跨时区协作时仍需手动确认设置正确性,避免日程混乱。

安全解读

核心用法

Fastmail Skill 是一个用于管理 Fastmail 邮箱和日历的 CLI 工具集,通过 JMAP 协议处理邮件,通过 CalDAV 协议处理日历数据。安装后可通过 bunx fastmail 调用各类命令。

邮件管理:支持列出邮箱、搜索邮件、获取单封邮件或完整会话线程、发送新邮件、回复邮件、移动邮件到指定文件夹、设置标签(已读/星标)、删除邮件,以及批量移动、批量设置标签、批量删除等高效操作。

日历管理:支持列出日历、按日期范围查看事件、创建/更新/删除事件、创建周期性重复事件、搜索事件、管理邀请(列出邀请、接受/拒绝/待定回复),以及完整的提醒功能(添加/移除/列出提醒,支持创建事件时一并设置提醒)。

认证配置:需设置三个环境变量——FASTMAIL_API_TOKEN(JMAP 邮件 API)、FASTMAIL_USERNAMEFASTMAIL_PASSWORD(CalDAV 日历)。时区自动从系统检测,也可通过 FASTMAIL_TIMEZONE 手动指定 IANA 时区格式。

显著优点

  • 官方 API 直联:仅与 Fastmail 官方服务通信(api.fastmail.com, caldav.fastmail.com),HTTPS 加密传输,无中间代理
  • 批量操作高效:原生支持批量移动、批量标签、批量删除,适合收件箱整理和归档场景
  • 时区智能处理:自动检测系统时区,支持手动覆盖,内部 UTC 存储,DST 自动处理
  • 功能覆盖全面:邮件(10 个工具)+ 日历(10 个工具)+ 批量(3 个)+ 提醒(4 个),共 27 个工具覆盖主流需求
  • 输出结构化:所有工具返回统一 JSON 格式,包含 success、data、timestamp 字段,便于程序化处理

潜在缺点与局限性

  • T3 来源级别:维护者为个人开发者(witooh),非企业或知名组织背书,需关注更新活跃度
  • 依赖第三方库:依赖 tsdav(CalDAV 客户端)和 uuid,虽无已知 CVE,但供应链风险存在
  • 网络超时缺失:fetch 请求未设置超时控制,网络异常时可能长时间挂起
  • 凭证验证薄弱:环境变量读取后无格式校验(如 token 长度检查),错误信息可能意外泄露敏感值
  • 不可逆操作无二次确认:删除邮件、删除事件等操作直接执行,无内置确认机制,依赖用户谨慎

适合人群

  • Fastmail 付费用户,希望通过命令行高效管理邮件和日历
  • 需要将邮件/日历操作脚本化、自动化的开发者或效率工具用户
  • 对隐私敏感、希望避免通过第三方中转直接调用官方 API 的用户
  • 熟悉环境变量配置和 CLI 工具使用的技术用户

常规风险

  • 凭证泄露风险:API Token 和账号密码通过环境变量传递,若配置不当(如写入 shell history、打印到日志)可能导致泄露
  • 误操作风险:批量删除、移动操作一旦执行难以撤销,建议操作前先用 list/search 确认目标范围
  • 服务可用性依赖:完全依赖 Fastmail 官方 API,若 Fastmail 服务故障或 API 变更,工具可能失效
  • 供应链风险:tsdav 库的更新或漏洞可能影响本工具,建议关注依赖更新

fastmail 内容

dist文件夹
references文件夹
scripts文件夹
tools文件夹
手动下载zip · 119.8 kB
cli.jstext/javascript
请选择文件