学习模式

刺猬星球super-i_AI教程免费在线教学

团队邮件越堆越多,订阅、通知、客户询盘、验证码全混在一起,根本理不清?给飞书装个邮件 AI 秘书——一次部署,全组人都能用。只要在聊天框里说一句"未读邮件 10",自动分类、写摘要、圈出要回的、连草稿都备好。

 

一、教程简介


1、30秒看懂

这是一篇大约 10 分钟的部署教程:解压安装包 → 在飞书后台创建机器人 → 填一个 config.env → 启动 → 在飞书里发消息测试。机器人会读取邮箱里的未读邮件头部和正文片段,交给 DeepSeek 分类,再通过飞书把结果回传给你。

2、解决当下的问题

你的问题 技能解决方案 你将得到的
邮件太多,一封封点开很费时间 自动分类:紧急/重要/订阅/通知/收据/其他 一眼看清收件箱,不用逐封翻
重要邮件被订阅和验证码淹没,容易漏看 先给摘要,紧急/需回复单独标出 重要邮件不落地,不再漏
想回邮件时每次从零组织语言 对需回复的邮件生成对应回复草稿 草稿确认就能用,省时间
新闻/通知类太多,干扰大 识别后提示可归档(需你确认) 收件箱变清爽
怕工具乱动我的邮箱 全程只读:不标已读、不发送 放心用,不会调用邮箱进行自动发送


二、开始前需要准备什么


· 已安装好 Codex    https://openai.com/codex

· 已安装好Python 3.10 或更高版本  https://www.python.org

· 一个DeepSeek API key  https://platform.deepseek.com

· 一个飞书账号平台  https://open.feishu.cn

· 一个支持 IMAP 的邮箱

· 本教程后的项目压缩包

 



三、在飞书后台创建机器人


操作如下:

登录 https://open.feishu.cn/app ,创建“企业自建应用”,应用名称可以随意填写,例如“邮箱小助手”。创建后先进入“添加应用能力”,启用“机器人”。

添加权限:

在“权限管理”里开通以下权限:

l im:message

l im:message:send_as_bot

l im:message.p2p_msg:readonly

l im:message.group_at_msg:readonly

配置事件订阅

进入“事件与回调”,订阅方式选择“使用长连接接收事件”,添加事件 :im.message.receive_v1。

发布应用

权限和事件配置完成后,到“版本管理与发布”创建版本并发布。发布后回到“凭证与基础信息”,复制 App ID 和 App Secret。这两个值稍后要填进 config.env。

注意:权限或事件修改后需要重新发布版本,否则机器人可能收不到消息。

 



四、准备 DeepSeek key 和邮箱授权码


操作如下:

DeepSeek API key

到 DeepSeek 开放平台创建 API key,并确保账户有余额。机器人不会直接使用飞书的模型能力,而是由 Python 后端调用 DeepSeek 完成分类和回复草稿。

开通邮箱 IMAP

以 163 邮箱为例:登录网页版邮箱,进入“设置”里的 POP3/SMTP/IMAP,开启 IMAP/SMTP 服务,按页面提示完成短信验证后生成“客户端授权码”。其他邮箱的开启位置不同,但填法一致。



五、填写 config.env


操作如下:

安装包里的 config.env 是公开模板,里面只有占位符。双击“创建配置-Mac.command”或“创建配置-Windows.bat”,脚本会自动复制出 config.env 并打开编辑器,不需要手动输入路径。

至少需要填写以下内容:飞书的 App ID 和 App Secret、DeepSeek API key、邮箱地址、IMAP 服务器、IMAP 用户名和邮箱授权码。

FEISHU_APP_ID=cli_你的应用ID
FEISHU_APP_SECRET=你的应用Secret
DEEPSEEK_API_KEY=sk-你的DeepSeekKey
EMAIL_ADDRESS=you@example.com
IMAP_SERVER=imap.your-email-provider.com
IMAP_USERNAME=you@example.com
IMAP_PASSWORD=你的邮箱授权码

不同邮箱的 IMAP_SERVER

l 163 邮箱:IMAP_SERVER=imap.163.com

l QQ 邮箱:IMAP_SERVER=imap.qq.com

l Gmail:IMAP_SERVER=imap.gmail.com

l Outlook / Microsoft 365:EMAIL_PROVIDER=outlook,IMAP_SERVER=outlook.office365.com



六、安装 Python 依赖并启动测试机器人


操作如下:

用户电脑只需要提前安装 Python 3.10 或更高版本。Mac 使用“启动-Mac.command”,Windows 使用“启动-Windows.bat”,第一次启动时会自动创建 .venv 并安装依赖,不需要单独安装。

启动

最简单的方式是双击安装包里的“启动-Mac.command”或“启动-Windows.bat”。脚本会自动进入自己的目录,第一次运行时会自动创建 .venv 并安装依赖,不需要手动输入下载路径。

如果熟悉终端,也可以在解压后的文件夹里打开终端后执行 python3 bot.py(Mac)或 python bot.py(Windows)。

看到类似 connected to wss://msg-frontier.feishu.cn 的日志,就说明机器人已经连上飞书。

在飞书里调用

在飞书里搜索刚刚发布的机器人,进入私聊后发送:

未读邮件 10

需要生成回复草稿时,发送:

未读邮件 10 并且把需要回复的给我生成回复信息

机器人会返回未读邮件分类摘要、总览、需要人工回复的邮件清单,以及针对需要回复邮件的草稿。



七、如何在codex中做这个项目


先把 email-automation skill 发给 AI,并说:“请先阅读这个 skill,理解它的邮箱处理能力。”

然后继续发这一段:“把 email-automation skill 做成独立的飞书机器人项目,不要做成 Codex 技能,用 Python + DeepSeek 实现。功能要求:用户在飞书私聊机器人发送‘未读邮件 10’。机器人通过 IMAP 只读读取最近 10 封未读邮件,调用 DeepSeek 分类为:紧急、重要、订阅营销、通知、单据、其他。返回每封邮件的中文摘要、需要回复的邮件清单,并对需要回复的邮件生成回复草稿。全程不标记已读、不归档、不发送邮件。   

文件要求:bot.py:飞书机器人长连接入口;email_reader.py:IMAP 只读拉信;classifier.py:DeepSeek 分类和草稿生成;config.env:所有个人信息配置,代码里不能出现真实账号;requirements.txt:依赖清单直接给我完整可运行的代码。”



八、完整Skill和完整项目代码


完整Skill:

https://superi.mfdemo.cn/chaoji/2026/09/10/6aa258a1a3b6c.zip

完整项目代码:

https://superi.mfdemo.cn/chaoji/2026/09/10/6aa25906e6bac.zip