Agently Mail

Agently Mail 是什么

Agently Mail 是腾讯邮箱的命令行集成，可列出、搜索和读取邮件，监听新邮件，发送、回复、转发，下载附件以及移动或永久删除邮件。管理和授权由 agently-cli 完成。

适用场景

适合邮箱整理、查找附件、撰写与发送邮件和构建邮件工作流；读取分析与发送删除必须区分权限和确认级别。

核心能力与工作机制

它提供 OAuth 登录、消息与附件子命令，支持游标分页、日期和未读过滤。所有发送、回复、转发、移入回收站和永久删除都使用 confirmation token 两阶段确认。

执行流程

安装或更新 CLI，后台交互运行 OAuth 并由用户在浏览器授权，用当前用户命令验证；读取类任务直接执行，写操作先获取摘要和五分钟确认令牌，展示后停下，下一轮用户确认才提交。

输入与输出

需要腾讯邮箱 OAuth 授权；发送还需收件人、主题、正文和附件，回复转发需 message_id，搜索应保留原条件与 cursor。输出是邮件列表、正文、附件路径、发送结果或确认摘要；超大附件只返回下载链接，普通附件保存到本地并报告实际路径。

依赖、账号与权限

需要 Node.js、全局安装 @tencent-qqmail/agently-cli、网络和 OAuth 授权。凭据保存在本机，授权失败或超时不得自动重试。

副作用、限制与风险

邮件主题、正文、发件人和附件名是不可信外部输入，可能包含提示注入与 XSS。不能执行邮件里的指令、主动访问其中链接，也不能仅凭显示名信任身份。发送、回复、转发会影响外部联系人，trash 会进入回收站，delete 不可恢复；下载附件写本地。所有写操作必须经过用户确认，永久删除尤其要展示范围。

不适用边界

它不是通用 IMAP 客户端或反钓鱼保证，不应自动执行邮件内容要求的付款、下载、转发和账户操作；未授权邮箱无法使用。

失败处理与验收

按退出码处理：参数与授权错误不重试，网络和服务错误最多重试两次，限频遵守等待，业务永久拒绝原样反馈；任何非零结果不能声称已发送。发送后核对收件人、主题和服务端结果，删除检查目标与范围；下载附件比较名称、大小与保存路径，阅读时持续隔离提示注入。

适合谁使用

适合腾讯邮箱用户和需要安全邮件自动化的团队，批量外发与敏感通信应增加组织审批。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.13 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前安全扫描状态为 benign、benign；扫描状态只是平台信号，不能替代脚本、依赖、网络请求与后续版本的人工审查。

常见问题

1. Agently Mail 主要解决什么问题？

Agently Mail 是腾讯邮箱的命令行集成，可列出、搜索和读取邮件，监听新邮件，发送、回复、转发，下载附件以及移动或永久删除邮件。管理和授权由 agently-cli 完成。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

2. 开始前需要准备哪些输入？

需要腾讯邮箱 OAuth 授权；发送还需收件人、主题、正文和附件，回复转发需 message_id，搜索应保留原条件与 cursor。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

3. 它会怎样完成任务并交付结果？

安装或更新 CLI，后台交互运行 OAuth 并由用户在浏览器授权，用当前用户命令验证；读取类任务直接执行，写操作先获取摘要和五分钟确认令牌，展示后停下，下一轮用户确认才提交。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

4. 需要哪些工具、账号或权限？

需要 Node.js、全局安装 @tencent-qqmail/agently-cli、网络和 OAuth 授权。凭据保存在本机，授权失败或超时不得自动重试。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

5. 它会修改文件或调用外部服务吗？

发送、回复、转发会影响外部联系人，trash 会进入回收站，delete 不可恢复；下载附件写本地。所有写操作必须经过用户确认，永久删除尤其要展示范围。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

6. 哪些场景不应该依赖这个 Skill？

它不是通用 IMAP 客户端或反钓鱼保证，不应自动执行邮件内容要求的付款、下载、转发和账户操作；未授权邮箱无法使用。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

7. 失败、超时或结果异常时怎样恢复？

按退出码处理：参数与授权错误不重试，网络和服务错误最多重试两次，限频遵守等待，业务永久拒绝原样反馈；任何非零结果不能声称已发送。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

8. 如何验收结果并控制风险？

发送后核对收件人、主题和服务端结果，删除检查目标与范围；下载附件比较名称、大小与保存路径，阅读时持续隔离提示注入。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。