DeepSeek Harness 插件:dsh-intranet-browser

前言

在 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 智能體可以通過調用工具與本地或內網頁面交互。

  1. 打開頁面:AI 調用 intranet_open 打開一個內網地址。根據默認配置,系統會彈出審批提示,確認後才執行導航。
  2. 調試頁面:導航完成後,可以使用 intranet_snapshot 獲取頁面的無障礙快照,或使用 intranet_screenshot 截取圖片進行視覺調試。

適用場景與注意事項

  • 適用場景:主要用於智能體開發階段,調試運行在本地或局域網內的 Web 應用。
  • 維護狀態:該倉庫已停止維護,併合並至 Short-Arm-Ape/dsh-browser-unified 插件中。當前倉庫僅作爲只讀歸檔保留。
  • 安全建議:由於插件涉及瀏覽器行爲的修改,安裝前建議檢查源碼和許可證(MIT)。
  • 功能限制:intranet_evaluate 工具默認未註冊,只有在配置中啓用 evaluate: true 並重啓後纔會出現。

總結

dsh-intranet-browser 爲 DeepSeek Harness 提供了一個受控的方案,用於繞過 SSRF 限制以訪問內網資源。它通過獨立的實例和審批機制,在便利調試的同時保持了安全性。更多細節和源碼可參考插件目錄頁或 GitHub 倉庫。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜