前言¶
在 IDE 或 CLI 里写代码时，验证码、工单通知、合作邮件往往落在 QQ 邮箱里。切到网页客户端查信、复制正文再回来，上下文容易断。若希望用自然语言让 Agent 代为「列收件箱、按关键词找信、删信或发信」，需要一套把邮箱操作写进 Skill 工作流的方案，而不是每次手写 IMAP 脚本。
下面介绍 SkillHub 社区技能 QQ邮箱管理器（@user_6096add0/qmailmanager726），其定位就是在 Agent 侧承接 QQ 邮箱的常见读写与管理动作。
这是什么¶
QQ邮箱管理器 是发布在 SkillHub 上的社区 Skill（版本 1.0.0，分类 office-efficiency），由 user_6096add0 维护。
官方简介写明：支持收取、搜索、删除和发送邮件；当用户需要查看邮箱、查找邮件、管理邮件或发送邮件时使用。页面标签包含 requires_api_key=true，表示启用前需要配置与 API 密钥相关的凭据（具体字段名与获取方式以安装后包内 SKILL.md 为准，本文不臆造变量名）。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_6096add0/qmailmanager726
- API 入口：https://api.skillhub.cn/user_6096add0/qmailmanager726
核心功能¶
以下能力均来自官方简介，未在页面单独展开的实现细节不写入正文。
| 能力 | 说明 |
|---|---|
| 收取 | 查看邮箱、拉取邮件内容（具体交互由 Skill 内指引 Agent 执行） |
| 搜索 | 按用户意图查找邮件 |
| 删除 | 管理邮件时支持删除类操作 |
| 发送 | 代用户发送邮件 |
触发意图与简介一致：用户表达查看、查找、管理或发送邮件等需求时，Agent 应加载该 Skill 并按其中步骤操作。
安装与启用¶
SkillHub 页面给出的安装方式是：让 Agent 依照官方安装文档，安装坐标 @user_6096add0/qmailmanager726。
1. 准备 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明：沙箱或受限网络环境下，安装脚本需要允许访问外网。
2. 安装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 时，部分客户端不会自动加载。
skillhub install user_6096add0/qmailmanager726 --dir <你的 skills 目录>
常见路径（摘自 SkillHub 安装文档，按你使用的客户端择一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将官方提示词发给 Agent，让其阅读 https://skillhub.cn/install/skillhub.md 后完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_6096add0/qmailmanager726`。
3. 凭据与 API Key¶
SkillHub 元数据标签为 requires_api_key=true。安装成功后，请在技能包内的 SKILL.md（及同目录说明文件）中查看必填配置项、密钥申请方式与环境变量或配置文件写法；在凭据未配置完成前，不要对生产邮箱执行删除或群发类操作。
典型用法¶
官方未在展示页提供可复制的一键命令示例，用法以自然语言驱动 Agent 为主，与简介中的场景对齐即可：
- 查看邮箱：例如「帮我看看 QQ 邮箱最近有没有新邮件」「打开收件箱列一下」。
- 查找邮件：例如「搜一下主题里带『发票』的邮件」「找上周某人发来的邮件」。
- 管理邮件：例如「把这封邮件删掉」「整理某类通知邮件」（具体是否支持移动、标记等，以
SKILL.md描述为准）。 - 发送邮件：例如「用 QQ 邮箱给某人发一封说明会议时间的邮件」。
经过上面的步骤安装并配置凭据后，在对话中直接说明意图；Agent 按 Skill 约束调用底层脚本或接口，你只需在涉及删除、外发等操作时按 Skill 要求确认即可。
适用场景与注意¶
适合谁
- 日常使用 QQ 邮箱、希望在 Cursor / Claude Code / Codex 等环境里用对话完成查信、搜信、删信、发信的用户。
- 已愿意在 SkillHub 安装 CLI，并能为带
requires_api_key的技能配置密钥的开发者。
限制与注意
- 本技能为 community 来源，版本 1.0.0；行为细节以安装包内文档为准，升级前留意 SkillHub 上的版本说明。
- 下载安装包若失败（例如 API 返回 404），需在 SkillHub 页面确认技能是否仍可用，或联系发布者 user_6096add0。
- 邮件删除、对外发送属于高风险操作；务必在 Skill 要求预览或二次确认时再执行，并妥善保管 API Key / 授权码，勿提交到仓库。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 3188；数据随平台更新变化，以官网为准。
结尾¶
QQ邮箱管理器 把 QQ 邮箱的收取、搜索、删除与发送收敛到一条 Skill 坐标上，适合把「查邮、找邮、管邮、发邮」交给 Agent 处理。安装时记住 skillhub install user_6096add0/qmailmanager726 --dir <skills 目录>，并先读完包内 SKILL.md 完成 API Key 配置。
官方地址：https://api.skillhub.cn/user_6096add0/qmailmanager726
SkillHub 展示：https://www.skillhub.cn/skills/user_6096add0/qmailmanager726
