DeepSeek Harness 插件：免費多模態三件套（零 Key 文生圖、視頻理解與文生視頻）

前言¶

DeepSeek Harness（DSH）通過插件擴展能力。在多模態推理場景中，API Key 和費用往往是阻礙。dsh-free-media 插件提供了一套免費方案：文生圖、視頻理解和文生視頻/圖生視頻。

該插件由 bdydgz114514 維護，採用 MIT 許可證，包含三個工具和一個 skill。

核心功能¶

插件提供三個主要工具：

• free_image_generate：文生圖。走 Pollinations 免費端點，無需 API Key。
• video_extract_frames：視頻理解。使用 ffmpeg 對視頻進行抽幀，無需外部 API Key。
• free_video_generate：文生視頻 / 圖生視頻。支持智譜 cogvideox-flash 和 Agnes agnes-video-v2.0，需要註冊免費 Key。

此外，還附帶一份 free-media skill，用於需要組合、自定義參數或跑管道的場景。

安裝與啓用¶

在命令行中執行以下命令安裝：

dsh plugin --profile <你的profile> add dsh-free-media

安裝完成後需重啓 DSH 並新開一個會話，工具集在會話創建時快照。

桌面應用用戶需通過圖形界面操作：設置 → 內置插件 → 添加插件，因爲命令行會報錯提示 profile "desktop" 被應用獨佔管理。

環境要求¶

• Node.js：版本需 ≥ 18。
• FFmpeg：ffmpeg / ffprobe 需在 PATH 中（僅影響視頻抽幀工具）。可通過環境變量 FFMPEG_PATH / FFPROBE_PATH 覆蓋。
• Keys：視頻生成工具需要免費註冊的 API Key。

配置與使用¶

Keys 配置¶

視頻生成需要提供 Key。支持三種配置方式，優先級從高到低：

1. 工具參數 key / 腳本 --key。
2. 環境變量 ZHIPU_API_KEY 或 AGNES_API_KEY。
3. 文件 ~/.dsh/free-media-keys.json，格式爲 {"zhipu":"xxx","agnes":"yyy"}。

提示詞處理¶

• 文生圖：中文提示詞會自動免費翻譯成英文（通過 text.pollinations.ai），因爲免費出圖端點對中文支持不佳。
• 視頻生成：支持文生視頻和圖生視頻。

侷限與注意事項¶

該插件使用第三方免費服務，存在以下限制：

• 出圖限制：
  • 靜默降採樣：免費檔有像素上限（約 0.59 MP）。例如請求 1024×1024 會得到 768×768。返回值中的 size 是請求值，actualSize 纔是真實值。
  • 計數不可靠：無法準確統計畫面中的人物或物體數量。
• 視頻理解限制：
  • 無音軌：抽幀不含音軌，無法通過畫面識別臺詞。
  • 丟時序：幀是離散快照，幀間的運動與短暫事件會丟失。
• 視頻生成限制：
  • 無 SLA：免費檔不保證可用性。
  • 限流：出圖可能出現 402/429 錯誤，腳本會自動退避。
  • 超時處理：視頻生成超時會給出任務 ID，需稍後查詢，不要盲目重試。
• 技術限制：
  • 無 SLA：免費 API 隨時可能調整策略。

結尾¶

dsh-free-media 適合需要低成本嘗試多模態功能的場景。使用前請檢查源碼與許可證，並注意數據隱私（提示詞會發送給第三方服務商）。

• 目錄頁：https://www.skillhub.cn/plugins/bdydgz114514/dsh-free-media
• GitHub：https://github.com/bdydgz114514/dsh-free-media