dsh-wsl-obscura
Kit install: see dsh-wsl-kit. This plugin is optional (headless engine) — not part of KIT_SET=daily. Fault tree: TROUBLESHOOTING.
DeepSeek Harness tools for Obscura — a Rust headless browser — from WSL:
| Tool | Purpose |
|---|
obscura_status | Resolve binary + --version |
obscura_fetch | obscura fetch with dump / eval / stealth |
obscura_mcp_hint | How to wire MCP / CDP (does not start a server) |
Not the same as dsh-wsl-browser (win_open_url opens the Windows default GUI browser).
中文 → README.zh.md
Compatibility
| Field | Value |
|---|
| Plugin | dsh-wsl-obscura 0.1.0 |
| Minimum dsh | ≥ 0.1.2 (web UI one-shot ?token= on Windows relay :3081) |
| Latest verified | See dsh-wsl-kit Compatibility (currently 0.1.5-rc.1) — single source of truth for the suite |
| Kit set | optional — not in default KIT_SET lists |
| Cloud Flash | Use model id deepseek-flash (V4.1 Flash) in ~/.dsh/settings.yaml / llm-deepseek — not configured by this plugin |
| Agent Teams | Upstream experimental; not required here |
Suite floor versions: kit check-plugin-versions.sh. Fault tree: TROUBLESHOOTING.md.
Why
Agent work that needs page text, JS eval, or stealth fetch should hit a headless engine. Obscura already builds on Windows (obscura.exe). This plugin runs it from WSL via interop (/mnt/c/.../obscura.exe).
For richer agent tools (navigate / click / screenshot as MCP tools), prefer Obscura MCP (obscura mcp) — use obscura_mcp_hint for the wiring.
Prerequisites
- Build Obscura on Windows (
cargo build --release -p obscura-cli --bins --features render,stealth).
- Point the plugin at the binary (any of):
config.binaryPath in cordis- env
OBSCURA_BIN / OBSCURA_PATH (WSL or C:\... path)
- default candidate (local scaffold):
/mnt/c/Users/rchua/Desktop/AIFullStackDevelopment/obscura/target/release/obscura.exe
Install
Local clone (recommended while unpublished):
dsh plugin --profile web add /mnt/c/Users/rchua/Desktop/AIFullStackDevelopment/dsh-wsl-obscura
When published:
dsh plugin --profile web add github:173787247/dsh-wsl-obscura
Restart dsh web after add (kit: scripts/restart-dsh-web.sh).
Config
- id: dsh-wsl-obscura
name: dsh-wsl-obscura
config:
timeoutMs: 60000
maxOutputChars: 32000
defaultStealth: true
binaryPath: /mnt/c/Users/rchua/Desktop/AIFullStackDevelopment/obscura/target/release/obscura.exe
Tests
npm test
License
MIT
