前言¶
在 DSH 裏向模型貼圖時，常見做法是先切到系統或第三方截圖工具，再回客戶端粘貼。窗口一搶焦點，要截的區域常被擋住；DSH 在後臺或最小化時，入口也不順手。DeepSeek Harness 的插件機制允許在輸入區旁掛能力、用宿主接口寫回會話。下面介紹社區客戶端插件 gcolt888/dsh-screenshot-hotkey：微信式框選與標註，配合系統級熱鍵（默認 Ctrl+Alt+S），按下時不把 DSH 拉到前臺，截完儘量直接進當前會話輸入框。
這是什麼¶
dsh-screenshot-hotkey 由維護者 gcolt888 發佈，歸類爲 客戶端 插件。它在 DSH 作曲者（composer）側提供截圖標註，並註冊全局快捷鍵；框選針對的是你正在看的前臺窗口，而不是被迫先激活 DSH。
實現上基於 @sfunction/dsh-screenshot（MIT）擴展，倉庫保留原版權聲明，許可證爲 MIT。package.json 聲明依賴 DSH 版本範圍爲 >=0.2.0-rc.2 <0.3.0-0，當前包版本爲 0.4.3。
核心功能¶
已覈實能力如下，均來自項目 README：
- Ctrl+Alt+S 隨處可用：DSH 在前臺、後臺或最小化均可；不會因彈窗遮住待截區域。
- 框選與標註：凍結屏幕、拖拽選區；支持畫筆、矩形、文字、馬賽克與顏色；Enter 或確認完成。
- 取消與回撤：右鍵取消（Esc 亦可），逐級返回：先撤標註 → 再清選區 → 最後關窗。
- 自動插入：完成後寫入當前會話輸入框；找不到輸入框時退回剪貼板並提示。
- 改鍵：在 DSH「設置 → 通用設置 → 快捷鍵」中搜索「截圖標註」錄製新鍵位，全局熱鍵會跟隨
keybindings.json重載。 - 設置頁：DSH「設置 → 截圖標註」可查看當前鍵位。
- 輸入框按鈕：
client.js在輸入框左側提供按鈕，並向快捷鍵服務登記dsh-screenshot.capture（佔位、可改鍵）。
安裝與啓用¶
官方安裝命令如下（裝完需重啓 DSH）：
dsh plugin --profile desktop add github:gcolt888/dsh-screenshot-hotkey
README 也說明收錄市場後可從市場安裝。插件在 Windows 上運行，依賴 WPF/WinForms 原生選區窗口；首次截圖或首次啓動時，會用 Windows 自帶的 .NET Framework 4 的 csc.exe 從 select.cs、hotkey.cs 現場編譯 shot.exe、hotkey.exe。
典型用法¶
用全局熱鍵截圖並送入對話
- 保持要截內容的窗口在前臺（無需先點 DSH）。
- 按默認 Ctrl+Alt+S（或你在面板裏改好的組合鍵）。
- 在凍結畫面上框選區域，按需標註，Enter 或 ✓ 完成。
- 回到 DSH 當前會話：圖片應出現在輸入框；若未找到輸入框，結果在剪貼板並會有提示。
在客戶端內改快捷鍵
- 打開 DSH「設置 → 通用設置 → 快捷鍵」。
- 搜索「截圖標註」，錄製新鍵位。
- 全局熱鍵會自動重載（讀取
keybindings.json）。
衝突時的處理
若熱鍵與其他軟件衝突（README 舉例：QQ 截圖默認 Ctrl+Alt+A），在面板裏改鍵即可。
工作方式概覽¶
便於排障時對照組件職責：
| 部分 | 作用 |
|---|---|
client.js |
輸入框左側按鈕；登記 dsh-screenshot.capture；長輪詢 /shot/pending 取外部截圖並貼進輸入框 |
index.js |
宿主側：/shot/capture 打開選區、/shot/pending 長輪詢交付、拉起並守護 hotkey.exe |
hotkey.cs → hotkey.exe |
系統級 RegisterHotKey，按下直接運行 shot.exe（不激活 DSH），結果寫入臨時隊列目錄；讀 keybindings.json 跟隨改鍵 |
select.cs → shot.exe |
全屏凍結、框選、標註的原生窗口 |
運行日誌路徑：%TEMP%\dsh-shot-hotkey.log。
若需改截圖入口邏輯，可編輯 select.cs 後按 README 重編譯 shot.exe：
csc -nologo -target:winexe -optimize -out:shot.exe -r:System.Windows.Forms.dll -r:System.Drawing.dll select.cs
適用場景與注意¶
適合誰
- 主要在 Windows 上使用 DSH desktop profile，希望在寫 prompt 時快速貼圖、標重點，且不想被 DSH 窗口擋住目標界面的人。
- 需要與微信式截圖類似的框選與簡單標註，而不是僅系統剪貼板截圖的用戶。
務必注意
- 僅 Windows：
package.json的os爲win32，非 Windows 環境不適用。 - 插件權限：客戶端插件隨當前 DSH 進程運行；安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證，確認行爲符合你的環境策略。
- 社區生態：DSH 強調「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係，不等同於官方應用商店。
- 開發同步：本地改源碼後需用倉庫內
sync-to-profile.cmd同步到本機 DSH profile；README 強調 profile 的node_modules須爲真實目錄，不能用 junction，否則客戶端可能長時間卡在 Loading plugins。
結尾¶
dsh-screenshot-hotkey 把微信式截圖標註和不搶焦點的全局熱鍵接到 DSH 輸入框：適合在桌面 profile 裏高頻貼圖說明問題。安裝用官方 dsh plugin --profile desktop add 命令，改鍵與設置頁均在 DSH 內完成；排障可看 %TEMP%\dsh-shot-hotkey.log。
