前言¶

在 DSH（DeepSeek Harness）中發送截圖時，通常需要先圈出重點。由於編輯器中的待定圖片僅支持預覽，圈畫往往需要在其他應用中進行，處理完後再重新附加文件。這個插件將這一步驟直接移到了編輯器內部。

下面介紹 dsh-image-annotate 插件的功能、安裝方式與使用方法。

簡介¶

dsh-image-annotate 是一個 DSH web 插件，由 janewas 維護，採用 MIT 許可證。它的核心功能是：點擊待定圖片即可打開標註對話框，支持畫筆、方框、箭頭和可移動/調整大小的文字框工具，並將標註後的 PNG 作爲新附件插入，原圖片保持不變。

插件不重置 DSH 的 UI，最小化佔用空間，且無依賴、無配置文件。

安裝與啓用¶

安裝前請確保 DSH 版本爲 0.1.5-rc.1 或兼容版本。

使用官方推薦的 GitHub 方式安裝：

dsh plugin --profile web add github:janewas/dsh-image-annotate

安裝命令會將插件添加到配置文件中，插件會通過自身的 cordis.patch.yml 進行掛載。由於配置列表在啓動時讀取，安裝後請重啓 dsh web。

核心功能¶

該插件主要提供以下能力：

1. 點擊交互：點擊待定圖片的縮略圖，打開標註對話框，而非原本的預覽燈箱。
2. 繪圖工具：提供四種工具
   • 畫筆：自由繪製。
   • 方框：拖拽繪製邊框。
   • 箭頭：拖拽繪製箭頭。
   • 文字：拖拽創建文字框，點擊創建默認大小框。
3. 文字框特性：
   • 移動與調整大小：使用文字工具時，拖拽框體移動，拖拽 8 個手柄調整大小。文字會根據框的大小自動重排（自動換行），框體不會縮小到文字無法顯示的最小可讀尺寸。
   • 編輯與刪除：雙擊框內文字可修改（清空文字即刪除框），選中後按 Delete 鍵刪除。支持 Ctrl/Cmd+Z 撤銷移動、調整大小、修改文字或刪除操作。
   • 樣式：支持矩形、圓角、橢圓三種形狀，以及透明、底紋、實心三種填充方式，使用當前選定的顏色。
4. 樣式選項：提供 6 種顏色（紅、黃、綠、藍、白、黑）和 3 種線寬（細、中、粗）。
5. 操作控制：支持撤銷（按鈕或 Ctrl/Cmd+Z）、清除和關閉（Esc 或點擊背景）。
6. 結果輸出：點擊「插入到輸入框」後，標註後的 PNG 作爲新附件插入，原圖片保留。

使用步驟¶

操作流程如下：

1. 將圖片添加到編輯器（拖拽或使用回形針）。
2. 點擊圖片的縮略圖，打開標註編輯器，圖片以全尺寸顯示。
3. 選擇工具、顏色和線寬。如果是文字工具，拖拽創建框並輸入內容。
4. 點擊「插入到輸入框」。標註後的 PNG 會出現在附件欄末尾，原圖片依然存在。

工具交互說明¶

設置¶

進入 設置 → 圖片標註 頁面進行配置。設置會保存在瀏覽器的 localStorage 中（鍵名爲 dsh-image-annotate.settings.v1），僅對當前瀏覽器和源站有效。

主要配置項包括：

生態背景¶

DeepSeek Harness 的理念是「一切皆插件」。社區目錄（如 skillhub.cn）收錄了各類插件，與 DeepSeek 或幻方官方無直接從屬關係。本文僅介紹插件本身的功能與使用方式。