前言¶
DeepSeek Harness (DSH) 採用插件化架構，強調“一切皆插件”。在智能體開發或長期對話過程中，頻繁在主窗口和瀏覽器其他標籤頁之間切換會影響效率。本插件旨在解決這一問題，爲 Web GUI 提供一個懸浮的 Picture-in-Picture 聊天窗口，使開發者可以在不離開當前上下文的情況下查看流式回覆、切換會話或發送指令。
這是什麼¶
這是由 syncended 維護的一個瀏覽器插件，爲 DeepSeek Harness Web GUI 增加了一個緊湊的聊天界面。該界面支持原生懸浮、會話切換、流式傳輸跟隨以及即時回覆，同時保持與主窗口的會話狀態同步。
核心功能¶
插件提供了一套針對多任務處理的控制與展示能力：
-
會話管理與狀態
- 提供會話切換器，顯示當前會話的實時狀態（工作/等待/完成）。
- 支持按工作區分組的人類聊天切換（排除內部子代理會話）。
- 提供“新聊天”操作，用於打開或創建當前工作區的空白會話。
-
聊天交互與控制
- 支持 Markdown 緊湊型轉錄，包含流式推理、工具活動日誌、結果展示、歷史圖片以及複製、分支和加載更舊歷史的功能。
- 提供停止生成功能，以及隊列消息的編輯、移除和“立即發送”控制。
- 支持內聯審批、計劃審查和結構化用戶問題面板。
-
輸入與展示
- 支持圖片附件預覽，並通過公共會話 API 提交圖片+文本。
- 在緊湊編輯器內提供訪問模式、計劃模式、模型選擇、推理努力和上下文控制。
- 顯示緊湊的上下文信息、輪次/步驟數、吞吐量、緩存命中率和輸入/輸出令牌統計。
-
兼容性與輔助功能
- 多語言支持：響應式同步 Harness 設置中的語言選擇（英語、中文），並在兼容主機上提供俄語回退文本。
- 多主題與無障礙：支持深色主題同步，包含完整的鍵盤快捷鍵（Enter 發送，Shift+Enter 換行）和屏幕閱讀器標籤。
- 降級方案：原生 Document Picture-in-Picture API 僅在支持的 Chromium 瀏覽器上可用。當 API 不可用或被拒絕時，會自動回退到頁面內浮動面板。
安裝與啓用¶
插件通過 npm 包發佈，使用 DSH 的 Web profile 進行加載。
- 確保已安裝 DeepSeek Harness 0.1.0-rc.6 或兼容版本，並運行 Web profile (
dsh web)。 - 執行安裝命令：
dsh plugin --profile web add @syncended/dsh-pip
- 安裝完成後，重啓
dsh web並刷新現有的 GUI 界面。右下角將出現一個聊天氣泡按鈕，點擊即可打開懸浮窗口。
典型用法¶
- 點擊右下角的聊天氣泡按鈕打開懸浮窗口。
- 在懸浮窗口中切換會話、編輯隊列消息或發送即時回覆。
- 使用鍵盤快捷鍵：
Shift+Enter插入新行，Enter發送消息。
適用場景與注意¶
- 環境要求：需要 Node.js 18 或更新版本。
- 瀏覽器限制：原生 PiP 窗口僅在支持的 Chromium 瀏覽器上可用，其他瀏覽器會使用頁面內的備用面板。操作系統和瀏覽器將控制原生 PiP 窗口的幀、外角形狀和最終位置。
- 功能取捨：通用工具行設計爲緊湊，主 Harness 窗口更適合深入檢查大型工具負載。
- 安全提示：插件以當前 DSH 進程的權限運行。在安裝前，建議檢查源碼與許可證（MIT）。
結語¶
該插件通過將聊天界面從主窗口剝離並懸浮，降低了多任務處理的視覺干擾。它通過會話同步、即時控制和流式轉錄等功能，使開發者能夠更專注於當前的工作流。更多細節與源碼請訪問 GitHub。
