Tools & Capabilities

dsh-wsl-obscura

173787247/dsh-wsl-obscura · ★ 1

173787247

DeepSeek Harness tools: drive Obscura headless browser (fetch/status/MCP hint) from WSL.

An English summary is not available; the Chinese summary is shown.

License
MIT
Added
2026-10-30
Maintenance
active
Install kind
github
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-10-30T09:38:02.314Z
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add 'github:173787247/dsh-wsl-obscura#393cdbd2e0bff397687932504593d671e1a22d3c'

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

Table of contents
  1. Compatibility
  2. Why
  3. Prerequisites
  4. Install
  5. Config
  6. Tests
  7. License
  8. Where it sits

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.2.1-rc.5) — 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

  1. Build Obscura on Windows (cargo build --release -p obscura-cli --bins --features render,stealth).
  2. 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):
      <obscura-checkout>/target/release/obscura.exe

Install

Local clone (recommended while unpublished):

dsh plugin --profile web add /path/to/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: <obscura-checkout>/target/release/obscura.exe

Tests

npm test

License

MIT

Where it sits

Optional. Drives the Obscura headless browser. Not in install.sh.

flowchart LR
  agent["dsh agent"] --> tool["dsh-wsl-obscura"] --> browser["Obscura headless browser"]

Suite diagram and version snapshot: dsh-wsl-kit. This plugin is 0.1.0 (not in install.sh). Do not copy that matrix into this README.