前言¶
在 DeepSeek Harness（DSH）里和模型对话时，经常要把界面上的某一块内容截下来当附件说明问题。系统截图工具往往要切窗口、记快捷键，截完还要自己找文件再拖进 composer。下面介绍的 dsh-longpress-shot 把「框选 → 存 PNG → 进对话」收进 DSH 页面内：左键长按约半秒进入选区模式，拖出矩形松手即抓图，并弹出预览卡，可直接把图送进输入框。
这是什么¶
dsh-longpress-shot 是维护者 kkkkk-tubu 发布的 DSH 客户端类插件（当前 GitHub 星标为 0）。它不依赖单独热键、托盘菜单或第三方截图应用：在 DSH 任意页面长按左键、拖拽选区即可得到 PNG，同时写入系统剪贴板，并通过预览卡提供「发到输入框」等操作。
平台限制：README 明确写明 Windows only，抓屏路径为宿主侧通过 PowerShell 调用 GDI；非 Windows 环境不应指望同款能力。
插件安装后不会出现在导航栏，全局生效、无单独入口——行为完全由长按与预览卡驱动。
核心功能¶
经 README 与 package.json（版本 1.11.2，许可证 MIT）核对，能力包括：
- 长按进入选区：左键按住不动 ≥ 550 ms，页面变暗、光标变十字；继续按住并拖拽出现蓝色选框，松手抓取该区域。
- 误触防护：长按后直接松手、未拖拽时停留在遮罩状态，可再次按下重画框，不会静默抓取整窗。
- 整窗抓取：遮罩激活后双击或按
Enter，抓取整个 DSH 窗口。 - 取消：右键或
Esc退出，不保存。 - 落盘与剪贴板：裁剪结果保存为
~/.dsh/longpress-shots/shot-YYYYMMDD-HHMMSS-mmm.png，并复制到系统剪贴板。 - 预览卡：显示缩略图、像素尺寸、文件名；按钮包括
发到输入框、另存为、复制路径、关闭。拖标题栏可移动卡片，位置记入localStorage，默认位置会避开右下角鲸鱼挂件区域。 - 送入 composer 的三种方式（README 按可靠度排序）：点
发到输入框（推荐）；在输入框Ctrl+V；将卡片缩略图拖到输入框（Chromium 同页拖放受限时，插件侧有合成粘贴等兜底路径）。 - 不抢文本选择：在
input/textarea/select/contenteditable内长按不会触发截图。
宿主兼容性（package.json 中 dsh.compatibility）：对 0.2.1-rc.3、0.3.0-rc.1 标记为 compatible；引擎要求 Node >=20，DSH peer 范围为 >=0.2.1-rc.2 <0.3.0-0 || >=0.3.0-rc.1。
安装与启用¶
官方安装命令如下（勿自行拼接未在文档出现的 registry 形式）：
dsh plugin add dsh-longpress-shot
也可从 release tarball 安装（无需 registry）：
dsh plugin add "https://github.com/kkkkk-tubu/dsh-longpress-shot/releases/download/v1.11.2/dsh-longpress-shot-1.11.2.tgz"
安装完成后重启 DSH。插件以当前 DSH 进程权限运行；安装前应在 GitHub 查看源码与 MIT 许可证，自行评估是否满足环境要求。
手动安装说明（README）：将包置于 <profile>/node_modules/，写入 profile 的 dependencies，再重启。
典型用法¶
经过上面的安装与重启，在 DSH 界面内按下列步骤操作即可复现 README 描述的行为。
| 操作 | 结果 |
|---|---|
| 左键按住 ≥ 550 ms | 遮罩 + 十字光标 |
| 按住并拖拽 | 蓝色选框，松手 → 区域 PNG |
| 长按后松手未拖 | 保持 armed，可再拖框 |
遮罩内双击 / Enter |
整窗 PNG |
右键 / Esc |
取消 |
抓图完成后使用预览卡：需要立刻作为附件对话时，优先点 发到输入框；或聚焦 composer 后 Ctrl+V；或拖拽缩略图到输入框。关闭卡片点 关闭 或卡片上的关闭控件；拖标题栏可 reposition，且卡片上的交互不会漏给桌宠层。
工作原理（简要）¶
前端 shot.js 在长按超时后建遮罩，将选区以比例坐标（非 CSS 像素）POST 到 /dsh-longpress-shot/capture；宿主 lib/index.js 调 PowerShell 脚本 capture.ps1，用 GDI 定位 DSH 窗口客户区并按比例裁剪写 PNG。页面无法直接做 OS 级抓屏，故抓屏必须在宿主完成；比例传递用于对齐 DPI / 缩放。
适用场景与注意¶
- 适合：在 Windows 上使用 DSH、希望无快捷键地框选界面片段并快速贴进 composer 的开发者或日常对话用户。
- 不适合：非 Windows；需要在浏览器外抓其它应用窗口（本插件针对 DSH 窗口客户区）。
- 安全与信任：插件会写本地目录、调 PowerShell、写剪贴板；与所有 DSH 插件一样，应阅读 仓库源码 后再安装。
- 生态说明：DSH 社区插件目录（如 SkillHub 插件页）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装命令以 README 为准。
结尾¶
dsh-longpress-shot 用长按 + 框选把截图和 composer 附件 intake 接在同一条操作链上，减少切工具和找文件。更多信息见 SkillHub 目录页 与 GitHub 仓库。
