前言¶
在 DeepSeek Harness（DSH）裏做智能體時，常需要把外部信息拉進對話上下文。郵件是其中一個來源：驗證碼、工單通知、訂閱簡報都可能落在收件箱裏。自己寫 IMAP 客戶端要處理授權、編碼和 MIME 結構，還要把能力封裝成 Agent 可調用的工具。
dsh-qqmail 是社區維護的 Host 插件，通過 IMAP 連接 QQ 郵箱，向 DSH 暴露一組只讀工具，並附帶設置頁完成賬號配置與連通性校驗。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-qqmail（npm 包名 @qhao/dsh-qqmail）由 Q-hao516 維護，歸類爲聯網工具。插件在 Harness 進程內通過固定主機 imap.qq.com:993 讀取 QQ 郵箱，登錄使用 QQ 郵箱的 16 位授權碼，不是 QQ 密碼。
整體設計爲只讀：不發送、不刪除、不移動郵件，也不把郵件標爲已讀。
核心功能¶
插件註冊五個 Agent 工具和一個設置頁。
| 工具 | 作用 |
|---|---|
qqmail_inbox |
列出近期郵件，可選僅未讀 |
qqmail_read |
按 uid 讀取單封正文；支持 base64、quoted-printable、GBK/UTF-8 及 multipart/alternative 等常見解碼 |
qqmail_search |
按關鍵詞、發件人或起始日期搜索 |
qqmail_status |
返回已配置地址、總郵件數、未讀數 |
qqmail_setup |
在工具調用中保存郵箱地址與授權碼（替代走 UI） |
設置入口在 Settings → QQ Mail（settings.section，id 爲 qqmail）。頁面填寫地址與授權碼後點「保存並驗證」，會先向 imap.qq.com 校驗，成功後才落庫，並顯示類似「連接成功，N 封郵件 / M 封未讀」的結果。
授權碼以 credential 記錄保存，不作爲明文配置；設置表單將該字段標爲 secret。頁面通過同源路由 /dsh-qqmail/settings 通信，拒絕跨域與非 JSON 請求體。
環境與依賴¶
- DeepSeek Harness 版本不低於
0.2.1-rc.3（見package.json中engines.dsh）。 - QQ 郵箱已開啓 IMAP，並在 QQ 郵箱 → 設置 → 賬戶 → POP3/IMAP 服務 中生成授權碼。
安裝與啓用¶
在目標 profile 下執行以下命令之一（包內無構建步驟，JavaScript 隨包發佈）：
dsh plugin --profile <your-profile> add @qhao/dsh-qqmail
或直接從 GitHub 倉庫添加：
dsh plugin --profile <your-profile> add github:Q-hao516/dsh-qqmail
安裝後打開 Settings → QQ Mail，填入 QQ 郵箱地址與授權碼，保存並驗證通過即可在 Agent 中調用上述工具。
典型用法¶
配置完成後，Agent 可按任務組合調用工具，例如：
- 用
qqmail_status確認賬號與未讀概況。 - 用
qqmail_inbox（可加僅未讀）拉取最近郵件列表。 - 對感興趣的郵件用
qqmail_read傳入 uid 讀取正文。 - 需要篩選時用
qqmail_search指定關鍵詞、發件人或起始日期。
也可在對話中通過 qqmail_setup 寫入地址與授權碼，效果與設置頁一致，但仍需 IMAP 校驗成功纔會持久化。
適用場景與注意¶
適合： 已在 DSH 中開發智能體、需要從 QQ 郵箱只讀獲取郵件摘要或正文的工作流（提醒跟進、信息摘錄等），且能接受 QQ 郵箱與固定 IMAP 端點這一約束。
限制（以 README 爲準）：
- 僅支持 QQ 郵箱，無通用 IMAP 主機/端口配置。
- 只讀，不支持發信、回覆、過濾規則或附件下載。
- 信頭與正文解析覆蓋常見 MIME，不保證處理所有 MIME 變體。
安全與權限： 插件以當前 DSH 進程權限運行，會使用你配置的郵箱授權碼訪問郵件。安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的環境策略。DSH 社區插件目錄（如 SkillHub 目錄頁）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-qqmail 把 QQ 郵箱 IMAP 只讀能力收斂成五個工具和一頁設置，降低在 Harness 裏接郵件的集成成本。需要進一步瞭解實現細節或提交 issue，可訪問：
- 目錄頁：https://www.skillhub.cn/plugins/Q-hao516/dsh-qqmail
- GitHub：https://github.com/Q-hao516/dsh-qqmail
