前言¶
在 DeepSeek Harness(DSH)里和模型对话时,若要把屏幕上的界面、报错或文档片段交给模型,常见做法是先切到截图工具、保存或复制图片,再回到会话里粘贴或上传。步骤多,也容易打断当前会话节奏。dsh-screenshot 是在 DSH 会话输入区增加「相机」按钮的客户端插件:在 Windows 上点击后框选区域,截图会自动作为图片附件投递给当前模型,无需再手动点发送。下面介绍插件定位、能力与安装用法。
这是什么¶
dsh-screenshot 由维护者 luffy2507 发布,归类为客户端插件。一句话定位:给 DeepSeek Harness 的 composer 增加类似豆包的手动截图入口——点相机图标、拖拽框选、松开即把裁剪后的 PNG 作为用户图片消息发给模型。仅支持 Windows。
- 目录页:https://www.skillhub.cn/plugins/luffy2507/dsh-screenshot
- 源码与说明:https://github.com/luffy2507/dsh-screenshot
- 许可证:MIT(README 与 package.json 一致)
- 当前 package 版本:0.1.0
核心功能¶
以下能力均来自项目 README,与实现文件 index.js、client.js、screenshot.ps1 描述一致。
- 在输入框右侧通过
conversation.input.right插槽注入相机按钮。 - 点击后 DeepSeek 窗口会自动最小化,避免挡住待截区域;框选结束后自动恢复。
- 全屏暗色遮罩上拖拽框选,选区高亮;采用双缓冲绘制,拖动时减少闪白。
- 松开鼠标即裁剪并作为图片附件发送(无需再手动发送消息)。
- 按
Esc可取消本次截图。
主机侧流程概要:客户端同源 POST /screenshot/api/capture;主机执行 PowerShell 脚本完成最小化窗口、CopyFromScreen、遮罩框选、裁剪 PNG、恢复窗口;再通过 fileUploads.uploadStream 上传,经 sessionController.prompt 以 { type: "file", receiptId } 投递给模型。
安装与启用¶
插件已列入 awesome-dsh-plugin 生态列表;README 写明可在 DSH「插件市场」搜索 dsh-screenshot 安装,也可本地从 GitHub 添加。安装命令须与 README 原文一致:
dsh plugin --profile web add github:luffy2507/dsh-screenshot
系统与运行环境要求:
- Windows(依赖 PowerShell 5.1+ 自带的
System.Windows.Forms/System.Drawing)。 - DeepSeek Harness >=0.2.2-rc.1(见 package.json 中
dsh.engines)。 - Node >=20(见
package.json的engines)。
index.js 与 client.js 修改后需重启 DSH 生效;screenshot.ps1 由主机每次截图时读取,改脚本可不重启。
插件在当前 DSH 进程权限下运行,并会调用 PowerShell 抓屏与写文件。安装前建议浏览源码与 LICENSE,确认符合本机安全策略。
典型用法¶
README 中的操作顺序可直接复现:
- 打开任意会话。
- 点击输入框右侧的相机按钮。
- 在屏幕上拖动框选要截图的区域。
- 松开鼠标:截图自动作为图片发送给模型。
- 若不想发送,按
Esc取消。
模型能否理解截图内容,取决于你所选模型是否支持视觉输入;README 在「限制」中已说明这一点。
适用场景与注意¶
适合谁:主要在 Windows 上使用 DSH Web 配置(--profile web),希望把屏幕区域快速交给多模态模型、又不想离开会话界面的开发者。
不适合谁:Linux、macOS 无法使用(脚本依赖 WinForms)。
生态说明:DSH 奉行「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,不等同于官方应用商店。
结尾¶
dsh-screenshot 把「框选 → 附件 → 投递」收拢进输入框旁的相机按钮,适合 Windows 下在 Harness 里做界面说明、排错对照等场景。进一步了解可从目录页与 GitHub 查看 Demo 图与开发说明:
- https://www.skillhub.cn/plugins/luffy2507/dsh-screenshot
- https://github.com/luffy2507/dsh-screenshot