dsh-screenshot
对话框下面加一个「截图」按钮：点一下，DSH 窗口收起，你拖个框，选中的那块图直接落进输入框。
干什么用的
平时想让模型看屏幕上的东西，得自己开截图工具、截图、保存、再拖进输入框。这个插件把这段收成一次点击：
- 点「截图」→ DSH 窗口最小化，屏幕上别的东西露出来
- 整屏变暗，鼠标变十字，拖一个矩形（框边实时显示
宽 x 高） - 松手 → 只裁框住那块 → DSH 窗口弹回来 → 图片躺在输入框的附件条里
不想框？按住 Alt 再点，直接整屏。想反悔？右键或 Esc，什么都不放，也不报错。
要求
- Windows 10 / 11（抓屏走 PowerShell + GDI+，别的平台还没写）
- DSH 桌面版，
0.2.1及以上 - 系统自带的 Windows PowerShell 5.1 就够了，不用装 pwsh
安装
在 DSH 的「插件」页里添加本目录（本地目录安装）。或者由 Agent 调 plugin_manager 的 install_bundle，指向这个目录的绝对路径。
装完刷新页面；如果是从旧版更新，把 DSH 完全退出再打开，Host 半才会换成新代码。
用法细节
| 操作 | 结果 |
|---|---|
| 点「截图」 | 框选一块区域 |
Alt + 点 |
整屏 |
| 拖动 | 框选，实时显示尺寸 |
右键 / Esc |
取消 |
成品长边超过 1920 会自动缩一档，避免把几 MB 的原图塞给模型。框选出来的图会按原样保留（不缩），除非它本身就超了 1920。
实现
三个文件，各管一段：
| 文件 | 职责 |
|---|---|
client.js |
输入框下面那个按钮。取到图后调 conversation.createDrafts() + inputActions.addAttachments()，把 PNG 变成输入框里的待发附件 |
index.js |
Host 半。注册 POST /dsh-screenshot/capture，过一遍 ctx.connection.requestRejection() 的鉴权，再通过 Host 的 subprocess 服务串行跑 PowerShell，回 PNG 字节 |
capture.ps1 |
真正干活的：沿进程树找到 DSH 的窗口句柄 → 最小化 → 抓虚拟桌面 → 铺一层可选区的遮罩 → 裁切/缩放 → 存 PNG → 不管成败都恢复窗口 |
几个设计取舍：
- 先抓整屏再选，选完从那张原图上裁。所以成品里不会带上遮罩、边框、尺寸提示，也没有「截图时窗口还没最小化完」的时序问题。
- 选择器只编译一次。C# 现编译在冷机上要十几秒，所以编译产物缓存到
%TEMP%\dsh-screenshot\selector-v1.dll，之后每次调用稳定在 1.5 秒上下。 - 鉴权走 DSH 自己的那套。路由没有另开鉴权，直接用
connection.requestRejection()，所以只有带着本机浏览器会话 cookie 的页面能调，命令行curl过去是 401。 - 图片不落盘：Host 写到临时目录，客户端取走字节后立刻删。
- 起进程走 Host 的
subprocess服务，不直接引 Node 的进程模块：可执行文件由 provider 解析，stdio 和回收也归 provider，插件手里不留裸的进程能力。
已知限制
- 只有 Windows。
- 多显示器且各屏缩放比不同时，坐标可能有偏差（目前按系统 DPI 处理）。
- 框选期间是全屏模态的：想截某个应用里展开的菜单，得先用快捷键把菜单调出来再点截图。
- 没有全局快捷键，入口只有输入框下那个按钮。
验证状态
- 框选、裁切、窗口恢复：在本机真实桌面上用合成鼠标事件跑通过，产出的图就是框住的那块。
- 取消路径：脚本退出码 2 → 路由回 409 → 前端静默复位，不弹错误。
- 鉴权：不带浏览器 cookie 直接 POST 返回 401。
- 浏览器里真实点击这一下：没有浏览器自动化手段，靠手动验证。
English
A DSH plugin that sits under the message box. Click Shot, the DSH window minimizes, you drag a rectangle over the screen, and that crop lands in the composer as a draft image. Alt + click grabs the whole screen; right-click or Esc cancels.
- Windows 10 / 11 only (capture runs through PowerShell + GDI+).
- Needs DSH desktop
0.2.1or newer; the bundled Windows PowerShell 5.1 is enough. - Install from the DSH Plugins page by pointing it at this directory.
- The image never touches disk besides one temp file: it is served over a session-gated loopback route and the temp file is removed right after.
License
MIT
