dsh-plugin-screenshot
截图工具：截取整个桌面或按标题截取窗口，PNG 存入会话工作区并以原生图像块返回（DeepSeek Harness · Windows）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:HsgtLgt/dsh-plugin-screenshot#2fcabc8a8a504325f5fd29435b0b7aff9dd2ca68
Plugin Screenshot 以 dsh-plugin-screenshot 发布，当前版本为 0.0.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
面向模型的「截图」工具插件 · DeepSeek Harness（Windows）
注册一个 screenshot 工具，让会话里的 AI 真正「看见」并展示你的屏幕——
不只是全屏，被遮挡、被最小化的窗口也能截。
DSH 为「电脑使用」预留了能力位，但桌面版没有自带本机截屏工具。 本插件把这个坑填上，并处理了真实世界里的棘手情况：
| 场景 | 普通 CopyFromScreen | 本插件 |
|---|---|---|
| 窗口在屏幕上可见 | ✅ | ✅ |
| 窗口被其他窗口完全遮挡 | ❌ 截到的是盖在上面的内容 | ✅ PrintWindow 让窗口自绘 |
| GPU 渲染应用遮挡后返回空白帧（RustDesk / Chrome / Electron…） | — | ✅ 采样检测 + 自动「临时前置」兜底，截完把前台切回去 |
| 窗口最小化 | ❌ | ✅ 自动还原 → 截图 → 缩回 |
| 缩到托盘（无渲染表面） | ❌ | ⚠️ 明确报错并提示先唤起一次 |
| 远程桌面窗口内容（RustDesk / ToDesk） | 看运气 | ✅ 实测可用 |
git clone https://github.com/HsgtLgt/dsh-plugin-screenshot.git
在 DSH 插件管理（plugin_manager）中执行 install_bundle，指向克隆目录：
file:<克隆目录>/dsh-plugin-screenshot
重启 DSH 应用即生效。对等依赖 @deepseek-ai/dsh-tools / @deepseek-ai/cordis
由运行时树提供，无需手动安装。
| 参数 | 类型 | 说明 |
|---|---|---|
target | screen | window | 截图目标，默认 screen（多显示器虚拟桌面） |
window_title | string | target=window 时的标题子串匹配（不区分大小写） |
output_path | string | 可选保存路径，相对会话工作区；默认 screenshots/screenshot-<时间戳>.png |
模型侧约定（写在工具描述里，自动生效）：
用户点名某个应用时必须用 window 模式；截图成功后必须用  内嵌展示。
被完全遮挡的窗口，一行调用直接拿到完整画面（此图即插件自身截取）：
模型调用 screenshot()
├─ ctx.fs.resolve() 相对路径 → 工作区绝对路径
├─ ctx.subprocess 启动 PowerShell
│ Get-Process 标题匹配 → HWND
│ 最小化 → ShowWindow 还原
│ PrintWindow(PW_RENDERFULLCONTENT) 自绘到位图
│ 采样 100 像素查空白 → 空白则临时前置 + CopyFromScreen
│ 写 PNG → "OK 宽x高 方法"
├─ ctx.fs.readBytes() 读回字节
└─ ctx.attachments.saveImage() 校验/降采样 → 持久对象库
↓
返回 路径信封 + 原生图像块（模型看见 + 用户可见）
无原生依赖：只调 Windows PowerShell 与 user32 / System.Drawing。 图片文件永久保留在会话工作区，展示副本由 DSH 附件库按内容寻址去重存储。
MIT © HsgtLgt
