前言¶
在用 DeepSeek Harness（DSH）寫智能體或調試時，經常需要把桌面窗口、錯誤彈窗、應用界面截下來貼進對話。如果用系統截圖工具再手動粘貼，流程冗長；如果依賴瀏覽器截圖，往往只能截到當前頁面，且頁面裏會殘留一張預覽圖。
dsh-snip 是一款爲 DSH 適配的輕量級截圖標註插件，交互與 Snipaste 一致：按 F1 整屏定格壓暗、框選區域、畫紅框與文字，合成 PNG 直接回填到輸入框，不產生頁面裏的截圖預覽。
這是什麼¶
- 插件名稱：dsh-snip
- 維護者：XXP-AI-SPACE
- 分類：客戶端
- 核心價值：在 DSH 內直接完成「全屏截圖 → 標註 → 回填」的閉環，減少跨應用切換，不干擾當前對話。
核心功能¶
截圖與標註流程¶
- 進入截圖：點擊輸入框工具行的剪刀圖標，或按下
F1（宿主側全局熱鍵）。 - 整屏定格壓暗，拖動鼠標框選目標區域。鬆手後選區恢復亮度，可拖邊角微調或拖框內移動。
- 選區下方彈出工具條：
- Box：在選區裏拖出紅色方框外框，可畫多個。
- Text：在選區裏點一下就地輸入文字（回車確認），滾輪調整字號（8–200 px）。
- Size N：顯示當前字號，滾輪實時變化。
- Done：合成並投遞。
- Cancel：取消。 - 快捷鍵：
-Enter確認（尚未框選時先按 = 整屏）。
-Esc退出截圖（正在寫字時先取消這條文字）。
- 雙擊選區內確認。 - 完成後：標註圖按原分辨率合成爲 PNG，自動作爲附件放進當前輸入框，同時寫入剪貼板。
技術實現¶
- 浮層由宿主側拉起的系統級全屏窗口（TopMost），不依賴頁面內 DOM。
- 截取浮層出現前那一幀，不會把浮層本身截入結果。
- 結果以
-Out旁的<png>.meta.json交付，宿主讀取文件而非 stdout，避免跨進程管道開銷。 - 支持多顯示器（按虛擬屏幕整體覆蓋，含負座標屏）。
安裝與啓用¶
官方安裝命令（從市場或 GitHub）：
# npm（收錄進市場後，市場裏點安裝也是這條）
dsh plugin --profile desktop add dsh-snip
# 直接從 GitHub 裝
dsh plugin --profile desktop add github:XXP-AI-SPACE/dsh-snip
# 本地開發（link 到源碼）
dsh plugin --profile desktop add "link:F:\工作之後\3-DSH\plugins\dsh-snip"
安裝後需要冷啓動桌面端（宿主半），瀏覽器半刷新頁面即可生效。
典型用法¶
- 在 DSH 對話中，點擊輸入框工具行的剪刀圖標，或直接按
F1。 - 框選需要標註的區域，選區下方出現工具條。
- 點擊 Box 畫紅色外框，或點擊 Text 輸入說明文字（滾輪調整字號）。
- 雙擊選區或按
Enter完成合成，圖片直接作爲附件進入輸入框，無需再粘貼。
適用場景與注意¶
- 適合需要頻繁把桌面界面、應用窗口、錯誤彈窗貼進 DSH 對話的開發者與智能體創作者。
- 插件以當前 DSH 進程權限運行，安裝前建議查看源碼與許可證（MIT）。
- 僅支持 Windows 10/11（依賴 Windows PowerShell + WinForms）。
F1爲默認全局熱鍵，若已被佔用可在lib/index.js頂部修改HOTKEY_KEY。
短結尾¶
dsh-snip 把 Snipaste 式的截圖標註流程集成進 DeepSeek Harness，減少跨應用切換，不干擾頁面。想了解更多或下載源碼，可訪問插件目錄頁或 GitHub 倉庫。
參考資料¶
- 插件目錄頁：https://www.skillhub.cn/plugins/XXP-AI-SPACE/dsh-snip
- GitHub：https://github.com/XXP-AI-SPACE/dsh-snip
