dsh-screenshot

DSH 内置截图工具 v2

给 DeepSeek Harness 的原生截图工具 v2：窗口/屏幕/任务栏自动识别高亮、手动框选、图形/画笔/文本标注、马赛克、取色，确认后图片填入 DSH 输入区（不自动发送）。入口左键＝保留 DSH 窗口、右键＝最小化 DSH 窗口。

English | 中文

*注：示意图为 v2.1 实际界面——鼠标悬停的候选选区（稍粗蓝色边框 + 左上角尺寸标签）、区域外暗化，以及底部的纯图标工具栏。*

特性 (R1–R30)

特性 · 说明 入口剪刀按钮（左键/右键） · 话筒按钮左侧新增剪刀图标，同容器紧邻话筒之前，尺寸/圆角/hover 风格一致；左键进入＝不隐藏 DSH，右键进入＝最小化 DSH，悬停提示写明两种用法，右键时浏览器菜单被阻止 (R1, R2, R2a) 自动识别目标 · 鼠标移动自动高亮窗口、桌面完整屏幕、任务栏；蓝色边框 + 白底尺寸标签（如 888×777）+ 区域外暗化 (R6, R8, R9) 单击与框选 · 单击直接确认识别区域进入编辑；按住拖动自由框选，松开即确认 (R10, R11) 无开关栏、无设置文件 · v2.1 删除了顶部「隐藏 DSH 窗口 / 长截图」开关栏与 settings.json 持久化：截图界面内没有第二个隐藏入口 (R3, R13) 统一编辑器 · 所有截图进入同一编辑器：图形（矩形/椭圆/直线）、箭头、画笔、文本（支持粗细/颜色），中间马赛克 (R18, R20, R21) 保存 / 取消 / 确定 · 右侧三键：保存 PNG、红叉取消、绿勾确定 (R22, R24) 注入输入区且绝不自动发送 · 确定后图片经由合成粘贴事件注入 DSH 会话输入区，代码绝不触发发送操作 (R23) 快捷取消 · 选区外单击鼠标右键或按 Esc 即可退出截图模式 (R4, R17) 按需启动 + 30 秒余温 · 页面加载不预热，点剪刀才启动 SnipTool.exe（运行 %LOCALAPPDATA%\dsh-screenshot 下的副本，不占用 node_modules）；一次截图结束后（确定/取消/右键退出）进程只多活 30 秒就自行消失——30 秒内再截一张走管道唤醒、秒开；空闲超时后机器上没有任何截图进程 (R27) 语言与主题跟随 · 自动跟随 DSH 中/英文语言偏好与明/暗主题 (R28) 纯本地与零遥测 · 原生 .NET Framework 4.8 / GDI+ 实现，纯本地运行，无网络请求、无遥测 (R26, R29)

*注：示意图为 v2.1 工具栏：矩形、椭圆、直线、箭头、画笔、文本、马赛克 ｜ 保存、取消（红叉）、确定（绿勾）；撤销用 Ctrl+Z。*

安装

需要 Windows 10/11 和 DeepSeek Harness。不需要管理员权限，也不需要额外运行库。

1. 把仓库放到插件目录，例如 D:\dsh-home\plugins\dsh-screenshot。
2. 在 DSH profile（/profiles//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"
     }
   }

1. 启动 DSH，语音输入话筒左侧即会出现剪刀截图按钮：

*注：示意图为 v1 按钮样式；v2 剪刀按钮紧邻话筒左侧（同一容器），移除了旧的选项箭头菜单。*

快捷键与操作

操作 · 效果 左键点击剪刀按钮 · 进入截图覆盖层，DSH 窗口保持原样（不隐藏） 右键点击剪刀按钮 · 进入截图覆盖层并最小化 DSH，退出/完成后自动恢复 单击 · 确认自动识别的窗口/屏幕/任务栏区域 拖拽鼠标 · 手动框选矩形区域 拖动控制点 · 调整选区尺寸 Ctrl+Z · 撤销上一笔标注 C 或 Ctrl+C · 复制指针处色号（#RRGGBB） 回车 或 ✓ · 确定并将截图注入 DSH 输入区（不自动发送） Esc、鼠标右键、✕ · 取消截图并恢复 DSH 窗口

架构

• Host (lib/index.js): Cordis 插件服务，声明 inject = ['webServer']，管理暖进程（SnipTool.exe --serve --parent ）与 /shot/api/capture、/shot/api/last、/shot/api/probe 等路由（/shot/api/probe 默认关闭；touch %TEMP%\dsh-shot-debug.on 后刷新页面，POST /shot/api/probe 才会把前端诊断 JSON 写到 %TEMP%\dsh-shot-probe.json），透传语言与主题，并按本次点击传 hide=1|0（左键 0、右键 1）。
• Client (lib/client.js): 前端注入剪刀按钮到话筒左侧，移除旧选项菜单；截图完成后通过合成 paste 事件注入 composer，绝不自动发送；中英双语可读错误处理。
• Native (bin/SnipTool.exe): C# 原生覆盖层，实现窗口/任务栏/屏幕探测、统一编辑工具栏（v2.1 无长截图、无设置文件）。