前言¶
在 DSH 裏做圖片理解或補充說明時，常見路徑是先打開系統截圖工具，框選內容，再切換回 DSH 輸入框手動粘貼。dsh-screenshot 把這個過程接到 DSH composer：輸入框旁提供相機按鈕，也提供全局快捷鍵，並把監聽器的啓停綁定到 DSH Desktop 生命週期。下面介紹它的能力、安裝方式和注意事項。
這是什麼¶
dsh-screenshot 是 DSH 客戶端插件，由 Alain-Prot0s5 維護，採用 MIT 許可。它面向 Windows 10 (1809+) 和 Windows 11，主要解決“截圖後快速進入 DSH 輸入框”的問題：系統截圖完成後，插件把圖片自動粘貼到 composer，減少手動複製與窗口切換。
這個插件是 DSH Desktop 專用。宿主生命週期、DSH Desktop 進程看門狗、前臺檢測都依賴 DSH Desktop，因此 Web 端只能作爲受限場景使用。
核心功能¶
下面列出已覈實的能力。
- 相機按鈕：位於 composer tool row，點擊後觸發系統截圖，框選完成後可自動粘貼。
- 全局快捷鍵：默認
Alt+A，修飾鍵和按鍵可配置。 - 監聽器生命週期：監聽器隨
DSH Desktop啓動而啓動，隨DSH Desktop關閉而停止。 - 設置頁：可配置全局快捷鍵、是否自動粘貼、後臺是否跳轉粘貼，修改後即時生效。
- 可靠性處理：非阻塞等待剪貼板、單飛防抖、取消檢測、舊
SnippingTool清理、看門狗兜底。
安裝與啓用¶
先確認環境：系統爲 Windows 10 (1809+) 或 Windows 11，並且使用 DSH Desktop 的 desktop profile。該插件依賴系統 Snipping Tool（ms-screenclip:）和 Win32 APIs，PowerShell 5.1 預期已存在。
從 GitHub 安裝：
dsh plugin --profile desktop add github:alain-prot0s5/dsh-screenshot
從 npm 安裝：
dsh plugin add @alain-prot0s5/dsh-screenshot
在 DSH Desktop >= 2.0.2 的兼容性說明中，需要使用完整 scoped package name @alain-prot0s5/dsh-screenshot。
經過上面的步驟後，重啓 DSH Desktop。啓動後可在輸入框旁看到相機按鈕，也可以直接按全局快捷鍵開始截圖。
典型用法¶
- 在
DSH Desktop中打開需要輸入截圖的會話。 - 點擊 composer 旁的相機按鈕，或按下默認快捷鍵
Alt+A。 - 使用系統截圖工具框選區域。
- 截圖完成後，插件按設置執行自動粘貼；如果關閉自動粘貼，圖片會留在剪貼板。
- 如果
DSH Desktop在後臺，且設置頁開啓了後臺跳轉粘貼，插件會切到前臺並粘貼。
Web 端如果需要使用觸發服務，可使用獨立版監聽器 dsh-screenshot-script/。受前臺判斷限制，Web 端的自動粘貼檢測會受限，截圖通常會留在剪貼板。
也可以按需搭配 dsh-vision-router，形成 screenshot -> question -> image understanding 的流程。
適用場景與注意¶
適合在 DSH Desktop 中頻繁處理截圖、需要快速把圖片送入輸入框的 Windows 用戶。尤其是截圖說明、圖片理解、視覺調試等場景。
使用前需要注意：
- 只支持
Windows 10 (1809+)和Windows 11；不支持macOS、Linux、Windows 7/8。 - 插件是
DSH Desktop專用，Web 端能力受限，建議以桌面端爲主。 - 項目說明其爲 AI-generated、beginner-level code，且未做專業安全審計。由於插件運行在 DSH 的宿主/客戶端環境中，並以當前
dsh進程權限執行，生產環境使用前應審閱源碼、檢查依賴和許可證。 - 許可證爲
MIT。
結尾¶
dsh-screenshot 的價值在於把 Windows 截圖和 DSH 輸入框之間的複製、切換、粘貼步驟合併成一次觸發，適合日常在 DSH Desktop 中用截圖補充上下文。社區目錄頁可按插件名 dsh-screenshot 查找；該目錄是獨立站點，不等同於 DeepSeek 或幻方的官方應用商店。GitHub 倉庫見：
https://github.com/Alain-Prot0s5/dsh-screenshot
