Agnes 图影生成 jiel521125/dsh-agnes-image-vedio

dsh-agnes-media

Agnes 图片与视频生成插件，用于 DeepSeek Harness（DSH）。

接入 Agnes AI 的 Image 2.1 Flash 和 Video V2.0 模型，在 DSH 对话页面提供一键生成图片/视频的能力。

功能

- 图片生成（agnes-image-2.1-flash）— 文生图，支持多种尺寸/宽高比
- 视频生成（agnes-video-v2.0）— 文生视频，异步轮询直到完成
- 对话页工具按钮 — 输入框左侧注入「✦ 生成」按钮，点击弹出表单
- Agent 工具调用 — 注册 3 个工具供 Agent 自动调用
- 双站点支持 — 国际站 apihub.agnes-ai.com / 国内站 api.agnes-ai.cn
- 凭据自动解析 — 从 DSH 模型注册表读取 API Key

安装

在 DSH profile 目录下
cd ~/.dsh/profiles/web
pnpm add dsh-agnes-media

或通过 junction 链接本地开发版：

Windows PowerShell (管理员) New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-agnes-media" -Target "E:\Work\Image"

然后在 profile 的 package.json 中添加 bundle 条目：

{
"dsh": {
"bundle": {
"plugins": ["dsh-agnes-media"]
}
}
}

配置

插件通过 cordis.patch.yml 提供默认配置，可在 DSH 设置页或 ~/.dsh/settings.yaml 中覆盖：

| 配置项 | 默认值 | 说明 |
| site | international | 站点选择：international / china |
| apiKey | _(从注册表解析)_ | Agnes API Key，留空则自动从 DSH 凭据读取 |
| imageBaseURL | https://apihub.agnes-ai.com/v1 | 图片生成 API 地址 |
| videoBaseURL | https://apihub.agnes-ai.com | 视频生成 API 地址 |
| requestTimeoutMs | 60000 | 单次请求超时（毫秒） |
| pollIntervalMs | 10000 | 视频任务轮询间隔（毫秒） |
| pollTimeoutMs | 300000 | 视频任务轮询超时（毫秒） |
| downloadDir | ~/Downloads/agnes-media | 生成文件下载目录 |

架构

┌─────────────────────────────────────────┐
│ Browser (client.js) │
│ ┌───────────────┐ ┌────────────────┐ │
│ │ GenerateButton │→ │ Modal Form │ │
│ │ (composer slot)│ │ (prompt/params)│ │
│ └───────────────┘ └───────┬────────┘ │
│ │ rpc.call │
└─────────────────────────────┼───────────┘
│ /agnes
┌─────────────────────────────┼───────────┐
│ Host (index.mjs) ▼ │
│ ┌──────────────────────────────────┐ │
│ │ /agnes RPC handler │ │
│ │ generateImage / generateVideo │ │
│ │ getVideoTask │ │
│ └──────────────┬───────────────────┘ │
│ │ │
│ ┌──────────────▼───────────────────┐ │
│ │ Agnes API Client │ │
│ │ POST /v1/images/generations │ │
│ │ POST /v1/videos │ │
│ │ GET /agnesapi?video_id=... │ │
│ └──────────────────────────────────┘ │
│ │
│ Tools: agnes_generate_image │
│ agnes_generate_video │
│ agnes_get_video_task │
└──────────────────────────────────────────┘

开发

安装依赖
pnpm install

类型检查
pnpm typecheck

构建（双产物：host ESM + client CJS）
pnpm build

项目结构

├── src/ # Host 侧（Node.js） │ ├── index.ts # 入口：工具注册 + RPC 通道 │ ├── config.ts # 配置解析 │ ├── types.ts # 类型定义 │ └── agnes/ │ ├── registry.ts # 凭据解析 + base URL │ ├── image.ts # 图片生成 │ ├── video.ts # 视频生成 + 轮询 │ ├── http.ts # HTTP 客户端 │ └── download.ts # 文件下载 ├── client/ # 浏览器侧 │ ├── index.ts # 入口：slot 注入 + locale │ ├── GenerateButton.tsx # UI 组件 │ └── locales.ts # 中英文 ├── cordis.patch.yml # DSH 配置补丁 ├── tsdown.config.ts # 双构建配置 └── package.json

API 参考

图片生成

POST https://apihub.agnes-ai.com/v1/images/generations

| 参数 | 类型 | 必填 | 说明 |
| model | string | 是 | agnes-image-2.1-flash |
| prompt | string | 是 | 提示词 |
| size | string | 是 | 尺寸，如 1024x1024 |
| ratio | string | 否 | 宽高比，如 1:1、16:9 |
| n | number | 否 | 生成数量 |
| image | string[] | 否 | 图生图输入 |
| return_base64 | boolean | 否 | 返回 Base64 |

视频生成

POST https://apihub.agnes-ai.com/v1/videos
GET https://apihub.agnes-ai.com/agnesapi?video_id=<ID>

| 参数 | 类型 | 必填 | 说明 |
| model | string | 是 | agnes-video-v2.0 |
| prompt | string | 是 | 提示词 |
| width | number | 否 | 宽度 |
| height | number | 否 | 高度 |
| num_frames | number | 否 | 帧数（8n+1） |
| frame_rate | number | 否 | 帧率 |

技术栈

- Cordis — 微内核框架
- tsdown — 双产物构建
- React 18 — 客户端 UI
- TypeScript 5.7

License

MIT

Author

Zhou Long (Tianshu Intelligent / 天枢智能)

- WeChat: longling1031
- Email: 1033085514@qq.com
- Location: Pinghu, Jiaxing, Zhejiang, China
- Blog: https://www.zhihu.com/people/tianshu_cn