前言¶
在 DeepSeek Harness (DSH) 的開發流程中，通過截圖說明邏輯或標註代碼片段是常見需求。dsh-shot 插件將截圖能力直接集成到 Composer 編輯器中，允許用戶在窗口內的覆蓋層上進行框選、標註，並支持在捕獲時隱藏 DSH 窗口。
它是什麼¶
dsh-shot 是一個由 19north 維護的客戶端插件。它通過在 Composer 編輯器中添加相機按鈕，爲用戶提供一個窗口內的截圖與標註工作流。捕獲結果會以圖片附件的形式放入當前對話的草稿中。
核心功能¶
- 框選與調整：在打開的覆蓋層中拖拽矩形選區，支持通過邊緣手柄調整大小或拖拽內部移動位置。
- 標註工具：支持矩形框、箭頭、文本三種標註方式，並提供 8 色調色板。
- 隱藏窗口捕獲：提供“Hide this window”選項，在捕獲前隱藏 DSH 窗口，捕獲後恢復原狀。
- 交互微調：支持使用方向鍵微調選區（Shift 鍵精確移動 10 像素），並支持撤銷操作。
安裝與啓用¶
安裝該插件需要指定 DSH 的 Profile。
dsh plugin --profile <profile> add dsh-shot
安裝後，插件會自動追加到 dsh.profile.bundles，需重啓 DSH 應用使插件生效。
使用方法¶
- 啓動捕獲：點擊編輯器中
＋旁邊的相機按鈕，從菜單中選擇“Direct capture”（直接捕獲）或“Hide this window”（隱藏窗口捕獲）。 - 選擇區域：在窗口內的覆蓋層上拖拽鼠標框選需要捕獲的區域。
- 調整選區：
- 拖拽選區邊緣的八個手柄（角落和邊中點）調整大小。
- 拖拽選區內部移動位置。
- 使用方向鍵微調選區，按住 Shift 精確移動 10 像素。
- 右鍵或再次點擊選區以重置選區。
- 添加標註：使用矩形、箭頭或文本工具進行標註。文本工具點擊位置輸入，Enter 確認，Esc 取消。
- 確認：確認（或按 Enter）後，截圖將作爲圖片附件放入草稿。
注意事項¶
- 平臺限制：僅支持 Windows 平臺。
- 覆蓋層機制：覆蓋層位於 DSH 窗口內而非全屏，捕獲畫面會縮放適配窗口，可能產生黑邊。
- 窗口隱藏：在“Hide this window”模式下，DSH 窗口會短暫消失（約 0.3-1.2 秒）。
- 空幀問題：捕獲腳本偶爾可能返回空幀，需要手動重試。
- 版本要求：需要 DeepSeek Harness 0.1.7 或更高版本。
總結¶
dsh-shot 爲 DSH 用戶提供了一個輕量級的截圖與標註方案，無需切換到外部截圖工具。對於需要頻繁在對話中插入截圖說明的開發者，該插件能有效提升溝通效率。更多細節與源碼可查閱其 GitHub 倉庫。
