Introduction

The plugin-based architecture of DeepSeek Harness (DSH) makes feature extension flexible. When developing or debugging agents in a Windows environment, you often need to capture screenshots of specific application windows. Using system screenshot tools directly can often be inefficient, and the standard dsh-wsl-shot only handles images in the clipboard. dsh-wsl-winshot addresses this use case. It allows you to capture a specific window on the Windows desktop from within WSL and save the result as a file.

Plugin Positioning

This is a DeepSeek Harness plugin and is part of dsh-wsl-kit. It allows you to precisely specify the capture target by process ID (PID) or window handle, and output the screenshot to the WSL file system.

Core Features

  • Capture a Specific Window: Captures the specified window on the Windows desktop into an image file.
  • Two Targeting Methods:
    • Specified by process ID (PID).
    • Specified by window handle.

Installation and Enabling

Before installation, make sure your system meets the following requirements:
* A WSL environment running on Windows.
* DeepSeek Harness running in WSL.
* PowerShell available at the standard path (the plugin will automatically locate it).

Use the official command to install it:

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

Usage Examples

After installation, you can invoke the following commands in DSH configuration or execution scripts.

  1. Capture the current foreground window:
    win_shot_window
  1. Capture the window of a specific process (for example, a process with PID 1234):
    win_shot_window pid=1234 name="build-output"

Notes

  • File vs Clipboard: If you need an image file, use this plugin. If the image is already in the clipboard, please use dsh-wsl-shot.
  • Minimized Windows: When measuring the window rectangle, the plugin automatically restores minimized windows, because minimized windows return an empty rectangle.
  • Environment Dependencies: The plugin depends on a Node.js environment (version >= 18 required) and must be used in conjunction with DSH.
  • Compatibility: The plugin version is 0.1.0, with a minimum DSH version requirement of ≥ 0.1.2.

Conclusion

dsh-wsl-winshot provides a way to precisely control Windows screenshot capture in a WSL environment. For development and debugging scenarios where you need to save a snapshot of a specific window as a file, it is a more direct choice than clipboard-based tools. For more details, refer to the project homepage: https://github.com/173787247/dsh-wsl-winshot