DeepSeek Harness 圖片多模態描述插件 (`sd1g1/dsh-image-describe`)

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在開發智能體或進行模型推理時，常遇到主模型僅支持純文本輸入、無法直接處理圖片的情況。sd1g1/dsh-image-describe 插件旨在解決這一痛點，它通過向模型注入 describe_image 工具，讓純文本模型具備“看圖”和描述的能力。

插件介紹¶

該插件由用戶 sd1g1 維護，採用 MIT 許可證。它是一個 DeepSeek Harness 宿主插件，主要功能是通過 describe_image 工具，讓不支持圖片輸入（純文本）的主模型支持圖片輸入。

核心功能¶

工具注入：提供 describe_image 工具，允許模型調用。
多輸入方式：支持 attachmentId（引用會話中的圖片）和本地文件路徑兩種輸入方式。
自動縮放：支持圖片自動縮放處理（autoResize）。
自動配置：首次啓動自動創建配置文件。

安裝與啓用¶

通過 DSH 的插件管理命令安裝。確保環境滿足依賴要求（Node >= 20）。

npx @deepseek-ai/dsh plugin --profile web add github:sd1g1/dsh-image-describe

配置¶

首次啓動插件會自動創建配置文件，路徑遵循 $DSH_HOME（通常爲 ~/.dsh/image-describe.json）。配置文件包含視覺模型的配置項。若不填寫，插件將處於休眠狀態。

默認配置模板如下：

{
  "vision": { "provider": "my-vision-provider", "model": "vision-model" },
  "prompt": "請詳細描述這張圖片的內容",
  "maxTokens": 1500,
  "image": { "autoResize": true }
}

配置項說明：
* vision.provider / vision.model：必填。留空則插件休眠，不影響正常請求。
* prompt：可選，默認爲圖片描述指令。
* maxTokens：可選，默認 1500。
* image.autoResize：可選，默認 true。開啓後會對圖片進行預處理。

典型用法¶

插件安裝並配置完成後，主模型即可調用 describe_image 工具。

1. 使用本地圖片路徑：

describe_image({ path: '/絕對路徑/圖片.png' })

2. 使用會話中的附件 ID：

describe_image({ attachment: 'attachmentId' })

注意事項與適用場景¶

權限檢查：插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
格式支持：支持 png、jpeg、webp、gif 格式的圖片。
失敗回退：處理失敗時會自動回退原圖，不影響基本看圖功能。
必填項：必須配置 vision.provider 和 vision.model 才能激活插件。

總結¶

sd1g1/dsh-image-describe 插件爲 DeepSeek Harness 提供了多模態描述能力，通過簡單的配置和調用方式，擴展了純文本模型的應用邊界。

插件目錄 | GitHub 倉庫