QQ 截图取图 Silentforfar/dsh-qq-screenshot

QQ 截图（DSH 插件）

QQ Screenshot — 用 QQ 自带的截图工具截取屏幕区域，把 PNG 交给模型——入口有三个：输入框按钮、/screenshot 命令、qq_screenshot 工具。

DSH 插件包（DeepSeek Harness 插件）。

从 DSH 插件市场安装

1. 打开 DSH Web 侧边栏的 Plugins，在 Experimental plugins 旁边选 More，打开 Custom plugin markets。
2. 打开 Discover 标签页，添加这个索引源：

https://silentforfar.github.io/dsh-market-index/index.json

3. 在列表里找到 QQ Screenshot（@silentforfar/dsh-qq-screenshot），点安装。

直接从本仓库安装

把下面这串 spec 传给 plugin_manager 的 install_bundle（或者你配置档里对应的插件包安装入口）：

git+https://github.com/Silentforfar/dsh-qq-screenshot.git#<commit-sha>

请用本仓库历史里完整的 40 位 commit SHA，这样安装会锁定版本，可复现。

环境要求。 Windows、DSH 0.2.1-rc.2 或更新版本，以及正在运行且已登录的 QQ NT。QQ 的截图快捷键默认是 Ctrl+Alt+A，可以在 %USERPROFILE%\.dsh\qq-screenshot.json 里改。

许可证。 MIT。本 README 其余部分用中文介绍这个插件。

用 QQ 自带的截图工具截屏，把图片交给 DSH 里的模型。

- 模型工具 qq_screenshot：模型可以主动调用；调用后 QQ 截图界面弹出，框选区域并按 Enter，图片保存到工作区并随结果返回（模型支持图片输入时）。
- 输入框按钮：消息输入框左下角（权限下拉框右侧）的取景框图标，点一下就会唤起 QQ 截图；完成后会把图片路径写进输入框。
- 命令 /screenshot：与按钮同一套逻辑，可以在输入框直接输入。

截图保存在当前会话工作区的 screenshots/ 目录，文件名形如 qq-20261018-170519.png。

依赖

- Windows
- QQ NT 正在运行且已登录（截图快捷键默认 Ctrl+Alt+A）
- 完成后按 Enter，QQ 会把截图复制到剪贴板，插件从剪贴板取图

工作原理

1. 宿主插件用 capture.ps1 通过 SendInput 触发 QQ 的截图快捷键；
2. 轮询检测 QQ 的截图窗口（窗口类 QQScreenCapture Window Class）；
3. 等用户框选完成、QQ 把位图写入剪贴板后，把剪贴板图片保存为 PNG；
4. 工具路径再通过 attachments 服务把 PNG 作为图片附件返回给模型。

如果 QQ 的截图快捷键不是 Ctrl+Alt+A，新建 %USERPROFILE%\.dsh\qq-screenshot.json（每次截图都会重新读取，改完立即生效）：

{
"hotkey": "Ctrl+Alt+A",
"timeoutSec": 100
}

常见问题

- 提示“QQ 的截图窗口没有打开”：确认 QQ 在运行并已登录；确认快捷键与配置一致。
- 提示“截图已在 QQ 中被取消”：在 QQ 截图界面里按 Enter（复制到剪贴板）而不是点关闭；也可以先点“完成”按钮。
- 模型看不到图：当前模型不支持图片输入时，工具只返回文件路径，可以用 read_image 查看该文件，或换一个支持图片输入的模型。