前言¶
在 DeepSeek Harness (DSH) 的 Web 模式下调试智能体或演示功能时,直接向模型展示界面内容常需要截图。传统方式需借助系统截图工具,再手动上传到对话框,流程较为繁琐。dsh-screenshot 插件为 DSH composer 提供了类似微信 PC 客户端的截图体验,将截图、裁剪和附件发送集成在一个流程中。
插件介绍¶
这是一个为 DeepSeek Harness Web 对话框设计的截图插件,由开发者 XEsx630 维护。它通过在 composer 工具栏新增按钮,允许用户截取屏幕区域或隐藏窗口后截图,并将处理好的图片直接插入对话,无需离开 DSH 界面。
核心功能¶
- 工具栏集成:在 composer 工具栏新增「截图」按钮。
- 双模式截图:支持「截取屏幕任意区域」(全屏遮罩拖拽)和「隐藏当前窗口后截图」两种模式。
- 服务端处理:由服务端 PowerShell 负责裁剪图片,不依赖浏览器 canvas,规避了解码时序问题。
- 自动注入路径:发送消息时自动注入包含图片绝对路径的文本,供模型读取。
- MCP 兼容:支持通过 MCP 工具(vision)读取图片内容。
安装与启用¶
使用官方安装命令添加插件。安装后 dsh.bundle manifest 会自动将 dsh-screenshot 行挂载到 profile 中,重启 dsh web 并刷新浏览器即可使用。
dsh plugin --profile web add github:XEsx630/dsh-screenshot
典型用法¶
- 在 DSH composer 工具栏点击「截图」按钮。
- 选择「截取屏幕任意区域」或「隐藏当前窗口后截图」。
- 拖拽鼠标框选截图区域,确认后图片卡会出现在输入框上方。
- 输入文字并点击发送。模型会收到包含图片绝对路径的文本,并据此调用 vision MCP 读取图片内容。
依赖与限制¶
- 环境依赖:依赖 Windows 环境,需 PowerShell 5.1 以及 System.Windows.Forms/System.Drawing 库。
- DSH 版本:依赖 DSH 0.1.x web profile。
- 网络与安全:所有路由仅限 loopback + same-origin。截图/裁剪脚本仅在本机执行,不上传任何数据,图片内容仅进入
$DSH_HOME/uploads目录。
总结¶
该插件通过本地 PowerShell 完成图像处理,确保了截图功能的稳定性,适合需要在本地环境进行调试或演示的场景。更多详情可访问 GitHub 仓库。