前言¶
DeepSeek Harness（DSH）通過插件機制擴展能力。在智能體開發中，讓對話直接產出圖片或視頻，需要對接專門的圖像/視頻生成 API。手動處理 API 調用和結果落盤較爲繁瑣。本文介紹的 dsh-jumeng-image-video-tool 插件對接了聚夢 AI，將這一流程標準化。
是什麼¶
這是一個 DeepSeek Harness 插件，由用戶 lkw2731938298 維護。它位於“模型推理”分類下。核心價值在於在對話中直接調用聚夢 AI 生成圖片或視頻，並將結果自動落盤到本地，同時返回遠程訪問鏈接。
核心功能¶
該插件提供以下工具接口：
list_models：列出可用模型（image / video）。upload_file：上傳本地圖片 / 視頻，換取臨時參考 URL。generate_image：文生圖 / 圖生圖；落盤 + URL。generate_video：文生視頻 / 圖生視頻；輪詢完成後落盤 + URL。
安裝與啓用¶
執行以下命令安裝插件：
dsh plugin --profile web add https://github.com/lkw2731938298/jumeng-image-video-tool.git
安裝後，在 Web UI 中刷新或重啓以使插件生效。
配置與使用¶
配置 API 密鑰¶
- 打開 Web UI。
- 進入 設置 → 插件 → 插件配置。
- 展開 聚夢媒體。
- 粘貼 API 密鑰並保存（憑據寫入數據庫，而非明文文件）。
也可以設置環境變量 JUMENG_API_KEY。
基礎配置項¶
apiKey/apiKeyEnv：認證方式。baseUrl：默認https://www.jumengai.com/v1（國際站爲https://www.jumai.ai/v1）。imageModel/videoModel：默認模型。outputDir：默認./outputs。
典型用法¶
在對話中直接輸入指令：
- 「用聚夢列一下生圖模型」
- 「生成一張賽博城市夜景」
- 「用這張圖生成一段 5 秒豎屏視頻」
注意事項¶
- 文件限制：圖片（JPEG/PNG/GIF/WEBP）最大 10MB，視頻（MP4/MOV/WebM）最大 100MB。
- 時效性：上傳得到的 URL 約 1 小時後失效；同一密鑰每小時最多 50 個文件。
- 權限與安全：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
- 素材複用：若需多次複用同一素材，建議先顯式調用
upload_file獲取 URL，再傳給生成接口。
小結¶
該插件簡化了在 DeepSeek Harness 中接入聚夢 AI 的流程。完整配置與源碼可在 GitHub 查看。
