前言¶
在 DeepSeek Harness 的開發中,插件 @yeesy369/dsh-browser-playwright 提供了基於 Playwright 的瀏覽器控制能力,但其內置的 SSRF(服務器端請求僞造)保護機制會阻斷對本地或局域網地址的訪問。這給需要調試本地服務或訪問內網頁面的開發者帶來了不便。dsh-intranet-browser 旨在解決這個問題,它修改了原插件的邏輯,在保持安全性的前提下,允許 Harness 打開本地和局域網資源。
插件定位¶
這是一個基於 @yeesy369/dsh-browser-playwright 修改的插件,由維護者 Short-Arm-Ape 提供。它通過繞過原插件的 SSRF 保護邏輯,爲 DeepSeek Harness 啓動一個獨立的 Playwright 瀏覽器實例。該實例擁有獨立的服務名稱、配置文件目錄和窗口,專門用於內網和本地頁面的調試。
核心功能¶
- 繞過 SSRF 保護:移除了原插件
url-guard.ts中的嚴格限制,允許訪問 localhost 和 LAN 地址。 - 獨立實例運行:使用獨立的服務名稱
intranet-browser和默認配置文件~/.dsh/intranet-edge-profile,與原瀏覽器插件並行運行。 - 按調用審批:默認情況下,每次調用
intranet_*工具都會觸發用戶審批提示,確保操作可控。 - 雲元數據攔截:默認阻止雲元數據端點(如 169.254.169.254),防止意外泄露雲服務器信息。
- 工具支持:提供一系列用於頁面交互和管理的工具,包括打開、截圖、快照、點擊、輸入、滾動、歷史導航、多標籤頁管理、JS 代碼執行以及窗口關閉等。
安裝與啓用¶
安裝過程需要將插件添加到 web 配置文件中。請確保在終端中處於插件的絕對路徑下執行以下命令:
dsh plugin --profile web add [absolute path to this package]
安裝完成後,必須重啓 DeepSeek Harness 才能使插件生效。
典型用法¶
安裝並重啓後,AI 智能體可以通過調用工具與本地或內網頁面交互。
- 打開頁面:AI 調用
intranet_open打開一個內網地址。根據默認配置,系統會彈出審批提示,確認後才執行導航。 - 調試頁面:導航完成後,可以使用
intranet_snapshot獲取頁面的無障礙快照,或使用intranet_screenshot截取圖片進行視覺調試。
適用場景與注意事項¶
- 適用場景:主要用於智能體開發階段,調試運行在本地或局域網內的 Web 應用。
- 維護狀態:該倉庫已停止維護,併合並至
Short-Arm-Ape/dsh-browser-unified插件中。當前倉庫僅作爲只讀歸檔保留。 - 安全建議:由於插件涉及瀏覽器行爲的修改,安裝前建議檢查源碼和許可證(MIT)。
- 功能限制:
intranet_evaluate工具默認未註冊,只有在配置中啓用evaluate: true並重啓後纔會出現。
總結¶
dsh-intranet-browser 爲 DeepSeek Harness 提供了一個受控的方案,用於繞過 SSRF 限制以訪問內網資源。它通過獨立的實例和審批機制,在便利調試的同時保持了安全性。更多細節和源碼可參考插件目錄頁或 GitHub 倉庫。