dsh-screenshot
DiscoveredWindows screenshot tools + ui-visual-check skill for DeepSeek Harness
dsh-screenshot
A Windows screenshot plugin for DeepSeek Harness: two model-facing tools (screenshot, list_windows) plus a runtime skill (ui-visual-check) that let an agent actually see windows, pages, and before/after UI changes.
Why a plugin and a skill
Capturing the screen is a capability: it needs structured arguments, stable return values, and the image handed back to the model — so it is a tool. Deciding when to capture, which window, and how to compare before/after is a procedure — so it is a skill. The skill is registered through ctx.skills.register(), so it ships and unloads with the plugin.
Repository layout
plugin/dsh-screenshot/ # the plugin (@local/dsh-screenshot)
├─ index.js # tool registration, argument validation, backend discovery, image return
├─ cordis.patch.yml # deployment config (row config is the contract)
├─ scripts/capture.py # Win32 capture (DWM bounds + on-screen rectangle crop + Pillow)
├─ skill/SKILL.md # ui-visual-check: capture, change, capture again
└─ test/ # unit tests + real-capture integration tests
bin/obscura/ # Obscura binaries (not in git, see below)
Getting started
git clone https://github.com/fredgeoO/dsh-screenshot C:\dev\dsh-screenshot
# edit %DSH_PROFILE_DIR%\package.json:
# dependencies: add "@local/dsh-screenshot": "link:C:/dev/dsh-screenshot/plugin/dsh-screenshot"
# dsh.profile.bundles: add "@local/dsh-screenshot"
$rt = "$env:DSH_HOME\dsh-runtimes\dsh-primary-runtime\dependencies"
Push-Location $env:DSH_PROFILE_DIR
& "$rt\node\bin\node.exe" "$rt\pnpm\bin\pnpm.cjs" install
Pop-Location
Then unpack Obscura into bin/obscura/ — the URL backend, about 30 MB of RAM; without it URL capture falls back to Chrome/Edge. Restart DSH and verify in a new session that screenshot, list_windows, and ui-visual-check are present.
Handing the installation to another agent? Point it at INSTALL.md (agent-oriented: self-check script, per-step checkpoints, failure table; 中文译本).
Usage
screenshot({ target: "active" })
screenshot({ target: "window", window: "DeepSeek Harness", activate: true })
screenshot({ target: "screen" })
screenshot({ target: "url", url: "http://127.0.0.1:62714", width: 1440, height: 900 })
screenshot({ target: "active", region: { x: 0, y: 0, width: 800, height: 600 } })
list_windows({})
Window captures are cropped from the on-screen rectangle (PrintWindow returns black for Electron/Chromium), so the target window must be visible. A black frame is reported as SCREENSHOT_BLACK, never as success.
Requirements
- Windows 10/11 and DSH Desktop (verified on
0.2.2-rc.3). - Python 3.12 + Pillow, as shipped with DSH (auto-discovered).
- Obscura, or Chrome/Edge for exact viewports.
- Node 24 and pnpm 11 from the DSH runtime — do not use a global toolchain.
Tests
node test/unit.test.mjs # no DSH needed
node test/capture.test.mjs # real capture; needs a desktop session
Do not use node --test: pipe restrictions in the sandbox produce EPERM.
Privacy
Captures include whatever is visible on screen — passwords, private messages, keys — and are sent to the model provider as ordinary image requests. Prefer window-level captures over full screen.
License
MIT © 2026 FredgeoO. The repository does not bundle Obscura binaries; they are fetched from upstream on demand (Apache-2.0, separate from this project).
Comments
Loading…
Similar plugins
by Altairpaca
Windows Computer Use for DeepSeek Harness (DSH): window-bound screenshot/OCR/click with verification loop, pure-OCR mode, pluggable vision models.
★ 3
↓ 113/wk
MIT
PowerShell
Sep 3, 2026
dsh plugin --profile web add dsh-computer-use-windowsby TangerineSplendor
Windows screenshot plugin for DeepSeek Harness: live desktop selection, annotations, global hotkey, and direct image insertion.
★ 0
MIT
JavaScript
Oct 24, 2026
dsh plugin --profile web add dsh-plugin-live-shotby HsgtLgt
面向模型的「截图」工具插件(DeepSeek Harness,Windows 宿主)。 注册一个 screenshot 工具,让会话里的 AI 能真正「看见」并展示你的屏幕。
★ 0
MIT
JavaScript
Oct 8, 2026
dsh plugin --profile web add dsh-plugin-screenshotby machine202502
Screen and window capture for DeepSeek Harness: monitors, regions, background windows, thumbnails in chat
★ 0
MIT
JavaScript
Nov 9, 2026
dsh plugin --profile web add dsh-screenshootby JackEngineer
One-click DSH screenshot: capture the DeepSeek Harness window (or the whole desktop) and drop the PNG straight into the composer draft
★ 0
MIT
JavaScript
Oct 17, 2026
dsh plugin --profile web add dsh-quick-screenshotby 12138hao
Screenshot directly into the chat composer for DeepSeek Harness — click the scissors, drag a region, the image lands in the input box.
★ 0
MIT
JavaScript
Nov 6, 2026
dsh plugin --profile web add dsh-snap