桌面截图 Eva7788519/dsh-screenshot-tool

dsh-screenshot-tool

在 Windows 上为 DeepSeek Harness 提供截图功能。两个入口共用同一条截图路径：

- screenshot 工具 —— 模型调用它，拿到 PNG 的绝对路径、像素尺寸和字节大小，再用 read_image 读回图片。
- 相机按钮 —— 输入框工具行里的一个控件，紧挨着附件按钮。它截取桌面，弹出预览面板，提供下载、复制到剪贴板和关闭。

两者都走 Harness Web 服务器上的 GET /screenshot 路由，由该路由流式返回 PNG 字节；工具还会额外把文件写入会话工作目录。

环境要求

- Windows（通过 PowerShell 调用 System.Windows.Forms + System.Drawing）。
- PowerShell：优先用 pwsh 7，回退到 powershell.exe。查找顺序是先看 PATH 上的 pwsh，再看 C:\Program Files\PowerShell\7\pwsh.exe，最后用 Windows PowerShell。

安装

从插件市场安装，或者：

dsh plugin --profile <profile> add dsh-screenshot-tool

安装后重启一次 Harness，让客户端模块表重新扫描；相机按钮会在下次启动时出现。

用法

让模型截图，或者直接调用工具：

{ "path": "evidence/login-page.png" }

path 可选。相对路径按会话工作目录解析；默认写到该目录下的 screenshots/shot-<timestamp>.png。

相机按钮点下即截图，除非你按 Download，否则不会写入磁盘。

涉及哪些操作

- 通过 GDI 截取整个虚拟桌面（所有显示器）。
- 每次截图启动一个 PowerShell 进程；脚本内联传入，输出路径通过 DSH_SHOT_PATH 环境变量传入。
- 工具把 PNG 写到你指定的路径；按钮把图片留在内存里，直到下载。

限制

- 仅支持 Windows。
- 截取的是屏幕上的内容，被遮挡的窗口看不到。
- 大尺寸截图会被 read_image 缩小，小字可能看不清。