前言¶
在 DeepSeek Harness(DSH)里向模型说明界面问题时,常见流程是:系统截图、保存文件、用其它工具画框箭头、再上传附件。步骤多,且截图与标注两次落盘。社区插件 dsh-screenshot(维护者 sfunction-guo)把流程收成「点按钮 → 拖框 → 标注 → 完成」,成品 PNG 直接进入 DSH 输入框附件区,或仅保存到本地。插件分类为客户端,仅支持 Windows(WinForms)。DSH 生态主张「一切皆插件」;SkillHub 目录页 为社区站点,与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-screenshot 是在 DSH 对话输入框左侧增加「取景框」按钮的工具:冻结桌面 → 拖选区域 → 就地标注 → 一键写入输入框(或只导出 PNG)。README 写明当前工具版本为 0.1.0,npm 包 @sfunction/dsh-screenshot 在 package.json 中为 0.1.1。处理全程在本机完成,不经过远程服务器。
核心功能¶
截图选区¶
点击输入框左侧取景框按钮后,整个桌面被冻结并压暗。按住左键拖出范围,框内实时变亮、框外保持压暗,角落显示像素尺寸;松手确认,Esc 取消。
标注工具¶
工具条分两排:主排为工具与动作,部分工具在下方展开第二排参数。
| 工具 | 第二排参数 | 说明 |
|---|---|---|
| 标注 | 矩形 / 椭圆 / 直线 / 箭头 | 拖出形状 |
| 画笔 | 细 / 中 / 粗 + 橡皮擦 | 手绘曲线;橡皮按当前粗细擦除 |
| 文字 | 小 / 中 / 大 + 编号 | 点击输入文字;编号拖放生成 ①②③ |
| 马赛克 | — | 拖出范围模糊,用于遮挡敏感内容 |
颜色共 6 种:红、蓝、绿、黄、黑、白。文字与编号可选中后移动、缩放字号;双击改内容,Delete 删除。
输出方式¶
- ✓ 完成:PNG 进入输入框附件区,可继续输入文字一并发送。
- 保存:选择路径存 PNG,只落盘、不进输入框;保存后会话结束,不会再插入输入框。
- × 取消:丢弃本次截图。
脚本化调用时,shot.exe 退出码含义见 README:0 完成并适合粘贴进输入框,2 用户取消,3 写文件失败,4 仅保存到磁盘。
安装与启用¶
系统要求¶
- Windows 10 / 11
- .NET Framework 4.x(系统自带)
package.json 中声明 DSH 引擎范围:dsh 为 >=0.2.0-rc.2 <0.3.0-0,且 os 为 win32。
安装方式¶
方式一(推荐):DSH 设置 → 插件 → 发现 中搜索 dsh-screenshot,或从插件市场安装(以市场收录情况为准)。
方式二:npm
该包为 DSH bundle,通过 package.json 里的 dsh.bundle.patch(即 cordis.patch.yml)装载补丁。安装命令如下:
npm install @sfunction/dsh-screenshot
方式三(开发):将仓库目录放入 DSH profile,由插件管理器作为 bundle 安装;shot.exe 缺失时会用 select.cs 现场编译。
安装前建议阅读 GitHub 源码 与 MIT 许可证。插件以当前 DSH 进程权限运行,安装前应自行核对源码与许可条款。
典型用法¶
按 README 给出的操作顺序:
1. 在输入框左侧点「取景框」图标
2. 全屏变暗后,按住左键拖出要截的范围
3. 松手,工具条出现在选框下方
4. 选工具、选颜色,直接在图上画
5. 点 ✓ 完成(进输入框)或「保存」(只存文件)
常用快捷键:
| 键 | 作用 |
|---|---|
Esc |
先取消选中标注;无选中时清空标注回到框选;再按则退出截图 |
Enter |
完成并插入输入框 |
Delete |
删除当前选中的文字/编号 |
撤销需用工具条「撤销」按钮(未绑定 Ctrl+Z)。
示例一:拖选约 1200×700 界面,红框标按钮、红箭头指向,加文字「这里点不动」→ 附件区出现同尺寸 PNG,标注已烘焙进图。
示例二:截聊天记录,对昵称、手机号各拖马赛克 → 对应区域模糊,其余内容不变。
示例三:标注后点「保存」并选路径如 %USERPROFILE%\shots\bug.png → 文件写入磁盘,输入框保持无新附件。
示例四:画完两个红框后点 ✓,再在输入框输入「这两个字段顺序反了」→ 一条带图与文字的消息。
适用场景与注意¶
适合需要在 DSH 对话里快速贴图、标清问题点或打码敏感信息的 Windows 用户。README 列出的边界值得注意:
- 马赛克只模糊底层截图,不会盖住已画标注;橡皮擦会恢复光标下一切标注为原截图,不限于画笔笔画。
- 「重选」会清空标注回到重新拖框;保存后不会再把图塞进输入框。
- DPI 仅在 100% 缩放下验证;更高缩放未实测。
- 鼠标层交互(按钮、双击编辑等)无自动化测试,模型层有 23 项断言自检。