前言¶
在使用 DeepSeek Harness (DSH) Web 進行開發或操作時，常會遇到需要介入處理的場景：等待授權（如寫文件、運行命令）、回答用戶提問、確認計劃、或查看目標阻斷原因。DSH 默認的處理方式要求進入會話並翻看對話，這種方式需要頻繁切換上下文，容易打斷思路。
dsh-hover-approve 插件將交互停留在會話列表這一行：當會話處於等待授權、提問、計劃確認或目標阻斷狀態時，會在左側會話行旁自動彈出氣泡，通過一條引線和圓點指明對應會話，氣泡內可直接拒絕、授權或作答，無需進入會話。
插件概覽¶
- 名稱：
dsh-hover-approve - 作者：wydddddcool
- 分類：客戶端
- 許可證：MIT
- 核心價值：DSH Web 側邊欄錨定氣泡，在會話列表行旁一鍵處理等待授權/提問/計劃確認/目標阻斷的會話。
核心功能¶
- 授權操作：當會話請求權限（寫文件、運行命令等）時，氣泡展示操作類型、智能體說明、要寫入的文件（高亮塊）與命令，支持直接拒絕或授權。
- 回答用戶提問：當
askUserQuestion提問到來時，氣泡展示問題與選項（單選或多選），支持直接作答。 - 確認計劃：當需要確認計劃時，氣泡以卡片形式展示計劃正文與批准/拒絕選項，點擊即答。
- 處理目標阻斷：當目標進入 blocked 階段時，氣泡以紅色大字展示阻斷原因與目標內容，可一鍵“去會話查看”。
- 氣泡特性：
- 自動彈出，無需懸停。
- 信息完整，文件路徑高亮，命令可展開。
- 點氣泡外任意區域或關閉按鈕關閉，本輪不再彈，新一輪交互重新彈出。
- 跟隨列表滾動，多個會話同時有交互時橫向錯開。
- 已歸檔會話不彈出。
安裝與啓用¶
插件通過官方插件命令安裝。安裝完成後需重啓 DSH Web 服務。
dsh plugin --profile web add https://github.com/wydddddcool/dsh-hover-approve
執行上述命令後，依賴會自動安裝並註冊到 cordis.patch.yml，重啓服務即可生效。
使用方式¶
安裝並重啓 DSH Web 後，插件會自動監聽會話狀態。
1. 當有交互需求時，會話行右側會出現錨定氣泡。
2. 在氣泡中直接進行拒絕、授權或作答操作。
3. 點擊氣泡外部區域可關閉氣泡。
適用場景與注意¶
- 適用場景：DSH Web 用戶需要頻繁處理列表中的待確認事項，希望減少在會話列表和會話詳情之間切換的頻率。
- 運行機制：命令只在
callId匹配到 running call 時顯示（bash 類工具）；非 bash 工具只顯示操作類型和說明。 - 依賴限制：行到會話的映射依靠標題評分匹配（精確匹配優先），極端重複標題可能存在錯錨風險（概率極低）。
- DOM 結構依賴：氣泡依賴 DSH 內置列表的 DOM 結構
[role="treeitem"]。若 DSH 升級改動此結構，氣泡可能靜默失效。 - 歸檔處理：歸檔會話不會觸發氣泡彈出，歸檔或取消歸檔操作會即時生效。
- 非官方產品：本插件爲社區插件，遵循 MIT License，非 DeepSeek 官方產品。
結尾¶
dsh-hover-approve 通過錨定氣泡的方式，簡化了 DSH Web 中對會話交互的響應流程。如果你在處理會話列表時需要頻繁打斷流程去確認權限或回答問題，可以考慮使用此插件。
