前言¶

用 DeepSeek Harness（DSH）问「屏幕上这块是什么意思」时，常见流程是：系统截图工具截一张图、在磁盘里找到文件、拖进对话输入框、再打字。步骤多，还要绕一圈文件系统。DSH 社区里插件可以扩展 Web 对话客户端的能力；dsh-screenshot 把上述流程收成 composer 工具栏里的一次点击，截下来的区域直接变成草稿里的图片附件，和普通粘贴图片一样发给支持多模态的模型。

下面介绍插件定位、能力、安装方式与使用步骤。事实以 GitHub 仓库 README 为准；社区目录页见 SkillHub。目录站与 DeepSeek / 幻方无官方从属关系，属于社区生态。

这是什么¶

dsh-screenshot 是面向 DeepSeek Harness 的 screenshot-and-ask 插件：在 composer 工具行点相机按钮即可截屏，冻结画面上用可拖动的选框微调区域，确认后裁剪结果进入当前消息草稿，作为普通图片附件。

维护者为 yuyu297，分类为 客户端（Web GUI 侧注入按钮与选区 overlay）。与多数系统截图工具不同，冻结帧会 排除 Harness 自身窗口（截屏前最小化本应用顶层窗口，截完恢复），方便对准窗口后面的内容提问。

核心功能¶

以下能力均来自官方 README 与 package.json（当前版本 1.2.0，许可证 MIT）。

• 一键、无系统对话框：相机按钮挂在 composer 工具行左侧（槽位 conversation.input.left）。
• 可调选区：首次拖拽画出区域后，选框保留；四角、四边共八个控制点，以及可拖动的内部区域，确认前不会真正裁剪。
• 确认与取消：Enter 或确认按钮完成；Esc、右键或取消按钮丢弃整次捕获。
• 尺寸读数：显示真实像素尺寸，而非屏幕逻辑像素。
• Harness 窗口不参与画面：应用自有窗口在冻结前最小化，恢复后选框内主要是其他应用内容。
• 无落盘习惯：裁剪结果经 Host 侧处理后进浏览器草稿附件，不依赖用户自建的截图目录；overlay 是页内表面，README 说明不会留下托盘项、悬浮窗或待清理文件。
• 性能：常驻 PowerShell 辅助进程、窗口列表缓存等优化后，README 在 2560×1600、150% DPI 桌面上的整次捕获约 130–180 ms（首次实现约 520–600 ms）；选区 overlay 用单元素 box-shadow 与按动画帧合并指针移动等方式减少 DOM 刷新。

架构上分为两半：Host（index.js + scripts/capture.ps1）提供 /api/dsh-screenshot/capture 与 /api/dsh-screenshot/crop，需应用 auth cookie；Client（client.js）注册相机按钮与 shell.overlay 选区层。中间帧最多保留六张，由一次 crop 消费并删除，避免大图在浏览器里往返。

无配置项：插件不注册 Config schema，也不读取工作区外配置文件。

环境与要求¶

1. Windows：捕获辅助脚本使用 PowerShell 5.1、WinForms 与 GDI+。
2. DSH Web GUI：dsh web 或桌面应用；需要 webServer Host 服务与 Conversation Client 服务（标准 web profile 具备）。
3. Node：package.json 要求 node >= 22。
4. 若希望模型理解截图，需选用 接受图片输入 的模型。

安装与启用¶

安装命令以 README 原文为准（将 <profile> 换成你的 profile 名；GitHub 路径按 README 占位写法，指向你要安装的 fork 或上游仓库）：

dsh plugin --profile <profile> add github:<your-account>/dsh-screenshot

安装后 重启 DSH，以便 Host 注册路由并启动捕获辅助进程。

本地开发可直接指向目录：

dsh plugin --profile <profile> add ./dsh-screenshot

插件以当前 DSH 进程权限运行，安装前建议自行查看 源码 与 LICENSE，确认行为与许可可接受。

典型用法¶

README 给出的可复现步骤如下：

1. 在 composer 工具行左侧点击相机按钮。
2. 屏幕冻结后，拖拽画出要提问的区域。
3. 松开后选框保留，可拖边、角或内部微调。
4. 按 Enter 或点 Confirm 确认；Esc、右键或 Cancel 放弃。
5. 裁剪图出现在草稿附件中，输入问题并发送。

适用场景与注意¶

适合：在 Windows 上用 DSH Web 对话、经常需要「指着屏幕某块问模型」的开发者或智能体使用者；希望少碰文件系统、少步骤完成 multimodal 提问的场景。

注意：

• 仅支持 Windows，Linux / macOS 不在 README 要求范围内。
• Host 路由带应用 auth cookie 校验，避免本机无关页面随意读屏；仍应理解插件会调用系统级截屏能力。
• README「Notes and limits」提到与窗口、DPI 等相关的边界（正文截断处未展开）；遇异常可对照 GitHub Issues 与完整 README。
• 社区目录当前星标为 0，不代表功能缺失，仅反映仓库曝光度；版本与行为以仓库 tag / package.json 为准。

结尾¶

dsh-screenshot 把「截屏 → 找文件 → 拖附件 → 提问」收成 composer 里的一键流程，并在捕获时隐藏 Harness 自身窗口，适合在 DSH「一切皆插件」的 Web 客户端里做屏幕问答。

• 社区目录：https://www.skillhub.cn/plugins/yuyu297/dsh-screenshot
• 源码与详细实现、性能表：https://github.com/yuyu297/dsh-screenshot