前言¶

DeepSeek Harness (DSH) 採用插件化架構，這允許開發者將特定能力以模塊形式注入系統。在處理需要視覺素材或動態內容的任務時，Agent 往往需要依賴外部網站。dsh-agnes 插件將 Agnes AI 的圖像與視頻生成接口集成到 DSH 中，讓 Agent 能夠通過標準工具直接調用免費的生成能力，減少對外部服務的依賴。

插件簡介¶

這是一個由 chaoliu615 開發的聯網工具插件。它通過 DSH 工具系統暴露 agnes_image_generate 和 agnes_video_generate 兩個核心工具，並在設置頁提供「Agnes」標籤頁以管理默認參數。插件遵循 MIT 許可證，兼容 Node.js ≥ 20 的運行環境。

核心功能¶

插件主要提供兩類工具與一個配置界面：

• 圖像生成工具 (agnes_image_generate)：支持文生圖、圖生圖以及多圖合成。參數包括提示詞、尺寸檔位、寬高比以及可選的參考圖。
• 視頻生成工具 (agnes_video_generate)：支持文生視頻、圖生視頻和關鍵幀動畫。該工具採用異步任務流程，返回視頻 ID 後需進行輪詢以獲取最終結果。總預算爲 900 秒。
• 設置面板：DSH 設置頁會出現「Agnes」標籤頁，支持切換模型（如 agnes-image-2.1-flash、agnes-video-v2.0 等），並調整默認的畫幅、分辨率、時長等參數。

安裝與啓用¶

安裝該插件需要指定 web profile。使用以下命令即可完成安裝：

dsh plugin --profile web add dsh-agnes

典型用法¶

插件安裝後，Agent 需要先在 DSH 憑據中配置 AGNES_API_KEY，然後即可調用對應工具。

1. 文生圖：Agent 調用 agnes_image_generate，傳入描述主體、場景、風格等參數。
2. 文生視頻：Agent 調用 agnes_video_generate，系統會創建異步任務並返回 video_id。Agent 需定期查詢任務狀態，直到獲取到視頻 URL。
3. 參數調整：在 DSH 設置頁的「Agnes」標籤頁中，Agent 或用戶可以配置默認參數。修改保存後，配置會持久化到 ~/.dsh/settings.yaml，後續工具調用將自動讀取這些默認值。

適用場景與注意事項¶

• 適用場景：需要爲 Agent 配置多模態生成能力的開發者；希望擺脫對第三方繪圖/視頻網站依賴的用戶。
• 運行環境：確保環境中的 Node.js 版本 ≥ 20。
• 視頻任務限制：視頻生成採用異步流程，總預算爲 900 秒。若任務失敗，需攜帶 video_id 稍後重查。
• 瀏覽器側加載：設置頁的「Agnes」標籤頁由瀏覽器側提供。Host 只在掃描到 dsh.client 聲明時纔會將瀏覽器側編入啓動圖。對於已安裝的舊版本，追加瀏覽器側後需要重啓一次 web profile 才能看到標籤頁。

總結¶

dsh-agnes 通過將 Agnes AI 的能力接入 DSH 工具鏈，爲智能體提供了直接獲取圖像和視頻素材的能力。通過設置頁的參數持久化與工具調用的結合，Agent 可以根據任務需求靈活調整生成策略。更多細節與源碼，請參考插件目錄或 GitHub 倉庫。