前言¶
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
