前言¶

智能体开发中，当任务需要获取页面文本、执行 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 原生无头浏览器的空白。更多细节可查阅插件目录或源码仓库。