前言¶
DeepSeek Harness (DSH) 的插件體系允許開發者擴展能力。在開發或使用 Agent 處理網頁時，頻繁切換瀏覽器窗口會打斷工作流。deep-browser 插件將 HTTP(S) 頁面嵌入到對話窗口的右側邊欄中，實現上下文與網頁的無縫銜接。
插件定位¶
這是 DeepSeek Harness 的一個插件，旨在在對話窗口的右側邊欄中打開和瀏覽網頁。由用戶 temidayoxyz 維護，遵循 MIT 許可證。它解決了在 DSH 環境中直接查看實時網頁的需求，而不是依賴截圖或外部瀏覽器。
核心功能¶
插件提供了一套基於當前 Web Profile 能力的瀏覽功能：
- 基礎操作：支持新建標籤頁、地址欄輸入、刷新頁面以及通過鏈接在系統瀏覽器中打開。
- 佈局控制：提供寬度預設（Fit / 390 / 768）。注意，這是針對 iframe 的 CSS 佈局調整，並非設備 UA 模擬。
- 交互邏輯：在 UI 中點擊 HTTP(S) 鏈接（無需修飾鍵）即可在側邊欄打開；本地 localhost / loopback 地址會自動轉換爲 http:// 訪問。
安裝與啓用¶
使用官方安裝命令即可：
dsh plugin --profile web add github:temidayoxyz/deep-browser
注意：從 git 安裝會拉取源代碼而非構建產物。插件通過 pnpm 的 prepare 腳本構建 lib/ 目錄。如果你的環境使用 pnpm ≥ 10，首次添加可能會因構建限制而失敗。此時，請將 pnpm 報錯的包密鑰複製到配置文件 pnpm-workspace.yaml 中：
allowBuilds:
dsh-deep-browser: true
重新運行添加命令。請確保只信任來源，或考慮固定到特定 commit（如 github:temidayoxyz/deep-browser#<sha>）。
典型用法¶
在本地開發或調試插件時，先拉取源碼並構建：
pnpm install
pnpm build
在 Harness 倉庫中運行調試命令：
pnpm dsh web --patch D:/Codebase/deep-browser/overlay.yml --no-open
打開打印出的 URL，展開右側邊欄，選擇 Browser 標籤頁。在 DSH 的 Plugins 標籤頁下，你可以配置默認頁面寬度（Fit / 390 / 768）以及是否默認在側邊欄打開鏈接。
適用場景與限制¶
- 適用場景：需要將網頁內容與對話上下文緊密關聯的開發或使用場景。
- 重要限制：插件僅利用當前 Web profile 的能力，不模擬 Chromium 的高級特性，如縮放、Cookies 管理、緩存、高亮註釋、顏色模式偏好或 Agent 驅動。這些功能需要 Desktop 級別的瀏覽器上下文。此外，工作區文件內容顯示在 Document Preview 面板，該插件僅用於處理實時 URL。
插件旨在提供輕量級的側邊欄瀏覽體驗，適合需要快速對照網頁與對話內容的開發者。更多詳情與源碼，請訪問 GitHub 倉庫。
