前言¶
在 DeepSeek Harness 里排查界面、贴报错或给模型看窗口状态时，常见做法是切到系统截图工具或第三方软件，再手动把图片拖回会话输入区。步骤多、还容易误触发送。下面介绍社区插件 dsh-screenshot（维护者 liu19666）：在 Windows 上为 DSH 提供剪刀入口，自动识别窗口/屏幕/任务栏，支持标注与马赛克，确认后把图片注入输入区且不自动发送。
这是什么¶
dsh-screenshot 是 DeepSeek Harness 的客户端类 Cordis 插件：Host 为 Node（lib/index.js），前端注入剪刀按钮（lib/client.js），截图覆盖层由原生 SnipTool.exe（C# / .NET Framework 4.8）实现。分类上属于客户端能力扩展；当前 README 标注版本 2.1.0，许可证 MIT，仅支持 Windows 10+，要求 DSH ≥0.2.0 与 Node ≥20。
核心功能¶
入口与 DSH 窗口行为¶
话筒按钮左侧新增剪刀图标，样式与话筒一致。左键进入截图时不隐藏 DSH；右键进入时最小化 DSH，退出或完成后恢复。悬停提示会说明两种用法；右键点击时阻止浏览器默认菜单。
选区：自动识别与手动框选¶
鼠标移动时会高亮候选区域：窗口、完整桌面、任务栏。高亮为蓝色边框、左上角白底尺寸标签（如 888×777），区域外暗化。单击确认识别区域；按住拖动可自由框选，松手即确认。选区外右键或 Esc 可退出截图模式。
v2.1 起已移除顶部「隐藏 DSH / 长截图」开关栏，界面内不再有第二个隐藏入口，也不再使用 settings.json 持久化配置。
统一编辑器¶
所有截图进入同一编辑器：矩形、椭圆、直线、箭头、画笔、文本（可调粗细与颜色）、马赛克。撤销标注用 Ctrl+Z。右侧三键：保存 PNG、红叉取消、绿勾确定。指针处可用 C 或 Ctrl+C 复制色号（#RRGGBB）。
结果如何进入会话¶
确定或回车后，图片通过合成 paste 事件写入 DSH 会话输入区；插件代码不会触发发送。这是与「截图后立刻发消息」流程的重要区别。
进程与隐私¶
页面加载不预热；点击剪刀才启动 %LOCALAPPDATA%\dsh-screenshot\<哈希> 下的 SnipTool.exe 副本（不占用 node_modules）。一次截图结束（确定/取消/右键退出）后进程额外保留约 30 秒；30 秒内再截可走管道唤醒。空闲超时后机器上无截图进程。实现为纯本地 GDI+，无网络请求、无遥测。语言与明暗主题跟随 DSH 偏好。
安装与启用¶
需要 Windows 10/11 与 DeepSeek Harness，无需管理员权限与额外运行库。官方 README 未提供 dsh plugin add github:... 一类命令，需在 profile 中 link 本地插件目录。
-
将仓库放到插件目录，例如
D:\dsh-home\plugins\dsh-screenshot。 -
编辑 DSH profile 的
package.json（路径形如<DSH_HOME>/profiles/<name>/package.json），加入 bundle 与本地链接：
{
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-screenshot"]
}
},
"dependencies": {
"dsh-screenshot": "link:D:/dsh-home/plugins/dsh-screenshot"
}
}
路径请按本机 DSH_HOME 与实际插件目录修改。
- 启动 DSH 后，语音输入话筒左侧应出现剪刀按钮。
典型用法¶
先做选区，再做标注，最后确认注入输入区。
| 操作 | 效果 |
|---|---|
| 左键点击剪刀 | 进入覆盖层，DSH 保持可见 |
| 右键点击剪刀 | 进入覆盖层并最小化 DSH |
| 单击 | 确认自动识别的窗口/屏幕/任务栏 |
| 拖拽 | 手动矩形框选 |
| 拖动控制点 | 调整选区 |
Ctrl+Z |
撤销上一笔标注 |
C / Ctrl+C |
复制指针处 #RRGGBB |
| 回车或 ✓ | 确定并注入输入区（不自动发送） |
Esc、右键、✕ |
取消并恢复 DSH |
Host 侧还提供 /shot/api/capture、/shot/api/last 等路由；/shot/api/probe 默认关闭，需 touch %TEMP%\dsh-shot-debug.on 后刷新页面，POST 该接口才会把前端诊断 JSON 写到 %TEMP%\dsh-shot-probe.json（调试用途）。
适用场景与注意¶
适合在 Windows 上使用 DSH、需要快速截窗口/全屏/任务栏并打码或标注后再贴进对话的场景。插件以当前 DSH 进程权限运行；安装前请自行查看源码与 MIT 许可证。非 Windows 平台不在 package.json 的 os 支持范围内。
DeepSeek Harness 生态强调「一切皆插件」；社区目录 skillhub.cn 上的 dsh-screenshot 页 为独立站点 listing，与 DeepSeek / 幻方无官方从属关系。
结尾¶
经过上面的步骤，你可以在 DSH 内完成识别、标注与注入输入区的一整条截图链路，而无需依赖外部截图再手动粘贴。详情与英文说明见仓库 README。
- 目录页：https://www.skillhub.cn/plugins/liu19666/dsh-screenshot
- GitHub：https://github.com/liu19666/dsh-screenshot
