前言¶

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 仓库。