前言¶
DeepSeek Harness (DSH) 採用插件化架構。對於需要在 Web 界面中集成郵件系統的開發者,hun1315/tencent-agent-mail-dsh-plugin 提供了一個基於騰訊 Agent Mail (agent.qq.com) 的全屏工作臺解決方案。該插件允許用戶在 DSH 內直接進行郵件輪詢、入庫、分類和 LLM 整理,無需跳轉外部網頁。
核心功能¶
該插件主要提供以下能力:
1. 實時收信與入庫:DSH 在線期間每 60 秒(可配)後臺輪詢 Agently 郵箱,新郵件自動入庫本地 JSON 存儲。
2. 本地分類與 LLM 整理:支持 5 類規則分類(發票、排班表、工作流、指令任務、收件箱)。新郵件可由配置的 OpenAI 兼容模型進行摘要和結構化抽取(如發票金額、排班週期)。
3. 全屏工作臺 UI:提供日期分組列表、詳情滑出面板、本地搜索、ESC 分級關閉等交互。
4. 附件與歸檔:支持附件下載並打開(自動刷新授權),支持歸檔(軟刪除)與回收站恢復,發件記錄獨立分類。
5. 郵箱記憶:每封郵件的摘要自動追加至 memory/default.md。
6. 郵件遙控(命令通道):通過白名單郵箱發送含特定關鍵詞的郵件,可觸發 DSH 執行任務並回信。
安裝與啓用¶
該插件依賴 Node.js >= 18。
1. 安裝並登錄 Agently CLI:
npm install -g @tencent-qqmail/agently-cli
agently login
- 配置 LLM 憑據:
創建~/.dsh/dsh-mailbox/credentials文件,內容如下:
{
"base_url": "https://<your-endpoint>/v1",
"api_key": "<your-key>",
"model": "<model-name>"
}
- 安裝插件:
dsh plugin --profile web add github:<you>/dsh-mailbox
- 初始化:
安裝後需在 DSH 對話框中完成 LLM Key 綁定等初始化步驟,插件默認通過npm root -g探測 agently-cli 入口。
注意事項¶
- 環境要求:Windows 優先,Linux/macOS 理論可用但未完整驗證。必須安裝 Node.js >= 18。
- 安全性:郵件正文被視爲不可信輸入,僅進行純文本渲染,絕不執行。憑據存儲在本地
~/.dsh/dsh-mailbox/credentials.json,不提交至倉庫。 - 非即插即用:安裝後需在 DSH 對話框綁定 LLM Key,並編輯
~/.dsh/dsh-mailbox/settings配置白名單和輪詢間隔等參數。
結語¶
該插件將騰訊 Agent 郵箱的收發與管理能力深度集成到 DeepSeek Harness 的工作流中,特別適合需要通過 LLM 自動整理郵件、或通過郵件遙控 Agent 的開發者。完整配置文檔可參考 GitHub 倉庫。