前言¶
在 DeepSeek Harness(DSH)裏向模型說明界面問題時,常見流程是:系統截圖、保存文件、用其它工具畫框箭頭、再上傳附件。步驟多,且截圖與標註兩次落盤。社區插件 dsh-screenshot(維護者 sfunction-guo)把流程收成「點按鈕 → 拖框 → 標註 → 完成」,成品 PNG 直接進入 DSH 輸入框附件區,或僅保存到本地。插件分類爲客戶端,僅支持 Windows(WinForms)。DSH 生態主張「一切皆插件」;SkillHub 目錄頁 爲社區站點,與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-screenshot 是在 DSH 對話輸入框左側增加「取景框」按鈕的工具:凍結桌面 → 拖選區域 → 就地標註 → 一鍵寫入輸入框(或只導出 PNG)。README 寫明當前工具版本爲 0.1.0,npm 包 @sfunction/dsh-screenshot 在 package.json 中爲 0.1.1。處理全程在本機完成,不經過遠程服務器。
核心功能¶
截圖選區¶
點擊輸入框左側取景框按鈕後,整個桌面被凍結並壓暗。按住左鍵拖出範圍,框內實時變亮、框外保持壓暗,角落顯示像素尺寸;鬆手確認,Esc 取消。
標註工具¶
工具條分兩排:主排爲工具與動作,部分工具在下方展開第二排參數。
| 工具 | 第二排參數 | 說明 |
|---|---|---|
| 標註 | 矩形 / 橢圓 / 直線 / 箭頭 | 拖出形狀 |
| 畫筆 | 細 / 中 / 粗 + 橡皮擦 | 手繪曲線;橡皮按當前粗細擦除 |
| 文字 | 小 / 中 / 大 + 編號 | 點擊輸入文字;編號拖放生成 ①②③ |
| 馬賽克 | — | 拖出範圍模糊,用於遮擋敏感內容 |
顏色共 6 種:紅、藍、綠、黃、黑、白。文字與編號可選中後移動、縮放字號;雙擊改內容,Delete 刪除。
輸出方式¶
- ✓ 完成:PNG 進入輸入框附件區,可繼續輸入文字一併發送。
- 保存:選擇路徑存 PNG,只落盤、不進輸入框;保存後會話結束,不會再插入輸入框。
- × 取消:丟棄本次截圖。
腳本化調用時,shot.exe 退出碼含義見 README:0 完成並適合粘貼進輸入框,2 用戶取消,3 寫文件失敗,4 僅保存到磁盤。
安裝與啓用¶
系統要求¶
- Windows 10 / 11
- .NET Framework 4.x(系統自帶)
package.json 中聲明 DSH 引擎範圍:dsh 爲 >=0.2.0-rc.2 <0.3.0-0,且 os 爲 win32。
安裝方式¶
方式一(推薦):DSH 設置 → 插件 → 發現 中搜索 dsh-screenshot,或從插件市場安裝(以市場收錄情況爲準)。
方式二:npm
該包爲 DSH bundle,通過 package.json 裏的 dsh.bundle.patch(即 cordis.patch.yml)裝載補丁。安裝命令如下:
npm install @sfunction/dsh-screenshot
方式三(開發):將倉庫目錄放入 DSH profile,由插件管理器作爲 bundle 安裝;shot.exe 缺失時會用 select.cs 現場編譯。
安裝前建議閱讀 GitHub 源碼 與 MIT 許可證。插件以當前 DSH 進程權限運行,安裝前應自行覈對源碼與許可條款。
典型用法¶
按 README 給出的操作順序:
1. 在輸入框左側點「取景框」圖標
2. 全屏變暗後,按住左鍵拖出要截的範圍
3. 鬆手,工具條出現在選框下方
4. 選工具、選顏色,直接在圖上畫
5. 點 ✓ 完成(進輸入框)或「保存」(只存文件)
常用快捷鍵:
| 鍵 | 作用 |
|---|---|
Esc |
先取消選中標註;無選中時清空標註回到框選;再按則退出截圖 |
Enter |
完成並插入輸入框 |
Delete |
刪除當前選中的文字/編號 |
撤銷需用工具條「撤銷」按鈕(未綁定 Ctrl+Z)。
示例一:拖選約 1200×700 界面,紅框標按鈕、紅箭頭指向,加文字「這裏點不動」→ 附件區出現同尺寸 PNG,標註已烘焙進圖。
示例二:截聊天記錄,對暱稱、手機號各拖馬賽克 → 對應區域模糊,其餘內容不變。
示例三:標註後點「保存」並選路徑如 %USERPROFILE%\shots\bug.png → 文件寫入磁盤,輸入框保持無新附件。
示例四:畫完兩個紅框後點 ✓,再在輸入框輸入「這兩個字段順序反了」→ 一條帶圖與文字的消息。
適用場景與注意¶
適合需要在 DSH 對話裏快速貼圖、標清問題點或打碼敏感信息的 Windows 用戶。README 列出的邊界值得注意:
- 馬賽克只模糊底層截圖,不會蓋住已畫標註;橡皮擦會恢復光標下一切標註爲原截圖,不限於畫筆筆畫。
- 「重選」會清空標註回到重新拖框;保存後不會再把圖塞進輸入框。
- DPI 僅在 100% 縮放下驗證;更高縮放未實測。
- 鼠標層交互(按鈕、雙擊編輯等)無自動化測試,模型層有 23 項斷言自檢。