前言¶
在 DSH（DeepSeek Harness）中處理文檔預覽時，經常需要把某個局部區域、截圖或引用的文字直接放入 composer，而手動截屏再粘貼比較繁瑣。dsh-preview-snip 插件把這一過程變成了一鍵操作：在預覽區拖拽矩形，就能把裁剪後的 PNG 或選中的文本插入到對話草稿中。
是什麼¶
dsh-preview-snip 是一個客戶端插件，由 439436269-ctrl 維護。它爲 DSH 的文檔預覽頭部增加了三個操作：圈選、全能圈選（帶標註）、引用選中。所有結果最終都作爲附件或 Markdown 引用進入 composer，不自動發送。
核心功能¶
圈選 / Snip¶
在預覽區拖拽一個矩形，就會把該區域截取爲 PNG 並作爲附件插入 composer。這個操作只生成圖片，不會自動填充問題。
全能圈選 / Annotate¶
在圈選後打開標註編輯器，支持添加矩形框、橢圓/圓形、箭頭和文本，可指定顏色，支持撤銷、清空、取消和插入。插入的是標註後的 PNG，不是原始裁剪。
引用選中 / Quote selection¶
把當前選中的文本以 Markdown 引用塊的形式放入 composer。
適用於多種預覽類型¶
- 像素類：
<img>、當前幀的<video>、<canvas>，包括圖片、PDF 頁面、視頻幀和 WebGL 視口（Blender/STL 等第一方查看器會保留繪圖緩衝區）。 - DOM 截圖：文本、Markdown、代碼和 HTML 預覽會被序列化爲 SVG
foreignObject並在瀏覽器中柵格化，嵌入當前 pane 的樣式，保持外觀。 - 引用：任何文本可選擇的預覽。
側邊欄瀏覽器中的使用（桌面）¶
在 DSH 右側瀏覽器標籤頁打開網頁時，預覽頭部會出現一個浮動的「圈選 / 全能圈選」分組。該功能通過 Electron 的 webview.capturePage() 捕獲整個頁面，然後按選區裁剪並標註，最終進入 composer。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile <profile> add dsh-preview-snip
安裝後，打開任意文件，在右側預覽頭部會看到一個分段按鈕組，包含「圈選」「全能圈選」「引用選中」。
典型用法¶
- 打開一個圖片、PDF 或代碼預覽。
- 在預覽區拖拽矩形，點擊「圈選」快速插入裁剪圖。
- 若需要標註，拖拽矩形後點擊「全能圈選」，在編輯器中添加框、箭頭或文本，選擇顏色，確認插入。
- 選中預覽中的文字，點擊「引用選中」，將文本作爲 Markdown 引用塊加入 composer。
- 在 composer 中完成問題與補充說明後發送。
適用場景與注意¶
適合需要在 DSH 中快速提取預覽局部、添加標註或引用文本的開發者與智能體用戶。插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。兼容 DSH 0.2.0-rc.2 和 0.2.1-rc.2。
短結尾¶
dsh-preview-snip 通過統一的圈選與標註流程，把文檔預覽的局部內容轉化爲可複用的素材，減少手動截圖與剪貼的步驟。插件目錄：https://www.skillhub.cn/plugins/439436269-ctrl/dsh-preview-snip，GitHub：https://github.com/439436269-ctrl/dsh-preview-snip
