前言¶
DeepSeek Harness（DSH）的插件化架构让功能扩展变得灵活。在 Windows 环境下开发或调试智能体时，经常需要获取特定应用程序的界面截图。直接使用系统截图工具往往效率较低，而标准的 dsh-wsl-shot 仅处理剪贴板中的图片。dsh-wsl-winshot 解决了这个场景下的需求，它允许你在 WSL 环境中，直接抓取 Windows 桌面上特定的窗口，并将结果保存为文件。
插件定位¶
这是一个 DeepSeek Harness 插件，属于 dsh-wsl-kit 的一部分。它允许你通过进程 ID（PID）或窗口句柄来精确指定抓取目标，并将截图输出到 WSL 文件系统。
核心功能¶
- 抓取特定窗口：将 Windows 桌面上的指定窗口捕获为图片文件。
- 两种定位方式：
- 通过进程 ID（PID）指定。
- 通过窗口句柄指定。
安装与启用¶
安装前请确保你的系统满足以下要求：
* 运行在 Windows 上的 WSL 环境。
* DeepSeek Harness 正在 WSL 中运行。
* PowerShell 位于标准路径（插件会自动查找它）。
使用官方提供的命令进行安装：
dsh plugin --profile web add github:173787247/dsh-wsl-winshot
使用示例¶
安装完成后，你可以在 DSH 的配置或执行脚本中调用以下命令。
- 抓取当前前台窗口：
win_shot_window
- 抓取指定进程的窗口（例如 PID 为 1234 的进程）：
win_shot_window pid=1234 name="build-output"
注意事项¶
- 文件 vs 剪贴板：如果你需要的是图片文件，使用此插件；如果图片已经在剪贴板中，请使用
dsh-wsl-shot。 - 最小化窗口：在测量窗口矩形时，插件会自动将最小化的窗口恢复，因为最小化的窗口会返回一个空的矩形。
- 环境依赖：插件依赖于 Node.js 环境（要求版本 >= 18），且需与 DSH 配套使用。
- 兼容性：插件版本为 0.1.0，最低要求 DSH 版本 ≥ 0.1.2。
结语¶
dsh-wsl-winshot 提供了一种在 WSL 环境下精确控制 Windows 界面截图的途径。对于需要将特定窗口快照保存为文件的开发调试场景，它是比剪贴板工具更直接的选择。更多细节可参考项目主页：https://github.com/173787247/dsh-wsl-winshot
