前言¶
DeepSeek Harness (DSH) 依賴插件擴展能力，但在原生功能中缺少全局快捷鍵截取當前窗口的上下文注入方式。這通常迫使開發者手動截屏、切換窗口、複製粘貼，增加了工作流中的摩擦成本。
dsh-plugin-appshot 是爲此目的設計的插件。它爲 macOS 和 Windows 提供全局快捷鍵截圖，利用原生能力捕獲當前窗口，並自動作爲圖片上下文掛入 DSH 的 Composer。這實現了從“觸發截圖”到“Agent 獲得上下文”的零摩擦傳遞。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add dsh-plugin-appshot
安裝完成後，重啓 DSH。啓動日誌中出現 [dsh-plugin-appshot] plugin applied successfully 和 native agent ready 表示加載成功。
macOS 權限配置： 首次觸發截圖時，系統會彈出授權引導。必須授予“屏幕錄製”和“輔助功能”權限，插件才能正常工作。
核心功能¶
通用能力¶
- 單窗口精準截圖： 僅截取當前前臺窗口，不包含其他窗口、桌面、菜單欄或 Dock。
- Composer 草稿掛載： 截圖自動進入當前會話的輸入框草稿區。支持連續觸發以追加多張截圖。
- 無殘留： 臨時 Staging 文件按“單一 Owner”規則管理，在成功掛載或失敗清理後自動刪除，無文件殘留。
macOS 平臺¶
- 快捷鍵： 默認使用左右 Command（⌘+⌘）組合。支持在設置面板切換爲雙擊 Command 等模式。
- 技術實現： 基於系統 ScreenCaptureKit，支持 Retina 高清分辨率，自動過濾透明層、陰影和 Tooltip。
- 先截後喚： 嚴格遵循“先截圖，後喚起 DSH”的流程。截圖落盤後，Native Agent 纔會喚醒並置頂 DSH 窗口，防止誤截 DSH 自身。
- 權限反饋： 缺少權限時彈出系統授權引導，並通過系統通知提示失敗原因。
Windows 平臺¶
- 快捷鍵： 默認使用左右 Ctrl（Ctrl+Ctrl）。可在 DSH 設置面板中自定義修飾鍵組合，配置跨重啓保留。
- 靜默交付： 截圖過程不激活、不聚焦 DSH 窗口。通過 Node 內存與 HTTP 長輪詢將圖片靜默掛入 Composer，不打斷當前工作流。
- 兩階段截圖： 採用“置前 + 降級”策略。先備份窗口內容，若置前失敗則降級使用備份，確保截取到的即用戶看到的內容。
- 無打擾反饋： 提供快門音、邊框閃爍與縮略圖飛入動畫（可在設置中關閉）。所有失敗提示均爲不搶焦點的輕量浮層。
使用方法¶
- 觸發截圖： 在任意應用中按下全局快捷鍵。
- macOS：同時按下左 ⌘ 與右 ⌘。
- Windows：同時按下左 Ctrl 與右 Ctrl。
- 查看結果：
- macOS： 截圖完成後，DSH 窗口自動喚起並聚焦。
- Windows： 截圖靜默進入當前會話輸入框，DSH 保持原樣。
- 提交： 在 Composer 中輸入描述（如“分析這個報錯”），點擊發送。截圖將隨文本一起提交。
限制與注意事項¶
- 平臺要求： 僅支持 macOS 14+ (Apple Silicon / arm64) 和 Windows 10 19041+ (x64)。WebUI 暫不支持（瀏覽器沙箱無法獲取全局快捷鍵）。
- 功能缺失： 不包含區域框選、全屏截圖、圖片標註、OCR 與歷史圖庫管理。
- 依賴約束： 依賴
@deepseek-ai/cordis(^4.0.1) 與@deepseek-ai/dsh-tools(exact 0.1.0-rc.6)。在 Windows 下，peer 依賴可能因權限問題安裝失敗，建議在開發者模式下安裝。
總結¶
dsh-plugin-appshot 通過全局快捷鍵將截圖能力無縫集成到 DSH 工作流中。無論是 macOS 的自動喚起還是 Windows 的靜默掛載，都旨在減少上下文準備的步驟，讓 Agent 能夠更直接地獲取當前窗口的視覺信息。
- 項目主頁： https://github.com/TaurusWood/dsh-plugin-appshot
- 目錄頁： https://www.skillhub.cn/plugins/TaurusWood/dsh-plugin-appshot
