前言¶
DeepSeek Harness (DSH) 在運行智能體任務時，常需要在後臺會話或瀏覽器標籤頁中等待權限審批。當審批請求堆積時，開發者需要頻繁切換上下文窗口來處理這些彈窗。wxjgit/permission-popup 插件將當前會話和後臺會話的待審批請求聚合在頁面角落的卡片堆棧中，讓你無需跳轉頁面即可快速處理審批。
插件介紹¶
這是一個社區維護的插件，當前版本爲 MIT 許可證。插件通過 DeepSeek Harness 的 Web UI 插件機制，攔截並展示待處理的權限請求。
核心定位：在頁面角落顯示審批卡片，提供“允許一次”或“拒絕”的快捷操作。
已覈實事實：
* 作者：wxjgit
* 分類：客戶端
* 許可證：MIT
核心功能¶
插件具備以下功能：
- 多會話聚合：在頁面角落顯示當前和後臺會話的待審批卡片堆棧。
- 信息展示：當可用時，顯示會話標題、工具名稱、審批理由以及 Shell 命令。
- 快捷操作：通過現有的 DSH 審批通道，對卡片進行“允許一次”或“拒絕”操作。
- 觸發策略：支持
background（後臺）、always（總是）和hidden-only（僅隱藏時）三種觸發策略。 - 本地持久化：自動保存角位置、堆棧大小、可見性、通知設置和標題提醒偏好。
- 後臺通知：當瀏覽器標籤頁隱藏時，可發送桌面通知。
- 純淨無干擾：插件不向頁面添加提示文本、模型請求、Token 使用量或 KV 緩存內容。
安裝與啓用¶
通過 DSH 的命令行工具安裝到 Web 配置文件中。
dsh plugin --profile web add github:wxjgit/permission-popup
安裝後需要重啓 Web UI 以加載插件層：
dsh web
使用方式¶
插件在 Web 配置文件下自動激活。當滿足配置的觸發策略時，卡片會出現在指定角落。
- Allow once：僅批准當前顯示的請求。
- Reject：拒絕當前顯示的請求。
- 打開會話：點擊卡片上的琥珀色條帶，可跳轉到發起請求的會話窗口。
- 配置管理：點擊卡片堆棧上的齒輪按鈕，可配置觸發策略、卡片位置、最大堆棧數量、桌面通知開關以及標籤頁標題提醒。
瀏覽器標籤頁隱藏場景¶
當瀏覽器標籤頁最小化或隱藏時，頁面角落的卡片可能無法直接被看到。此時需要啓用插件設置中的“Desktop notify while hidden”（隱藏時發送桌面通知）並授予網站通知權限。收到系統通知後，點擊通知可聚焦瀏覽器並打開相關會話。
適用場景與注意¶
- 環境要求：DeepSeek Harness 目前處於預發佈階段，插件 API 和兼容性要求在首次打標籤前可能發生變化。建議在兼容
0.1.1-rc.2客戶端包的 DSH 環境中使用。 - 權限安全：插件不繞過 DSH 的權限檢查，決策通過現有的
PendingWait響應通道執行。卡片僅在宿主廣播approval/resolved後消失。 - 通知內容：桌面通知僅包含會話標題和審批理由或工具名稱，出於隱私考慮，不會包含完整的命令參數。
- 數據存儲：用戶偏好存儲在瀏覽器的
localStorage中，鍵名爲dsh-permission-popup.prefs。 - 源碼審查：由於這是社區項目，在敏感環境中使用前，請務必審查第三方插件源碼，並鎖定可信的 commit 版本。
結語¶
該插件通過聚合審批流程，簡化了多會話環境下的交互步驟。更多細節和源碼可參考項目目錄頁或 GitHub 倉庫。
