前言¶
用 DSH 跑長對話或等模型收尾時，人往往會切到別的窗口。輪次結束、要審批、要補答或要確認計劃時，如果沒有任何外置提醒，只能反覆切回客戶端看狀態。郵件或第三方推送可以補一層，但和「回到哪一條會話」往往還要自己記。dsh-task-ping 把桌面通知、Windows 上的提示音（並按通信活動壓低其他媒體）以及可選 SMTP 郵件推送放在同一個插件裏，在 README 描述的幾種觸發時機統一提醒；二級會話（子代理）不會打擾。
這是什麼¶
dsh-task-ping 是社區維護的 DSH 工作流類插件，倉庫 TianLingBy/dsh-task-ping，當前 npm 包版本 0.4.5（MIT）。定位一句話：每輪對話結束，以及需要你審批、回答或確認計劃時，用多種渠道提醒你；點桌面通知可跳回對應會話。
維護者 TianLingBy；插件目錄頁：https://www.skillhub.cn/plugins/TianLingBy/dsh-task-ping。SkillHub 等爲社區插件目錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
下面按 README 表格歸納三種手段及平臺範圍。
| 手段 | 說明 | 平臺 |
|---|---|---|
| 桌面彈窗 | 系統通知，點擊跳回對應會話 | Windows / macOS / Linux（瀏覽器通知） |
| 提示音 + 自動壓低音樂 | 經 通信端點 播放；Windows 按「通信活動」把其他媒體壓到 50%，播完恢復；不修改各應用音量 | Windows |
| 郵件推送 | 同內容再發一封到手機 | 全平臺 |
觸發時機（資料原文）：每輪對話結束；需要你審批；需要你回答；需要你確認計劃。二級會話（子代理）不觸發。
macOS / Linux 上 README 寫明：桌面彈窗與提示音能力以 Windows 爲主；郵件推送全平臺可用。
提示音依賴 PowerShell 7（pwsh）；未安裝時回退到系統自帶 5.1。
安裝與啓用¶
在 DSH 插件市場搜索 dsh-task-ping 一鍵安裝，或命令行：
dsh plugin --profile desktop add dsh-task-ping
裝完後完全退出並重開 DSH（客戶端模塊不支持熱更）。再到 設置 → 通用，確認「任務完成提醒」已打開。
設置頁：總開關與子項¶
設置 → 通用 → 「任務完成通知」 爲總開關：
- 打開：下方提示音、音量、郵件推送可分別調整。音量滑塊鬆開即試聽；連續點擊會打斷上一聲並用新音量重播，不疊加。
- 關閉：彈窗、提示音、郵件全部停用，子項 disabled 置灰鎖定；要改子項須先打開總開關。
桌面提醒（Windows）¶
提示音走 Windows 的 通信 播放端點，系統按「聲音 → 通信」檔位自動壓低其他媒體（默認 50%）。插件不直接改應用音量。
副作用：爲讓聲音落在當前播放設備上，插件會把「默認通信設備」同步爲當前播放設備；微信、遊戲語音等通信類應用可能跟着切換。若不需要，可在插件 index.js 裏把 '-SyncComm', '1' 改爲 '0'（README 說明）。
郵件推送（可選）¶
在 設置 → 通用 → 郵件推送 打開開關、填表，用 發送測試郵件 驗證。
- 郵箱類型：QQ / 163 / 126 / 騰訊企業郵箱 / Outlook / Gmail 選中後自動填服務器、端口與 TLS；也可在「發件郵箱」輸入地址，按域名匹配服務商。
- 授權碼框支持顯示/隱藏，便於覈對粘貼。
- 賬號保存在
~/.dsh/dsh-task-notify-push.json，不寫進插件目錄，也不進 localStorage。 - 授權碼不是登錄密碼；QQ 郵箱需在設置裏開啓 IMAP/SMTP 並取得 16 位授權碼。
- 修改即時生效；關閉推送只需關開關。
授權碼走環境變量¶
授權碼欄可填 env:環境變量名（例如 env:DSH_SMTP_PASS），發信時從 DSH 進程環境讀取；文件內僅留佔位符。
# 啓動 DSH 前設置（或在系統環境變量裏配）
$env:DSH_SMTP_PASS = '你的授權碼'
變量無值時，保存或測試郵件會提示「環境變量 XXX 當前沒有值」。
手寫配置（批量部署）¶
{
"enabled": true,
"host": "smtp.qq.com",
"port": 465,
"secure": true,
"user": "you@qq.com",
"pass": "env:DSH_SMTP_PASS",
"fromName": "DSH",
"to": "you@qq.com"
}
secure: true 對應 465 隱式 TLS；secure: false 用於 587/25 並嘗試 STARTTLS，服務器不支持 STARTTLS 時拒絕發信，避免明文傳授權碼。
排查¶
| 現象 | 日誌位置 |
|---|---|
| 裝了但完全沒反應 | ~/.dsh/dsh-task-notify-boot.log（啓動註冊） |
| 郵件沒收到 | ~/.dsh/dsh-task-notify-push.log（sent / failed 與 SMTP 錯誤碼） |
| 聲音沒響 | %TEMP%\dsh-task-notify\play-comm.log（播放日誌） |
常見：AUTH pass: 535 多爲授權碼錯誤；connect timeout 多爲本機到 smtp.qq.com:465 不通。
適用場景與注意¶
適合長時間掛 DSH、需要在輪次結束或人機交互節點（審批、作答、確認計劃）被叫醒的場景；離席時用郵件補一層。
安裝前建議自行查看 GitHub 源碼 與 MIT 許可證。插件以當前 DSH 進程權限運行；SMTP 憑據默認落盤在用戶目錄 JSON，或使用 env: 佔位降低文件泄露風險。
反饋與交流：QQ 討論羣 1130872026（DSH通知音效插件討論羣），一鍵加羣 https://qm.qq.com/q/9NMQdv8Emc；也可在倉庫開 Issue 或 Discussion。
結尾¶
dsh-task-ping 把「對話結束與關鍵交互節點」綁到桌面通知、Windows 通信端點提示音（帶媒體壓低）和可選郵件，減少盯屏成本。安裝命令見上文；詳情以 README 爲準。
