dsh-agnes-tools
将 Agnes AI 图像和视频生成功能作为原生 DeepSeek Harness 工具，并支持可恢复的长视频任务。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zuihouye/dsh-agnes-tools#d8b00cc76d0b8c0ef378076c3c68b756a28ba22bAgnes Tools 以 dsh-agnes-tools 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Agnes AI image & video generation as native DeepSeek Harness tools.
agnes_image · agnes_edit_image · agnes_video · agnes_video_status · agnes_models
A small, tool-only plugin: it adds five tools to the agent and nothing else — no UI panel, no settings page, no runtime dependencies beyond the Schemastery peer DSH already ships.
Five Agnes plugins already exist, so here is the honest difference:
agnes_video submits, polls, and downloads — but when the
in-call wait runs out it returns the video_id instead of losing the job. agnes_video_status
picks it up later and downloads the mp4. On a queue that is regularly full
(503 video_queue_full), that is the difference between a lost render and a finished one.agnes_models lists the models your key can actually reach, so you can tell a bad key
from a bad model name in one call.503/429, 6 s polling to stay under 20 RPM,
and tolerance for the ~20 s window after submission where a status query wrongly reports 404.From the DSH plugin market, once listed — then restart dsh web.
Add the package to your web profile and register it as a bundle:
// $DSH_HOME/profiles/web/package.json
{
"dependencies": {
"dsh-agnes-tools": "file:/path/to/dsh-agnes-tools" // or: "github:zuihouye/dsh-agnes-tools"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-agnes-tools"]
}
}
}
cd "$DSH_HOME/profiles/web" && pnpm install
Then restart dsh web. Host-side plugins are loaded at startup — there is no hot reload.
Two traps worth knowing:
dsh plugin --profile web installcan answer "Already up to date" without installing anything, so runpnpm installin the profile yourself. And the hoisted linker copiesfile:dependencies, so re-runpnpm installafter editing the source.
cordis.patch.yml holds the defaults; override any key in your profile's
cordis.patch.yml or plugin settings.
| Key | Default | Notes |
|---|---|---|
apiKeyRef | AGNES_API_KEY | Name of the DSH credential holding your key. Recommended. |
apiKey | (empty) | Inline key. Takes precedence over apiKeyRef. Not recommended. |
baseURL | https://api.agnes-ai.cn/v1 | Mainland endpoint. International: https://apihub.agnes-ai.com/v1. |
imageModel | agnes-image-2.5-flash | |
videoModel | agnes-video-2.5-flash | |
outputDir | agnes-output | Absolute, or relative to the dsh process working directory. |
pollTimeoutMs | 300000 | How long agnes_video waits inside a single tool call. |
pollIntervalMs | 6000 | Do not lower it: the free tier allows 20 requests/minute. |
The key is resolved in this order: apiKey → the DSH credential named by apiKeyRef →
process.env[apiKeyRef].
| Tool | Required | Optional |
|---|---|---|
agnes_image | prompt | ratio (1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9), size (1K/2K/3K/4K), save_path |
agnes_edit_image | prompt, images | ratio, size, save_path — images accepts local absolute paths, public URLs, or data URIs |
agnes_video | prompt | seconds ("4"–"12", default "5"), aspect_ratio, mode (text/keyframe/reference), first_frame, last_frame, images (≤5), save_path |
agnes_video_status | video_id | save_path |
agnes_models | — | — |
Files land in outputDir as 20261018-015926-jvic-agnes-video.mp4.
Generated images are also attached to the reply when the host supports attachments.
size is a tier, not a pixel size. Agnes takes 1K/2K/3K/4K plus ratio — not 1024x768.storage.googleapis.com, which is unreachable from mainland China. The plugin always
asks for base64 instead.503 video_queue_full. Retried with backoff (up to 6
attempts, 8 s → 30 s)."720P"; the real pixel size follows aspect_ratio
(16:9 → 1280x704).npm install && npm test # loads the plugin with a mock context and checks every tool
Add node_modules to your profile and point dsh-agnes-tools at your checkout to iterate.
MIT
把 Agnes AI 的生图 / 生视频接成 DeepSeek Harness 的原生工具，一共 5 个， 纯工具型：没有悬浮面板、没有设置页，除 DSH 自带的 Schemastery 外没有运行时依赖。
Agnes 生图生视频的插件市面上已经有 5 个，所以这里只说真实差异：
agnes_video 会一次调用内提交 + 轮询 + 下载；但等待超时后它
返回 video_id 而不是把任务丢掉，之后用 agnes_video_status 接着查、完成后自动下载 mp4。
视频队列经常满（503 video_queue_full），这条差异决定了你是白等一场还是拿到成片。agnes_models 列出当前 Key 真能访问的模型，一次调用区分「Key 不对」还是「模型名不对」。503/429 退避重试、6 秒轮询卡在 20 RPM 以内、
容忍提交后约 20 秒内状态查询误报 404。插件市场上架后可直接安装，装完重启 dsh web。
在 web profile 里登记依赖和 bundle：
// $DSH_HOME/profiles/web/package.json
{
"dependencies": {
"dsh-agnes-tools": "file:/你的路径/dsh-agnes-tools" // 或 "github:zuihouye/dsh-agnes-tools"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-agnes-tools"]
}
}
}
cd "$DSH_HOME/profiles/web" && pnpm install
然后重启 dsh web。host 侧插件在启动时装载，没有热加载。
两个坑：①
dsh plugin --profile web install可能回一句 “Already up to date” 却什么也没装， 直接进 profile 目录跑pnpm install更可靠；② hoisted linker 下file:依赖是复制不是软链， 改完源码要重跑pnpm install。
cordis.patch.yml 里写的是默认值，可在 profile 的 cordis.patch.yml 或插件设置里覆盖。
| 键 | 默认 | 说明 |
|---|---|---|
apiKeyRef | AGNES_API_KEY | DSH 凭据里的引用名，推荐 |
apiKey | 空 | 直接写 Key，优先级高于 apiKeyRef，不建议 |
baseURL | https://api.agnes-ai.cn/v1 | 国内节点；国际站是 https://apihub.agnes-ai.com/v1 |
imageModel | agnes-image-2.5-flash | |
videoModel | agnes-video-2.5-flash | |
outputDir | agnes-output | 绝对路径，或相对 dsh 进程的 cwd |
pollTimeoutMs | 300000 | 单次工具调用内最长等待 |
pollIntervalMs | 6000 | 别调小：免费 Key 只有 20 RPM |
Key 的解析顺序：apiKey → apiKeyRef 指向的 DSH 凭据 → process.env[apiKeyRef]。
| 工具 | 必填 | 选填 |
|---|---|---|
agnes_image | prompt | ratio（1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 3:2 / 2:3 / 21:9）、size（1K/2K/3K/4K）、save_path |
agnes_edit_image | prompt、images | ratio、size、save_path；images 支持本地绝对路径、公网 URL、data URI，可多张 |
agnes_video | prompt | seconds（"4"–"12"，默认 "5"）、aspect_ratio、mode（text/keyframe/reference）、first_frame、last_frame、images（≤5）、save_path |
agnes_video_status | video_id | save_path |
agnes_models | — | — |
产物落在 outputDir，文件名形如 20261018-015926-jvic-agnes-video.mp4；生成的图片在宿主支持时会一并作为附件回复。
size 是档位不是像素：Agnes 收 1K/2K/3K/4K + ratio，不是 1024x768。storage.googleapis.com（国内不通），
插件一律请求 base64，不依赖那个域名。503 video_queue_full）：内置退避重试，最多 6 次，8 秒 → 30 秒递增。"720P"，实际像素由 aspect_ratio 决定（16:9 → 1280x704）。npm install && npm test # 用 mock context 加载插件，逐个校验注册出来的工具
MIT