前言¶
在 DeepSeek Harness 里和模型来回沟通时，经常需要把屏幕上的内容（报错窗口、文档截图、设计稿）快速贴进对话。系统自带的截图工具要么步骤多，要么截完还要手动保存、打开、粘贴。dsh-qq-screenshot 的作用就是把 QQ / 微信那种「按快捷键 → 框选 → 标注 → 回车即贴」的体验做进 DSH Web UI。
这是什么¶
dsh-qq-screenshot 是社区开发者 Sky33635 维护的 DSH 插件，版本 1.2.0，MIT 许可证，归类为「客户端」。它给 DeepSeek Harness Desktop 的 Web UI 提供桌面截图能力：按下 Ctrl+Alt+A 后可在整块桌面上框选区域，加上矩形、椭圆、箭头等标注，再一键复制进剪贴板，直接在对话输入框 Ctrl+V 粘贴。
要注意一点：它截的是整个桌面，不是只截 Harness 窗口，浏览器和别的软件的画面同样能截。
核心功能¶
Ctrl+Alt+A全局唤起，输入框有焦点时也能用；输入框左侧还有截图图标。- 框选后有 8 个控制点可缩放、拖动内部可移动、方向键 1px 微调（
Shift为 10px），角标实时显示物理像素尺寸。 - 六种标注：矩形、椭圆、箭头、画笔、文字、马赛克，配 5 种颜色；超出选区的笔画自动裁掉。
Enter、双击 ✓ 或Ctrl+C复制到剪贴板，回输入框Ctrl+V粘贴；也可Ctrl+S另存为 PNG。Ctrl+Z撤销上一步标注，Esc、右键或 ✕ 退出截图。- 截图瞬间隐藏 Harness 窗口（仅 Windows），避免画面里出现工具自己的窗口。
安装与启用¶
宿主要求：DeepSeek Harness Desktop 0.2.1-rc.4（已在该版本验证），Node ^22.19 || >=24。
方式一，插件市场：打开「插件市场」，搜索 dsh-qq-screenshot，安装。
方式二，DSH CLI（对应 npm 包）：
dsh plugin --profile desktop add dsh-qq-screenshot
方式三，直接从 GitHub 安装：
dsh plugin --profile desktop add github:Sky33635/dsh-qq-screenshot
方式四，手动在 profile 的 package.json 里加依赖，并在 dsh.profile.bundles 中选中：
{
"dsh": { "profile": { "bundles": ["dsh-qq-screenshot"] } },
"dependencies": { "dsh-qq-screenshot": "^1.2.0" }
}
安装或升级后要刷新页面（或重启 DSH）一次：插件带客户端半边，页面启动时才加载。
典型用法¶
1、按 Ctrl+Alt+A 开始截图，输入框有焦点时同样可用。
2、拖动鼠标框选区域，松手后出现工具栏。
3、用矩形、椭圆、箭头、画笔、文字、马赛克等工具标注，点颜色圆点换颜色。
4、按 Enter 复制到剪贴板，回到输入框 Ctrl+V 粘贴图片；或按 Ctrl+S 另存 PNG。
实现方式¶
浏览器本身没有权限抓桌面，插件因此拆成两半：
- Host 半边（
index.js）在http://127.0.0.1:<port>/plugins/dsh-qq-screenshot/capture.png注册一个仅本机可访问的 HTTP 路由，再用系统工具抓一次全屏：Windows 用powershell.exe+System.Drawing.CopyFromScreen，macOS 用screencapture -x -t png，Linux 依次尝试gnome-screenshot/spectacle/grim/import。 - 浏览器半边（
client.js）在shell.overlay里冻结这一帧，框选、标注，最后用 Canvas 按原始分辨率合成 PNG 写进剪贴板。
Windows 上的「截图时隐藏当前窗口」默认开启：页面先铺一层深色遮罩，Host 用 Win32 ShowWindow(SW_HIDE) 把窗口藏起来、等桌面重绘，再 CopyFromScreen 抓屏，抓完立刻把窗口还回来。它从 PowerShell 进程往上遍历父进程（最多 8 层），从近到远逐层找面积最大的可见顶层窗口，同时排除 Progman / WorkerW / Shell_TrayWnd / Shell_SecondaryTrayWnd，避免误认桌面或任务栏。藏失败时页面会撤掉遮罩、重抓一次不藏窗口的图，并在底部常驻红色提示。该开关仅 Windows 生效。
适用场景与注意¶
适合需要在 DSH 对话里频繁贴桌面截图、并想保留 QQ 式标注习惯的人。插件以当前 dsh 进程的权限运行，Host 半边会调用系统截屏工具（Windows 上是 PowerShell），除此之外不访问网络、不写其他文件；安装前建议先核对源码和 MIT 许可证。
已知限制：
- 抓屏依赖本机桌面会话，跑在无桌面的服务器上会报「截屏失败」。
- 剪贴板写图片需要页面处于聚焦状态；被拒绝时可改用「保存为 PNG」。
- 快捷键固定
Ctrl+Alt+A，如与其他软件冲突，可改client.js里的onKeyDown。
小结¶
dsh-qq-screenshot 把 QQ 式截图的完整链路搬进了 DSH Web UI，省去「系统截图 → 保存 → 打开 → 粘贴」的中间步骤。它由 Sky33635 维护，MIT 许可，可在插件市场或 DSH CLI 安装。
目录页：https://www.skillhub.cn/plugins/Sky33635/dsh-qq-screenshot
GitHub：https://github.com/Sky33635/dsh-qq-screenshot
