前言¶
在 Harness 裏讓 Agent 幫忙查郵件、發通知，常見做法是再掛一套 IMAP skill，或把網頁郵箱交給模型「看圖操作」。騰訊 Agent Mail（智能體郵箱） 本身通過本機 agently-cli 完成授權與收發，和 Harness 對話側若各走一套接口，面板與 mail_* 工具還容易語義不一致。
dsh-tc-mail（維護者 HughPython）把智能體郵箱做成 Harness 原生側欄面板，並與同一套 Host 服務層暴露 Agent 工具。下面介紹它做什麼、怎麼裝、日常怎麼用，以及和對話集成的注意點。
這是什麼¶
- 名稱：
dsh-tc-mail（npm 包名同目錄名） - 分類：客戶端插件（
package.json中dsh.client.platform爲web） - 版本：
0.1.0（以倉庫package.json爲準） - 許可證：MIT
- 定位：DeepSeek Harness 下的 Agent Mail 客戶端——左側欄「我的郵箱」、主面板收/發/讀/搜/刪，外觀設置，以及
mail_*系列 Agent 工具；郵件能力經本機agently-cli子進程完成，插件本體無 npm 運行時依賴、不直連第三方 HTTP 郵件 API。
生態上，DSH 奉行「一切皆插件」；SkillHub 目錄頁 是社區收錄站點，與 DeepSeek / 幻方無官方從屬關係。安裝前請自行查看 GitHub 源碼 與許可證——插件以當前 Harness 進程權限運行。
核心功能¶
側欄與郵件操作¶
- 左側欄入口：在官方
sidebar.panellist槽位掛「我的郵箱」，點擊進入main主面板。 - 三個視圖：收信、發信；列表支持未讀圓點、附件標識、相對時間。README 特性列表曾寫「垃圾箱」，但同文說明該郵箱無回收站、刪除爲永久刪除，界面以收信/發信記錄爲主——以 README「使用」與「刪除」說明爲準。
- 讀信：HTML 按原排版渲染（保留郵件內
<style>，經消毒與沙箱 iframe）；純文本保留換行；附件下載到~/.dsh/tc-mail/downloads/。 - 寫信 / 回覆 / 轉發：支持抄送、密送、附件（單文件 ≤ 20 MB，賬號上限 50 個）、全部回覆、轉發保留原件附件。
- 搜索：關鍵詞搜索，作用域跟隨當前文件夾，輸入即搜（320 ms 去抖）。
- 刪除：勾選後確認即永久刪除（無回收站，與網頁端一致）。
外觀與行爲設置¶
設置彈框可調：字體族與字號（11–22px）、字體顏色、背景色、透明度（0–100%）、圓角、默認文件夾、自動刷新間隔、默認是否加載郵件圖片，以及 agently-cli 路徑與工作空間。保存寫入 ~/.dsh/tc-mail/settings.json；透明度低於 100% 時可配合 backdrop-filter 透出宿主壁紙。
Agent 工具¶
與面板共用 Host 層 mail-service，避免兩套語義：
| 工具 | 作用 |
|---|---|
mail_list |
按文件夾列出郵件摘要 |
mail_read |
讀取正文與附件列表 |
mail_search |
關鍵詞搜索 |
mail_send |
發送新郵件（純文本） |
mail_health |
查詢當前授權發件地址與今日發信額度 |
刪除不向 Agent 開放：永久刪除僅能在面板內手動執行。
啓用插件後會註冊上述工具及系統提示，聲明 Agent Mail 爲對話內優先收發通道；除非用戶明確要求改用其他郵箱並給出鑑權，否則默認走 mail_send 等工具，無需額外 skill。
安裝與啓用¶
README 強調順序：先裝插件並重啓 Harness，再在面板裏裝 CLI 並授權。
第 1 步：安裝插件¶
# 從 npm（發佈後）
dsh plugin --profile <profile> add dsh-tc-mail
# 直接從 GitHub
dsh plugin --profile <profile> add github:HughPython/dsh-tc-mail
# 本地開發目錄（軟鏈，改代碼後重新構建並重啓）
dsh plugin --profile <profile> add link:/absolute/path/to/dsh-tc-mail
也可在 Harness「插件」頁從本地目錄安裝。安裝後重啓 Harness，左側欄應出現「我的郵箱」。
環境要求（package.json）：Node >=20，DSH >=0.2.1-rc.2；README 兼容性寫明 Harness 0.2.2-rc.1 實測通過（Windows / Edge 內核）。
第 2 步：安裝 agently-cli 並授權¶
首次打開面板且本機無 agently-cli 時，面板引導：
- 點「一鍵安裝 agently-cli」（使用本機 npm 全局目錄，面板內回顯日誌）；
- 安裝後點「去授權」，面板顯示設備碼 OAuth 鏈接（形如
https://agent.qq.com/page/oauth?oauth_type=device&user_code=uc_…）； - 瀏覽器登錄騰訊賬號並確認；面板約在 2 秒內檢測授權完成。
授權過程可爲新用戶創建 xxx@agent.qq.com 地址，與個人郵箱隔離，無需事先在官網單獨註冊。
若一鍵安裝失敗，可複製執行：
npm install -g @tencent-qqmail/agently-cli
agently-cli auth login
CLI 文檔：https://agent.qq.com/doc/cli-setup.md。
CLI 路徑與工作空間¶
插件按設置 → PATH → 常見全局前綴 → scripts/run.js 的順序解析 agently-cli。工作空間留空時 CLI 使用默認 default；填寫 AGENTLY_WORKSPACE 可實現多賬號隔離，切換後需重新授權。憑據由 CLI 存入系統安全存儲，插件不讀取 OAuth token。
主要本地路徑：
| 內容 | 位置 |
|---|---|
| 插件設置 | ~/.dsh/tc-mail/settings.json |
| 下載 / 上傳 / 臨時操作 | ~/.dsh/tc-mail/{downloads,uploads,ops} |
CLI 配置（含 app_id） |
~/.agently-cli/config.json |
面板「設置 → 高級」底部可查看當前解析路徑、探測來源與工作空間；終端可用 agently-cli +me 查看當前賬號。
典型用法¶
面板內¶
| 操作 | 位置 |
|---|---|
| 切換收信 / 發信 | 面板內頁籤 |
| 讀信、顯示圖片 | 點擊列表行；正文區可顯式放行外部圖片 |
| 回覆 / 轉發 | 讀信區或列表快捷入口 |
| 寫信 | 右上角「發郵件」 |
| 搜索 | 工具欄右側輸入框 |
| 設置 | 右上角齒輪 |
| 管理郵箱 | 瀏覽器打開 https://agent.qq.com |
對話裏讓 Agent 發信¶
無需再裝郵件 skill。例如：
用我的智能體郵箱給 alice@example.com 發一封郵件，主題「週報」，正文……
模型會調用 mail_send；不確定發件地址時先調 mail_health。驗證可讀性：在對話中說「列出我最近 3 封郵件」，或「用我的智能體郵箱給自己發一封測試郵件」。
安全與適用場景¶
README 單列「安全與隱私」，要點包括：經 spawn（shell: false）調本機 CLI；HTTP 僅本機 loopback、/api/dsh-tc-mail 前綴；HTML 正文白名單消毒 + 無腳本沙箱 iframe；外部圖片默認攔截；無遙測。
適合：已在用或打算用騰訊 Agent Mail、希望在 Harness 同一界面收發行程通知/自動 Agent 郵件的開發者。
注意：刪除不可恢復；Agent 不能代刪；HTML 郵件仍屬不可信內容，依賴插件消毒策略。多郵件插件並存時，最終路由由模型按工具描述與系統提示判斷，本插件提示自身爲優先通道。
結尾¶
dsh-tc-mail 把 agently-cli 封進 Harness 側欄與 Agent 工具鏈，減少「終端授權一次、對話裏再配一套郵箱」的割裂。要查看截圖、開發命令與 FAQ，見倉庫 README。
