給 DeepSeek Harness（DSH）的 IMAP 多賬號郵件分類插件，支持三層垃圾判斷與緩存優先的即時報告。解決多郵箱收信、分類與報告的痛點。
核心機制¶
插件採用「前臺後臺分離」的架構，前臺只讀緩存，後臺 worker 獨立輪詢收信。
- 前臺（只讀）：讀取本機緩存的
index.json或state.json，命令如/mail_brief，不聯網、不等授權，響應毫秒級。 - 後臺（輪詢）：獨立進程，默認每 5 分鐘輪詢一次（可配置
sync.pollIntervalMs）。IMAP 只讀拉取預覽（BODY.PEEK[]），不置\Seen，不下載附件。支持斷點續傳（基於UIDVALIDITY和UID）。 - 三層判斷：
1. 硬規則：黑名單、冒充檢測、釣魚特徵、無退訂營銷。
2. 啓發式打分：基於歷史互動、關鍵詞、附件類型、SPF/DKIM 結果打分（0-100）。
3. 模型仲裁：當前無內置實現，默認關閉，僅暴露適配點，不提供上傳第三方服務的能力。
安裝與配置¶
安裝¶
尚未發佈到 npm，需使用 GitHub 安裝命令。請使用固定版本 v0.2.3。
dsh plugin add github:Ronniealgo/dsh-mail-guardian#v0.2.3
配置要點¶
- 憑據引用：配置裏必須使用
credentialRef引用，不能直接填寫密碼。值存入 DSH 密鑰庫的refs段。 - 必填項：
accounts列表。不配置也能啓動，但報告會提示未配置。 - 自動化開關：
automation.moveRules和automation.moveHeuristics默認爲false，需手動開啓纔會自動分類移動。
常用命令與工具¶
側欄與指令¶
/mail_brief：立即顯示本機最新報告，不聯網、不收信。/mail_check：查看各賬號同步狀態與上次成功時間。mail_move：移到指定文件夾，必須帶confirm參數。
Agent 工具（只讀與改信分離）¶
- 只讀工具（不聯網）：
mail_report（今日報告）、mail_summarize（簡報）、mail_list（列表）、mail_search（檢索本地緩存）。 - 改信工具（需確認）：
mail_move（移動）、mail_mark（標記狀態）、mail_pending（處理待定郵件，需confirm）。
安全與行爲邊界¶
- 不做永久刪除：插件不支持全局
EXPUNGE，僅支持移動到垃圾箱或歸檔。服務器不支持MOVE/UIDPLUS且非 Gmail 時，直接拒絕移動。 - 不點擊、不加載：正文鏈接只做文本分析，不訪問；不加載遠程圖片，防止追蹤。
- 操作需確認：任何移動操作（
mail_move）都必須帶confirm。插件不會自動回覆、轉發或發信。 - 零運行時依賴：依賴由 DSH 宿主提供，不打包第三方運行時。
