前言¶
在 DeepSeek Harness (DSH) 的使用過程中，通過截圖分享上下文是高頻需求。原生方案通常依賴瀏覽器的屏幕共享 API (getDisplayMedia)，流程繁瑣，且往往受限於系統級選擇器（如只能選一個屏幕）。dsh-capture 插件通過提供原生應用般的浮層體驗，實現了框選、標註並直接投遞圖片到輸入框的能力，將截圖操作集成到 DSH 的工作流中。
插件定位¶
名稱: max-null/dsh-capture
作者: Max-Null
許可: MIT
類型: 客戶端插件
該插件屬於 @max-null/* 插件系列的一部分，旨在爲思靈桌面體驗（SSID）提供高效的截圖輔助能力。它支持雙引擎運行，能根據環境自動切換底層捕獲邏輯。
安裝¶
通過 npm 安裝插件：
npm install @max-null/dsh-capture
安裝後，插件會根據環境自動探測是否運行在思靈殼（SSID）內，並選擇對應的引擎邏輯。
核心功能¶
- 框選與捕獲: 在屏幕上框選任意區域，支持多顯示器環境下的像素級 1:1 抓取。
- 標註工具: 提供矩形、橢圓、箭頭和文字標註，支持 8 種顏色選擇（默認紅色）。
- 智能投遞: 截圖完成後，圖片自動進入當前會話的輸入框附件草稿區，支持追加文字後發送。
- 原圖預覽編輯: 點擊任意圖片（截圖或歷史消息）的縮略圖，可進入編輯模式進行整圖標註，編輯後自動投遞。
- 操作回退: 支持右鍵或
Esc鍵逐級回退（撤銷標註 → 重選 → 退出）。
使用方法¶
思靈殼 (SSID) 內¶
- 打開任意 DSH 會話（無會話時截圖會被靜默丟棄）。
- 觸發方式：
- 點擊托盤菜單中的「截圖引用」。
- 使用全局快捷鍵（默認
Ctrl+Shift+A，可在設置中修改）。
- 操作流程：
- 屏幕出現凍結幀 + 十字準星。
- 左鍵拖拽 框選區域 → 選區定格後出現工具條。
- 在工具條中選擇顏色和工具（箭頭拖拽繪製，文字點一下輸入）。
- 按
回車、雙擊或點擊「完成」確認發送。 - 右鍵 / Esc 逐級回退操作。
- 隱藏窗口設置: 默認開啓「截圖時隱藏思靈窗口」，此時凍結幀中不包含 DSH 自身窗口。關閉該選項後，凍結幀將包含思靈窗口，可框選對話內容。
純 DSH (瀏覽器環境)¶
- 打開任意 DSH 會話。
- 點擊輸入框左側的相機按鈕（位於潤色按鈕旁）。
- 瀏覽器彈出「選擇要共享的屏幕」對話框，選擇一個屏幕。
- 捕獲一幀後自動停止共享，進入全屏遮罩的框選與標註模式，後續操作同上。
原圖預覽編輯¶
- 點擊任意圖片（草稿或歷史消息）的縮略圖，打開官方「原圖預覽」對話框。
- 點擊右上角的 ✎ 編輯按鈕。
- 對整圖進行標註（工具與截圖一致），完成後點擊「完成」。
- 系統會自動投遞編輯後的圖片到輸入框，預覽窗口關閉。
配置項¶
在 DSH 的「插件」頁面對應 dsh-capture 卡片中：
* 截圖時隱藏思靈窗口: 控制思靈殼模式下，凍結幀是否包含 DSH 自身窗口。
* 截圖全局快捷鍵: 支持 Electron accelerator 語法（如 Control+Alt+B），修改後立即生效。
注意事項¶
- 雙圖投遞: 當畫面存在標註時，插件會同時投遞「原圖」和「編輯圖」兩張圖片，原圖保持原始內容，編輯圖承載標註內容。
- 純 DSH 限制: 純瀏覽器模式下，只能選擇一個屏幕；無法隱藏宿主窗口；無法使用全局快捷鍵。
- 原圖預覽編輯: 在預覽編輯模式下，投遞的是編輯圖（原圖已在對話歷史中）。
- 無會話丟棄: 若未打開任何會話直接截圖，截圖操作會被靜默丟棄，浮層會提示「先打開一個會話」。
