前言¶
在 DeepSeek Harness（DSH）裏並行開多個會話時，若每個任務完成都提醒一次，打斷會疊得很密。社區裏 attention-plugins 用主線/支線優先級和瀏覽器系統通知來減負，但仍依賴頁面與通知權限，最小化窗口或關閉權限後體驗會打折。DSH_AttentionPlugins_Desktop（npm 包名 dsh-attention-toast，維護者 4478sc）沿用同一套優先級與事件模型，把提醒改成 Windows WPF / Linux GTK 的右下角桌面浮窗，由宿主常駐進程渲染，不搶焦點、不佔任務欄，也刻意去掉了自定義聲音。
這是什麼¶
這是 attention-plugins 的桌面版：主線任務儘快打斷你，支線可彙總，提問與審批始終打斷；投遞形態從「聲音 + 瀏覽器通知」改爲「桌面浮窗」。分類上屬於 DSH 客戶端插件：瀏覽器端跑通知引擎與設置，DSH 宿主通過 Typert 服務 attentionToast 拉起 toast_host.ps1（Windows）或 toast_host.py（Linux GTK3 / XWayland）。
與上游 0.2.2 相比，README 中的對照表寫明：三檔任務模式（含靜默）、子智能體等待、會話靜音等能力已合併進本倉庫；側欄主線星標與「點擊浮窗打開會話」尚未實現。
核心功能¶
主線、支線與任務模式¶
輸入框工具行的 ☆/★、會話行「…」菜單中的「設爲主線任務」可標記多個主線。任務模式包括：
- 主線模式：僅標記會話按主線立即彈浮窗，其餘按支線彙總一次。
- 均衡模式：未標記時全部按主線逐個提醒。
- 靜默模式：完成類事件不彈，提問與審批仍彈。
父會話結束而子智能體仍在運行時，可開啓「等待子智能體」，整波空閒後再彈（可關）。會話行菜單可對單會話靜音，該會話所有事件都不彈。
四類事件與門控¶
支持完成、出錯、提問、審批四類，可逐項開關；提問與審批始終打斷。「當前會話」分三檔：僅在後臺 / 失焦或後臺 / 總是提醒。總開關默認開啓；「當前會話也提醒」默認關閉（正在看的會話完成不打擾，窗口最小化時仍提醒）。
桌面浮窗行爲¶
右下角堆疊，同屏約 1–6 個；按事件類型配色；自動關閉時長可選 4/6/8/12 秒；懸停暫停計時；點擊或 ✕ 關閉；高度隨內容自適應。浮窗無反向通道，暫不能點擊打開對應會話。
審批聯動（只讀）¶
安裝 dsh-approval-ledger 後，等待審批的浮窗可附帶本地正則預判的風險等級（high/medium），僅供參考。批准 / 拒絕 / 取消只寫入臺賬，不再彈結果浮窗。設置頁顯示臺賬連接狀態、最近統計與最近 5 條記錄。本插件只讀 $DSH_HOME/approval-ledger/ledger.jsonl，不攔截或修改審批決策；臺賬異常時降級爲無聯動，不影響其它通知。
架構概覽¶
數據從 DSH 客戶端的會話狀態與 pendingInteraction 進入通知引擎，經總開關、事件類型、當前會話與可見性門控後，通過 ctx.remote.attentionToast.show(payload) 到宿主；宿主以 stdin 一行一個 JSON 驅動浮窗進程。
| 路徑 | 作用 |
|---|---|
lib/client.js |
設置頁、主線標記、通知引擎、門控、remote 調用 |
lib/index.js |
宿主配置存儲、浮窗進程生命週期、Typert 服務 |
lib/toast_host.ps1 |
Windows WPF 浮窗宿主 |
lib/toast_host.py |
Linux GTK3 浮窗宿主 |
安裝與啓用¶
要求：DSH 桌面版 ≥ 0.1.7（README 註明在 0.2.1-rc.3 / 0.2.0-rc.3 驗證）；Windows 需 PowerShell 5.1；Linux 需 python3 + PyGObject。package.json 中 engines.dsh 同爲 >=0.1.7，當前發佈版本爲 0.2.2-desktop.13。
聯網環境可直接安裝（依賴自動拉取）：
dsh plugin --profile desktop add dsh-attention-toast
離線或需打包 zod 等依賴時，README 給出 pack-plugin.ps1 打 tarball 再 plugin add 的路徑示例；不要用 link: 安裝，以免 DSH 重裝或刪 profile 時穿透 junction 清空源碼目錄。
安裝後重啓 DSH 桌面版。卸載：
dsh plugin --profile desktop remove dsh-attention-toast
並刪除 ~/.dsh/storages/dsh-attention-toast 與瀏覽器中的 dsh-attention-toast:config。
典型用法¶
- 安裝並重啓 DSH 後，打開 設置 → Attention Toast，確認宿主連接狀態正常。
- 在需要優先關注的會話上標 ★ 或設爲主線任務；按需切換主線 / 均衡 / 靜默模式。
- 用設置頁的「測試浮窗」驗證宿主；無反應時查看
$DSH_HOME/storages/dsh-attention-toast/host.log末尾是否有spawn行。 - 浮窗不消失時先確認鼠標未懸停（會暫停計時），必要時點「重啓宿主」；Linux 需
DISPLAY可用（XWayland），純 Wayland 且無 XWayland 的環境 README 標明不支持。
界面配置在瀏覽器 localStorage 鍵 dsh-attention-toast:config；浮窗外觀（配色、時長、同屏數量）在 $DSH_HOME/storages/dsh-attention-toast/config.json。
適用場景與注意¶
適合在多會話並行、又不想被瀏覽器通知權限或頁面可見性綁架的 DSH 桌面用戶：窗口最小化或失焦時仍要在角落看到完成、出錯、提問與審批。
插件以當前 DSH 進程權限運行，安裝前請自行查看 GitHub 源碼 與 MIT 許可證；審批風險預判僅爲本地啓發式提示，不構成安全保證。社區插件目錄 SkillHub 條目 與 GitHub 倉庫獨立維護，並非 DeepSeek / 幻方官方應用商店。
結尾¶
DSH_AttentionPlugins_Desktop 在 attention-plugins 的優先級模型上，把提醒落到真正的桌面浮窗，併合並了三檔模式、子智能體等待與會話靜音等上游能力。需要詳情與路線圖（如浮窗反向打開會話、側欄星標）可直接查閱倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/4478sc/DSH_AttentionPlugins_Desktop
- GitHub：https://github.com/4478sc/DSH_AttentionPlugins_Desktop
