前言¶

DeepSeek Harness (DSH) 採用插件化架構。處理郵件通常需要調用第三方 API 或編寫腳本。zhengjy01/dsh-qqmail 插件將 IMAP/SMTP 協議能力直接集成到 DSH 中，讓智能體可以直接讀寫郵箱，無需額外的中間層。

插件介紹¶

這是一個爲 QQ Mail（以及任何 IMAP/SMTP 郵箱）設計的 DSH 插件。它提供 qqmail_* 代理工具、qqmail 命令行工具、qqmail-mcp stdio MCP 服務器和 Web 設置面板。認證使用 QQ 郵箱授權碼（無 OAuth，無 2FA 重定向）。

核心功能¶

插件提供完整的 IMAP/SMTP 郵箱操作能力，分爲只讀和讀寫兩類工具：

• 只讀工具：status（狀態檢查）、config（配置）、folders（文件夾列表）、list（郵件列表）、search（搜索）、read（讀取全文）、attachment（下載附件）。
• 讀寫工具：send（發送）、reply（回覆）、mark（標記/加星）、move（移動）、delete（刪除）。
• 附加組件：Web 設置面板、終端 CLI、MCP stdio 服務器。

安裝與配置¶

通過官方 CLI 安裝插件：

dsh plugin --profile web add github:zhengjy01/dsh-qqmail

安裝完成後，重啓 dsh web，在設置中即可看到 QQ 郵箱 卡片。

配置郵箱需要先在 QQ 郵箱網頁端開啓 IMAP/SMTP 服務，獲取 16 位授權碼。然後使用配置工具設置：

qqmail_config  email: "someone@qq.com"  authCode: "<16位授權碼>"

驗證連接是否成功：

qqmail status --probe

使用方式¶

插件提供三種使用入口：

1. DSH 代理工具¶

在 DSH 的系統提示詞中，智能體會自動識別 qqmail_* 工具。智能體可以執行搜索、讀取、標記等操作。

2. 終端 CLI¶

使用 qqmail 命令行工具進行交互：

# 檢查狀態
qqmail status --probe

# 列出未讀郵件
qqmail list --mailbox INBOX --limit 20 --unseen

# 搜索郵件
qqmail search --from finance --since 2026-09-01

# 發送郵件
qqmail send --to a@b.com --subject "Hi" --text "Body" --attach ./report.pdf

# 回覆郵件
qqmail reply 12345 --text "收到"

# 標記與移動
qqmail mark 12345 --seen --flag
qqmail move 12345 --to "Archive"

# 永久刪除（默認是移入回收站）
qqmail delete 12345 --permanent true

3. MCP stdio 服務器¶

爲不支持 DSH 插件的 Agent 提供接口，配置如下：

{
  "mcpServers": {
    "qqmail": {
      "command": "npx",
      "args": ["-y", "@zhengjunyao/dsh-qqmail", "qqmail-mcp"]
    }
  }
}

行爲與配置¶

配置文件存儲在 <DSH_HOME>/dsh-qqmail.json，文件權限爲 0600。

• 只讀模式：默認 readOnly: true，此時不會註冊任何寫入工具，防止智能體誤操作。
• 刪除策略：默認將郵件移入回收站。如需永久刪除，需在調用 delete 時指定 permanent: true。
• 安全性：授權碼以 0600 模式存儲，且僅在 Web 面板和工具結果中顯示掩碼，不會暴露給模型或記錄在日誌中。TLS 證書強制驗證。

適用場景與注意¶

• 適用場景：需要智能體處理內部郵件通知、自動回覆或歸檔郵件的 DSH 用戶。
• 權限注意：插件以當前 DSH 進程的權限運行，請確保在安裝前檢查源碼與許可證（MIT）。