前言¶
在使用 DeepSeek Harness (DSH) 時，瀏覽器標籤頁休眠會導致 JavaScript 停止運行。這會導致審批、提問等卡片在網頁端卡住。dsh-attention 是一個用於 DSH 的提醒插件，旨在解決網頁休眠時錯過通知的問題。通知由 dsh 宿主發出，不依賴瀏覽器的 Notification API。
功能¶
該插件提供以下能力：
- 網頁休眠也能提醒：通知由 dsh 宿主發出，不走瀏覽器
Notification。標籤被凍住時 JavaScript 停了，審批、提問、會話結束照樣能彈窗。 - 卡片上直接處理：允許 / 拒絕、單選 / 多選、自定義輸入（標題爲「其他」）、寫下一步，點完即提交，會話繼續。不搶網頁上的審批卡片。多題卡片會逐題勾選，點「提交」才一起發送。
- 官方卡自動關閉：原卡先答完時，插件會把同一結果交給 DSH 官方審批 / 提問卡，讓網頁裏的卡片自動關閉，不需要刷新頁面。
- 主題跟隨：自制卡片亮色 / 暗色與當前頁面一致，毛玻璃圓角；底部倒計時條從綠變到紅。
- 兩種卡片樣式：默認自制卡片可在窗口裏操作；系統通知卡片只負責點回會話。
- 回到已有會話：「回到會話」優先前置已經打開的 dsh 窗口或 Edge 應用，並切到對應會話；也可每次新開。
- 多顯示器跟隨：彈窗默認出現在當前聚焦顯示器的右下角；找不到焦點屏幕時自動回退到主顯示器。
- 按鈕佈局統一：審批卡片爲「允許 / 拒絕」左右佈局；會話結束 / 多選提交按鈕在左側，「回到會話」統一固定在右上角關閉按鈕左側。
- 當前窗口不打擾：dsh 標籤正在聚焦時不彈；切到別的窗口、標籤，或頁面隱藏時才提醒。
- 子代理結束提醒獨立控制：「子代理會話結束」開關默認關閉。開啓後彈窗會明確標註身份，並且不提供回覆輸入框。
安裝與啓用¶
使用官方插件安裝命令添加該插件：
dsh plugin --profile web add dsh-attention
安裝完成後重啓 dsh web。
典型用法¶
- 模型申請提權：當模型申請提權時，右下角會出現允許/拒絕窗口。點「回到會話」切回該會話。在右下角答完後，DSH 網頁裏的審批卡會自動關閉。
- 提問 / 選擇：主會話單選點選項即提交；多選或多題先勾選再點提交；也可在「其他」裏自己寫答案。DSH 不允許受控子代理直接向用戶提問。
- 主會話一輪對話結束：在窗口裏寫下一步併發送。子代理結束提醒默認關閉；開啓後只提示並提供「回到會話」，不顯示回覆輸入框。
- 標籤休眠後再回來：隱藏超過約 8 秒會自動刷新一次（等同 F5），把還掛着的審批卡片重放出來。正在輸入時不會刷新；將隱藏刷新時間設爲
0（關閉）或-1（無限）都可關閉自動刷新。 - 設置控制：在設置 → 提醒 裏用頂部開關控制通知總開關，再在分組裏調整提示音、回到會話方式、樣式等。
配置說明¶
配置覆蓋 cordis.patch.yml 或 profile 裏的 dsh-attention 的 config 字段。數值類配置約定：0 = 關閉該項功能，-1 = 無限（不設上限）。
| 字段 | 默認值 | 說明 |
|---|---|---|
enabled |
true |
總開關 |
notifyApproval |
true |
提權審批 |
notifyQuestion |
true |
提問 / 選擇 |
notifyIdle |
true |
一輪對話結束後的下一步輸入 |
notifySubagentIdle |
false |
子代理會話結束通知；彈窗不提供回覆輸入框 |
notifyStyle |
custom |
custom 自制卡片；system 系統通知 |
notifyTimeoutSec |
30 |
停留秒數；-1 無限，0 關閉自動消失 |
cardOpacity |
0.78 |
自制毛玻璃卡片不透明度，0.1–1 |
openSessionMode |
reuse |
reuse 複用已有窗口；new 每次新開 |
hiddenReloadMs |
8000 |
標籤隱藏多久後喚醒要刷新（毫秒） |
settledMax |
50 |
記住多少條「已用彈窗答過」的記錄，用於自動關掉網頁卡片 |
sound |
系統默認提示音 | 設爲 false 靜音 |
choiceShellPath |
自動 | 自制卡片使用的 PowerShell（默認優先 pwsh 7） |
注意事項¶
- 交互方式：選擇 / 允許 / 下一步走右下角自制窗口，不依賴系統通知按鈕回調。
- 自動刷新機制：自動刷新是對標籤休眠後 pending 卡片丟失的緩解，不是給連接層打補丁。
- 自動關閉限制：自動關閉依賴插件內存裏的「已答記錄」：超過
settledMax條後最舊的會被丟棄，此時若卡片被重放，需要手動點一次。 - PowerShell 版本：自制卡片優先用
pwsh7，缺失時回退 Windows PowerShell 5.1；系統通知仍用 5.1 的 WinRT Toast。 - 系統限制：自制卡片和系統通知只在 Windows 上彈出；其它系統裝上後設置頁和休眠喚醒刷新仍可用。
- 回到會話：「回到會話」按窗口標題 / PWA 名稱匹配；dsh 若在後臺標籤裏，可能只能把整個瀏覽器前置。
- 多開與前置：多開 DSH 時端口能區分實例和目標會話，但 Windows 無法可靠地前置普通瀏覽器裏的指定標籤；需要精確打開時選「新開」。
- 兼容性：適配 DSH 0.1.2-alpha.3 及其新版 Remote/Waterfall API，不兼容使用舊
apiProxy接口的 DSH 版本。
總結¶
dsh-attention 通過在 dsh 宿主層面提供通知，解決了瀏覽器標籤休眠導致交互中斷的問題。它支持在卡片上直接處理審批、選擇和下一步輸入，並能自動關閉網頁上的原生卡片。如果你在使用 DSH 時經常遇到網頁休眠導致審批卡卡住的情況，該插件是必要的補充。
- 目錄頁: dsh-attention (SkillHub)
- GitHub 倉庫: anlifex/dsh-attention
