DeepSeek Harness 插件：dsh-image-uckkk（圖片處理）

DSH 的設計理念是「一切皆插件」。在開發智能體時，經常遇到需要讀取圖片尺寸、生成縮略圖或轉換圖片格式（如 PNG 轉 WebP）的需求。手動調用系統 ffmpeg 或在 Node 環境中配置依賴較爲繁瑣。dsh-image-uckkk 插件提供了封裝好的圖片處理能力。

插件定位¶

這是一個純 Node 實現的插件，基於內置的 ffmpeg 二進制，支持跨平臺。插件由 uckkk 維護（作者 istone ad571@qq.com），旨在解決智能體流程中的基礎圖片處理問題。

核心功能¶

插件提供了兩個主要工具：

• image_info：讀取圖片的寬×高與格式。
• resize_image：縮放圖片（支持等比縮放或指定寬度）並轉換格式（支持 jpg/png/webp）。

安裝與啓用¶

首先執行官方安裝命令：

dsh plugin add dsh-image-uckkk

安裝完成後，需要在項目根目錄的 package.json 文件中進行配置。在 dsh.profile.bundles 字段中添加 "dsh-image-uckkk"：

{
  "dsh.profile.bundles": [
    "dsh-image-uckkk"
  ]
}

該插件依賴以下環境：
* @deepseek-ai/cordis: ^4.0.1
* @deepseek-ai/dsh-tools: >=0.1.0-rc.6

典型用法¶

以下是一個將圖片縮放並轉換格式的示例。假設需要將 hero.png 縮放爲 800 像素寬，並輸出爲 hero.webp 格式：

調用 resize_image 接口：

resize_image(file="hero.png", width=800, outFile="hero.webp")

適用場景與注意事項¶

• 適用場景：適用於需要處理圖片元數據（尺寸、格式）或對圖片進行縮放、格式轉換的智能體場景。
• 運行權限：插件以當前 DSH 進程的權限運行，請確保智能體有足夠的權限讀取源文件和寫入輸出文件。
• 安全與合規：安裝前建議檢查源碼與許可證（MIT）。插件依賴 @ffmpeg-installer/ffmpeg，會自動下載對應的二進制文件。

總結¶

該插件通過封裝 ffmpeg，簡化了 DSH 智能體中常見的圖片處理任務。更多配置細節與源碼可參考插件目錄頁或GitHub 倉庫。