前言¶
讓 Agent 代你讀信、搜信、發信時，常見做法是接 IMAP/SMTP 或自建網關：憑證要交給模型側工具鏈，和個人 QQ 郵箱混用也容易誤操作。Agently Mail 由 QQ 郵箱團隊發佈，在 SkillHub 上以 @tencent-adm/agently-mail 提供，面向 Agent 的專屬郵箱與個人郵箱隔離，並聲明 requires_api_key=false，不依賴額外 API Key 配置。
下面介紹它是什麼、能做什麼，以及如何通過 SkillHub 安裝到當前 Agent 環境。
這是什麼¶
Agently Mail 是 QQ 郵箱團隊爲 Agent 打造的專屬郵箱服務。與個人郵箱隔離，按官方說明原生適配 Agent，用於在 Agent 工作流裏安全、高效地收發郵件。
- 維護方：QQ 郵箱（SkillHub 發佈者標註爲「QQ郵箱」）
- Skill 座標：
@tencent-adm/agently-mail（SkillHub 當前版本 1.0.13，分類 ai-agent，來源 enterprise） - 產品官網：https://agent.qq.com
- Skill 入口：https://www.skillhub.cn/skills/tencent-adm/agently-mail
核心功能¶
以下能力均來自 SkillHub 與官方 Skill 簡介，未在資料中出現的接口或參數不作延伸。
- 授權：支持微信登錄授權。
- 讀與搜：讀取郵件、搜索郵件。
- 寫與流轉：發送郵件、回覆、轉發；可將郵件移動到已刪除。
- 附件：上傳與下載附件。
Skill 採用通用 SKILL.md 格式，具體工具名與調用方式以安裝包內說明爲準。
安裝與啓用¶
官方頁面給出的安裝指引是：讓 Agent 參照 SkillHub 安裝文檔，安裝 @tencent-adm/agently-mail。對應人類可執行的流程如下。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
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、安裝 Agently Mail 到當前 Agent 的 skills 目錄¶
安裝技能時必須用 --dir 指向當前 Agent 實際使用的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法識別。
skillhub install @tencent-adm/agently-mail --dir <skills 目錄>
常用客戶端的 skills 路徑（摘自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
不同 Agent 的目錄名可能隨版本變化，以你本機配置爲準。安裝後按所用客戶端要求重啓或重新加載 Skills。
資料中未單獨列出 Cursor、Codex CLI、Claude Code 的差異步驟；三者差異主要體現在 --dir 目標路徑，安裝命令本身相同。
典型用法¶
公開頁面未提供獨立的腳本級「端到端示例」。可復現的用法路徑是：
- 按上一節完成
skillhub install @tencent-adm/agently-mail --dir <skills 目錄>。 - 在 Agent 對話中說明郵件相關任務（例如檢索某主題郵件、代發回復、處理附件）；Agent 讀取 Skill 內 SKILL.md 後調用對應能力。
- 首次使用按 Skill 指引完成微信登錄授權（官方簡介中列出的授權方式）。
不要在未閱讀 SKILL.md 的情況下假設具體的 HTTP 路徑或 JSON 字段。
適用場景與注意¶
適合：需要在 Agent 裏自動化郵件讀寫、檢索、回覆與附件處理，且希望與個人 QQ 郵箱賬號隔離的開發者或團隊。
注意：
- 賬號與數據邊界以官網 https://agent.qq.com 及 Skill 內說明爲準；個人郵箱與 Agently 專屬郵箱不要混用同一套操作假設。
- 標籤標明
requires_api_key=false，不代表無需登錄；微信授權仍是資料中明確列出的環節。 - 企業來源（enterprise）Skill，升級與合規要求以 SkillHub 與發佈方爲準，安裝前可用
skillhub search/ 商店頁覈對版本（當前 1.0.13）。
結尾¶
Agently Mail 把 QQ 郵箱團隊的 Agent 專屬郵件能力封裝成 SkillHub 上的 @tencent-adm/agently-mail：隔離個人郵箱、覆蓋讀搜發回轉發刪與附件，並支持微信授權。安裝時記住 skillhub install 的 --dir 與 Cursor / Claude Code / Codex 各自的 skills 路徑。
- SkillHub：https://www.skillhub.cn/skills/tencent-adm/agently-mail
- 官方 Skill 地址：https://api.skillhub.cn/tencent-adm/agently-mail
- 產品官網：https://agent.qq.com
