Feishu CLI 邮件管理
撰写、发送、回复和转发邮件。管理草稿、分类收件箱，并通过 WebSocket 实时监控新邮件 — 一切尽在命令行或 AI Agent 自动化工作流中完成。
概览
在终端中实现完整的邮件管理
Feishu CLI 邮件模块提供 11 个快捷命令，实现完整的邮件管理功能。发送新邮件、回复或转发已有邮件、管理草稿、分类收件箱，并通过 WebSocket 实时监控新邮件。每个快捷命令都直接映射到飞书开放平台邮件 API，为您提供对飞书/Lark 邮件的完整编程访问。
邮件技能包含强大的安全规则，可在 AI Agent 处理邮件内容时防范提示词注入攻击。所有撰写操作默认先创建草稿，需要明确确认后才会发送 — 这是自动化工作流中至关重要的安全特性。
发送邮件
+send — 撰写并发送邮件
撰写一封包含收件人、主题、HTML 正文和可选附件的新邮件。默认创建草稿，添加 --confirm-send 可立即发送。
$ lark-cli mail +send --to "user@example.com" --subject "Q1 Report" --body "<h1>Report</h1><p>See attached.</p>" --attach ./report.pdf
$ lark-cli mail +send --to "user@example.com" --cc "manager@example.com" --bcc "archive@example.com" --subject "Final Review" --body "<p>Please review and approve.</p>" --confirm-send
$ lark-cli mail +send --from "team@example.com" --to "client@example.com" --subject "Design Mockups" --body "<p>See inline previews below.</p>" --inline ./mockup1.png --inline ./mockup2.png
支持的参数
| 参数 | 说明 |
|---|
--from | 发件人邮箱地址或别名 |
--to | 收件人邮箱地址（必填） |
--cc | 抄送收件人 |
--bcc | 密送收件人 |
--subject | 邮件主题 |
--body | HTML 格式的邮件正文 |
--attach | 文件附件（本地路径，可重复使用） |
--inline | 内嵌图片（本地路径，可重复使用） |
--confirm-send | 立即发送而非创建草稿 |
回复
+reply — 回复邮件
通过消息 ID 回复特定邮件。默认创建草稿回复，原始发件人自动成为收件人。
$ lark-cli mail +reply --message-id "msgXXX" --body "<p>Thanks, acknowledged.</p>"
$ lark-cli mail +reply --message-id "msgXXX" --body "<p>Confirmed. Will proceed.</p>" --confirm-send
全部回复
+reply-all — 回复所有收件人
回复邮件的所有收件人。使用 --remove 可从回复中排除特定地址。
$ lark-cli mail +reply-all --message-id "msgXXX" --body "<p>Noted by all.</p>"
$ lark-cli mail +reply-all --message-id "msgXXX" --body "<p>Internal discussion only.</p>" --remove "external@partner.com"
转发
+forward — 转发邮件
将现有邮件转发给新的收件人，可附加说明内容。
$ lark-cli mail +forward --message-id "msgXXX" --to "colleague@example.com" --body "<p>FYI — see the original thread below.</p>"
草稿管理
+draft-create 与 +draft-edit — 管理邮件草稿
在发送前创建新草稿或编辑现有草稿。草稿是所有撰写操作的默认输出，提供安全的审核步骤。
$ lark-cli mail +draft-create --subject "Draft Report" --body "<p>Work in progress.</p>" --to "team@example.com"
$ lark-cli mail +draft-edit --draft-id "draftXXX" --set-subject "Updated Subject"
$ lark-cli mail +draft-edit --draft-id "draftXXX" --set-body "<p>Revised content.</p>" --attach ./updated-report.pdf
阅读邮件
+message、+messages、+thread — 阅读邮件
获取单封邮件、列出多封邮件，或查看整个邮件会话。
$ lark-cli mail +message --message-id "msgXXX"
$ lark-cli mail +messages
$ lark-cli mail +thread --thread-id "threadXXX"
收件箱分类
+triage — 快速收件箱概览
获取收件箱的优先级概览，便于快速分类处理。优先显示未读和重要邮件，帮助您迅速判断哪些需要关注。
$ lark-cli mail +triage
实时监控
+watch — 通过 WebSocket 监控新邮件
建立实时 WebSocket 连接以监控新邮件。按标签或文件夹过滤，并将事件输出到本地目录以供下游处理。
$ lark-cli mail +watch --labels "INBOX" --output-dir ./mail-events/
$ lark-cli mail +watch --labels "IMPORTANT" --output-dir ./important-events/
参数
| 参数 | 说明 |
|---|
--labels | 按标签或文件夹名称过滤（例如 INBOX、IMPORTANT、SENT） |
--output-dir | 写入邮件事件 JSON 文件的本地目录 |
安全保障
邮件安全特性
Feishu CLI 邮件技能包含多层安全机制，专为 AI Agent 工作流中自动处理邮件内容的场景设计。
不可信输入处理
所有邮件内容均被视为不可信输入。邮件技能在处理邮件正文、主题和邮件头之前会进行严格的清理，以防范注入攻击。
防提示词注入
lark-mail 技能内置规则可检测并中和嵌入在邮件内容中的提示词注入尝试，保护 AI Agent 免受恶意载荷攻击。
发件人身份验证
该技能强制感知发件人身份验证状态。AI Agent 被指示对未验证或伪造的发件人地址保持适当的警惕。
草稿优先工作流
所有撰写操作（发送、回复、转发）默认创建草稿而非立即发送。这可以防止自动化流水线中的误发。
模拟运行支持
所有写入操作支持 --dry-run 标志，可模拟操作而不做任何实际更改。这对于安全测试自动化邮件工作流至关重要。
权限范围控制
邮件访问需要 mail:user_mailbox 权限范围，确保只有经授权的应用程序才能代表用户读取或发送邮件。
权限
所需权限范围
所有邮件命令需要 mail:user_mailbox 范围以访问用户邮箱。此范围授予对已认证用户邮箱的读写权限，包括发送、阅读和管理草稿。
命令参考
所有邮件快捷命令
| 命令 | 说明 | 风险等级 | 关键参数 |
|---|
+send | 撰写并发送新邮件 | 中 | --to, --subject, --body, --attach, --confirm-send |
+reply | 回复特定邮件 | 中 | --message-id, --body, --confirm-send |
+reply-all | 回复所有收件人 | 中 | --message-id, --body, --remove |
+forward | 将邮件转发给新收件人 | 中 | --message-id, --to, --body |
+draft-create | 创建新邮件草稿 | 低 | --subject, --body, --to |
+draft-edit | 编辑现有草稿 | 低 | --draft-id, --set-subject, --set-body |
+message | 阅读单封邮件 | 安全 | --message-id |
+messages | 列出最近邮件 | 安全 | — |
+thread | 查看邮件会话 | 安全 | --thread-id |
+triage | 快速收件箱分类概览 | 安全 | — |
+watch | 通过 WebSocket 监控新邮件 | 安全 | --labels, --output-dir |