前言¶
在 DeepSeek Harness（DSH）裏把屏幕上的內容交給模型，常見做法是：系統截圖、在磁盤裏找文件、再拖進對話。步驟多，也容易打斷編寫提示詞的節奏。社區插件 dsh-screenshot（維護者 GYL9999）把這條路徑收成：點「截屏」→ 在凍結畫面上框選 → Enter 複製，或保存後把路徑寫進輸入框草稿。本機桌面截圖面向 Windows，依賴 PowerShell 與 System.Drawing，README 寫明其他平臺仍可用瀏覽器側 getDisplayMedia 兜底。
這是什麼¶
dsh-screenshot 是 DSH 的客戶端類截圖插件：在輸入框工具欄（「剪輯」右側）提供「截屏」入口，並支持全局快捷鍵 Ctrl+Alt+S。整屏抓取多顯示器虛擬桌面後立刻凍結覆蓋在界面上，用戶可直接拖矩形選區，或切換到窗口吸附模式截取單個頂層窗口；複製、保存與向對話插入路徑由插件統一處理。倉庫地址：GitHub GYL9999/dsh-screenshot；社區目錄：skillhub 條目。許可證 MIT，當前 package.json 版本爲 1.0.0。
核心功能¶
下面按 README 已列能力歸納，不超出文檔表述。
整屏凍結與框選¶
點「截屏」後抓取整個虛擬桌面（多顯示器、物理像素），以凍結畫面覆蓋界面，無需在系統彈窗裏先選窗口。在凍結層上拖矩形，框外壓暗；Enter 或 Ctrl+C 複製選區並關閉，Ctrl+S 保存。
窗口吸附¶
工具條點「窗口」，鼠標懸停高亮，單擊截取該窗口自身渲染（PrintWindow）；被其他窗口遮擋時仍可拿到窗口完整內容（非單純屏幕像素疊層）。
複製、保存與對話草稿¶
複製走系統剪貼板。保存落到 %USERPROFILE%\Downloads\dsh-screenshots\，並把文件路徑自動插入輸入框草稿，便於模型按路徑讀取本機文件。
快捷鍵¶
| 按鍵 | 作用 |
|---|---|
Ctrl+Alt+S |
隨時喚出截屏 |
R |
重新截屏 |
Esc |
先清選區再關閉 |
Backspace |
清空選區 |
Agent 工具與瀏覽器兜底¶
Host 側註冊工具 screen_capture，模型可自行截屏並取得路徑；參數 read: true 時可選調用 modlens 視覺橋（OCR/版面/語義），需本機已配置 modlens provider，未配置時只返回提示，不影響截圖本身。本機 loopback 路由不可達時，客戶端可用 getDisplayMedia 從頁面側共享屏幕。
性能（作者本機實測）¶
早期每次截圖新起 PowerShell 並現場編譯 P/Invoke，耗時約 2 秒級。當前在插件激活時拉起常駐 worker，C# 只編譯一次；README 給出的對比爲整屏約 0.16–0.24 s、窗口列表約 0.09 s、單窗口截圖約 0.24 s（worker 崩潰或超時會自動重啓）。
安裝與啓用¶
安裝命令須使用 README 原文（注意 --profile desktop）：
dsh plugin --profile desktop add github:GYL9999/dsh-screenshot
# 然後重啓 DSH
裝好後輸入框旁出現「截屏」按鈕；Ctrl+Alt+S 同樣可用。插件以當前 DSH 進程權限運行，安裝前建議瀏覽倉庫源碼並確認 MIT 許可是否符合你的環境要求。
典型用法¶
- 在 DSH 桌面配置裝好插件並重啓後，在對話輸入框旁點「截屏」，或按
Ctrl+Alt+S。 - 在凍結畫面上拖拽矩形框住要給模型看的區域，按
Enter複製，再在輸入框Ctrl+V粘貼；或按Ctrl+S保存，由插件把落盤路徑寫入草稿。 - 需要整窗內容時，在工具條選「窗口」，懸停確認高亮窗口後單擊；保存路徑默認在
%USERPROFILE%\Downloads\dsh-screenshots\。 - 若由 Agent 調用，使用 Host 暴露的
screen_capture；需要識圖時再按文檔配置 modlens 並傳read: true。
Host 僅接受 loopback 且同源的本機 API，例如：
GET /api/fullscreen-shot：整桌 PNGGET /api/fullscreen-shot/windows：頂層窗口列表與虛擬屏邊界GET /api/fullscreen-shot/window?id=<hwnd>：單窗渲染POST /api/fullscreen-shot：保存 PNG 並返回路徑
適用場景與注意¶
適合誰： 常在 Windows 上使用 DSH 桌面配置、需要把界面、報錯彈窗或多顯示器畫面快速交給模型的開發者；需要在對話裏保留可複用文件路徑而非僅剪貼板位圖時，保存落盤更合適。
限制（README 已知）： 窗口選擇僅在預覽爲整屏時可用；裁切後或已是窗口截圖時座標不再對應屏幕。DSH 自身窗口不進窗口列表（避免 UI 線程忙時自截卡死）。最小化窗口不列入候選。原生截圖僅 Windows；其他平臺依賴瀏覽器兜底。
DeepSeek Harness 生態強調「一切皆插件」；skillhub.cn 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-screenshot 把「系統截圖 → 找文件 → 拖進對話」壓成工具欄一鍵與若干快捷鍵，並在 Windows 上通過常駐 worker 降低重複截圖延遲。進一步瞭解實現與 issue，見 GitHub 倉庫 與 目錄頁。
