前言¶
在 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
