前言¶

智能體開發中，當任務需要獲取頁面文本、執行 JS 評估或進行隱蔽抓取時，GUI 瀏覽器無法滿足需求。Obscura 是一個基於 Rust 的無頭瀏覽器，通常已在 Windows 上編譯完成。本插件旨在通過 WSL 的互操作性，讓 DeepSeek Harness (DSH) 能夠從 Linux 環境直接驅動 Obscura 瀏覽器。

是什麼¶

dsh-wsl-obscura 是一個可選插件（不屬於 KIT_SET=daily），由用戶 173787247 維護。它爲 DeepSeek Harness 提供了三個核心工具，用於控制 Obscura 瀏覽器，解決 WSL 環境下無法直接調用 Windows 編譯的二進制工具的問題。

核心功能¶

該插件提供以下三個工具：

• obscura_status：解析 Obscura 二進制文件路徑並執行 --version 檢查。
• obscura_fetch：執行 obscura fetch 命令，支持 dump、eval 和 stealth 選項。
• obscura_mcp_hint：提供如何連接 MCP（Model Context Protocol）或 CDP（Chrome DevTools Protocol）的指引，該工具本身不啓動服務器。

安裝與啓用¶

執行以下命令安裝插件：

dsh plugin --profile web add github:173787247/dsh-wsl-obscura

安裝完成後，建議重啓 dsh web 進程以使插件生效：

# 在 dsh-wsl-kit 中提供的腳本
scripts/restart-dsh-web.sh

配置與先決條件¶

在使用本插件前，需滿足以下條件：

1. Obscura 構建：需在 Windows 環境下構建 Obscura，命令爲 cargo build --release -p obscura-cli --bins --features render,stealth。
2. dsh 版本：DeepSeek Harness 版本需滿足 >= 0.1.2。

3. 路徑指向：插件需要知道 obscura.exe 的位置。可以通過以下方式配置：

   • 在 cordis 配置中設置 config.binaryPath。
   • 設置環境變量 OBSCURA_BIN 或 OBSCURA_PATH（支持 WSL 路徑或 Windows 路徑）。
   • 使用默認候選路徑：/mnt/c/Users/rchua/Desktop/AIFullStackDevelopment/obscura/target/release/obscura.exe。

典型用法¶

1. 確認環境：運行 obscura_status，檢查二進制文件是否被正確解析及版本信息。
2. 執行抓取：根據需求，運行 obscura_fetch。例如，使用 dump 獲取頁面文本，或使用 stealth 進行隱蔽抓取。
3. 連接協議：如需通過 MCP 或 CDP 進行更復雜的交互，參考 obscura_mcp_hint 的輸出進行連接配置。

適用場景與注意¶

• 場景：適合需要在 WSL 環境下對 Windows 編譯的 Obscura 瀏覽器進行無頭控制的智能體任務。
• 注意：
  • 本插件不是 dsh-wsl-browser，後者用於打開 Windows 默認 GUI 瀏覽器。
  • 插件以當前 dsh 進程的權限運行，需確保配置的路徑可訪問。
  • 使用前建議閱讀源碼並檢查許可證（MIT）。

結尾¶

該插件填補了 DeepSeek Harness 在 WSL 環境下使用 Windows 原生無頭瀏覽器的空白。更多細節可查閱插件目錄或源碼倉庫。