用途：spark 是 Spark 邮件客户端的 CLI，用于查询用户的邮箱、日历、联系人、会议和团队数据。它本身不存储邮箱、网络栈或凭据，而是通过 IPC 与用户正在运行的 Spark Desktop 应用通信，因此必须直接在用户电脑上运行，不能在沙箱、容器或 CI 中执行；若 Spark Desktop 未运行，应请用户启动而非重试。
主要能力：accounts 列出账户、日历、团队、共享收件箱及访问级别；folders 列出文件夹/标签及邮件数；emails 按过滤器和分页列出邮件；search 提供关键词+语义混合搜索（带主题）或跨文件夹列表模式（不带主题）；thread 读取完整会话（含正文与附件）；attachment 按 ID 读取附件；draft 创建、编辑、删除草稿及列出签名；templates/template 管理模板；comment 发布团队评论；events/event 管理日历事件与 RSVP；availability 查找空闲时段；contacts/contact 查询联系人；team 查看团队信息；meetings/meeting 读取会议记录；action 与 contact-action 执行归档、置顶、稍后处理、分配、屏蔽等操作。
使用方式：命令格式为 spark <command> [options]。任意命令加 --json 可输出 JSON（完整值、snake_case 键、ISO 8601 日期），失败时在 stdout 打印 {"error": {"message": "…"}} 并以非零码退出。emails 支持 Gmail 风格过滤器（如 from:、is:unread、newer_than:7d、has:attachment）与分页。访问级别分 read-only、triage、send，分别控制读、写和发信/事件操作，按账户和共享收件箱在 Spark Desktop 的 Settings -> AI Agents 中单独配置。
限制：需本机运行 Spark Desktop；权限不足时命令返回错误并提示如何调整级别；草稿删除不可撤销；--attach 单文件上限 25 MB，沙箱版无法读取容器外路径，需改用 --attach-stream。其余细节资料未提供。