前言¶

在 agent 里处理邮件，常见做法是接入一个邮件客户端库或走 IMAP/SMTP 协议自己写。对国内用户来说，QQ 邮箱还多一道门槛：部分客户端要求扫码登录或单独开授权码，接入方式不统一。下面介绍的 QQ邮箱助手，把这套收发流程收敛到一个 SKILL.md 里，让 agent 能直接列收件箱、读信、写信、搜索，不需要用户手写协议代码。

这是什么¶

QQ邮箱助手是一个社区来源的 Skill，坐标 @user_213bfd3b/qqmail-helper，版本 1.0.0，发布者 user_213bfd3b。它通过 Python 的 imaplib 和 smtplib 两个标准库模块收发 QQ 邮件，定位是「需要查看邮件、发送邮件、搜索邮件内容」时使用。它同时声明可替代 agently-mail 的微信扫码登录方案。

核心功能¶

根据官方简介，该 Skill 支持四项能力：

• 收件箱列表
• 阅读邮件
• 发送邮件
• 搜索邮件

触发词包括：邮件、邮箱、收件箱、发邮件、未读邮件、最近邮件。这几个词覆盖了「查收」和「发送」两条主路径。

安装与启用¶

官方地址：

https://api.skillhub.cn/user_213bfd3b/qqmail-helper

SkillHub 页面：

https://www.skillhub.cn/skills/user_213bfd3b/qqmail-helper

安装命令和具体配置字段，已抓取资料中未给出。标签信息显示该 Skill requires_api_key=true，说明启用前需要先准备可用的凭据。QQ 邮箱走 IMAP/SMTP 时通常需要邮箱授权码而非登录密码，这一细节请以官方页面为准，本文不作断言。

Cursor、Codex CLI、Claude Code 在该 Skill 上的启用方式是否有差异，资料未提及，此处不写。

典型用法¶

已抓取资料中只提供了简介，没有提供可复现的命令示例或调用参数。因此本文不虚构用法。建议拿到 Skill 后，按其 SKILL.md 中的描述先跑一次收件箱列表，确认凭据和授权方式正常，再试发送。

适用场景与注意¶

适合需要在 agent 工作流里处理 QQ 邮箱的开发者，尤其是希望用标准库而不是第三方邮件客户端的场景。

需要注意的点：

1、该 Skill 依赖 Python imaplib 与 smtplib，均为标准库，但要求运行环境能直连 QQ 邮箱的 IMAP/SMTP 服务地址与端口。
2、requires_api_key=true，启用前必须配置凭据，凭据字段名以官方页面为准。
3、涉及发送邮件时，注意授权码与发送频率限制，避免触发风控。
4、该 Skill 为社区来源（community），更新和问题响应取决于发布者。

结尾¶

QQ邮箱助手把 QQ 邮箱的收、读、发、搜四件事收进一个 Skill，走 Python 标准库实现，接入路径明确。如果你需要在 agent 里处理 QQ 邮件，可先从官方页面确认凭据配置方式，再开始使用。

官方地址：https://api.skillhub.cn/user_213bfd3b/qqmail-helper