前言¶
在 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 倉庫。
