Agnes 图影工坊 lingxinsuixing/dsh-agnes

@lingxinsuixing/dsh-agnes

给 DeepSeek Harness 用的 Agnes AI 插件：图片生成、视频生成是主要功能，另有一个可关闭的图片识别。

工具结果只有文字。 生成的图片与视频会下载到本地目录，工具返回文件路径和 URL，图片字节不会进对话。

安装

~~~sh
dsh plugin add github:lingxinsuixing/dsh-agnes

（和插件市场页面给出的命令一致。本插件没有构建步骤，安装前不需要额外授权。）

配置

在 Web 界面打开 插件 → @lingxinsuixing/dsh-agnes 粘贴 Agnes API Key，或者用 DSH 凭据库：

~~~yaml

~/.dsh/credentials.yaml（或 Web 界面的凭据库）

AGNES_API_KEY: your-key

取值顺序：插件配置（config.apiKey）→ 凭据库里的 AGNES_API_KEY → 环境变量 AGNES_API_KEY。

在配置页填的 Key 会以明文写进你自己的 profile（config.apiKey）。它不会被写进插件包，插件包本身不含任何凭据。

工具

| 工具 | 作用 | 主要参数 |
| agnes_image_generate（主要） | 文生图 / 图生图 / 多图合成 | prompt、size、ratio、references、saveTo |
| agnes_video_generate（主要） | 文生视频 / 首尾帧 / 参考生成 | prompt、mode、seconds、size、aspectRatio、images、saveTo |
| agnes_image_recognize（可选） | 看图并回答问题 | image（本地路径或 http(s) URL）、prompt |

工具都只返回文字：路径、URL 和一句摘要，不往对话里塞二进制。

关于 size：接口会把 1920x1080 这类精确尺寸映射到最近档位，所以结果里的 size 是落盘文件的真实像素，不一定等于你请求的值。

模型

| 能力 | 默认模型 | 要不要改 |
| 识图 | agnes-3.0-flash | 不用——识图走带视觉的对话模型，默认这个支持多模态且免费 |
| 生图 | agnes-image-2.5-flash | 不用——档位、宽高比、参考图全都支持 |
| 生视频 | agnes-video-2.5 | 想用免费档就要改——agnes-video-2.5-flash 免费，但只出 720P，且不能带参考视频 |

三个都能在配置页改（插件 → 本包 → 页 → 「模型」）。生图全系当前免费。
模型清单与价格：https://www.agnes-ai.cn/zh-Hans/docs/overview

样例

下面都是用本插件的 agnes_image_generate 生成的真实产物（2K，16:9）：

| 窗台上熟睡的白猫 | 晨雾湖边亮着灯的木屋 |
| 樱花树下的小径 | 玻璃温室里的藤椅与绿植 |
| 黄昏海边的白色灯塔 | 雨夜窗边的书桌与台灯 |
| 林间溪流与穿过树叶的光束 | 薰衣草田边的复古自行车 |
| 阳台藤椅上睡着的橘猫 | 星夜湖面上停泊的小木船 |

可选功能：图片识别

识图是可选项。在插件配置里设 enableRecognition: false，agnes_image_recognize 就完全不注册，只留生图与生视频两个主要功能。工具是在插件加载时注册的，所以关掉它要重启一次 DSH 才生效。

声明：识图功能不需要改 provider 就能用——它跟 DSH 用 openai-responses 还是 openai-completions 无关。
只有 DSH 原生的 read_image 要在主会话里看图时，provider 才必须改成 openai-completions；不改就别给模型勾图片输入能力，否则一次 read_image 就会把整个会话钉死（400 不重试 + 每轮重建全部历史）。

如果你的 provider 用的是 api: openai-completions，模型条目里还要声明 reasoningEfforts。
不声明的话 DSH 不会发 reasoning_effort，网关也就不会返回 reasoning_content，模型会把整条推理过程直接写进正文——思考链暴露到会话。补上就正常了。

不要在主会话里用 read_image 看图

模型一旦勾上「支持图片」，DSH 自带的 read_image 就会把图片内容块塞进主会话；而 Agnes 网关的 /v1/responses 端点不认识 input_image（responses→chat 桥接时兜底成 unknown），下一轮直接 400。
400 不重试，且每轮请求都会从会话日志重建全部历史——一条坏消息就能钉死整个会话，只能新开。
要看图请用 agnes_image_recognize：图片发给 Agnes 视觉模型，回会话的只有文字。

产物放在哪

生成的媒体文件写入 outputDir 指定的目录（默认：DSH 主目录下的 media/，即 $DSH_HOME/media；没设 $DSH_HOME 就用 ~/.dsh/media），每次调用会返回写入的绝对路径。
也可以在插件页直接改（插件 → 本包 → 页 → 「产物目录与读取范围」），同页还能设 allowedReadRoots——识图允许读取的目录（留空 = 不限制）。

有免费模型可用：生图全系当前免费，视频有免费档（agnes-video-2.5-flash，仅 720P）。
模型清单与价格：https://www.agnes-ai.cn/zh-Hans/docs/overview

saveTo 必须指向已存在的目录：插件不会在任意路径自动建目录，文件名也由插件生成，不会覆盖你已有的文件。

识图要读的本地图片可以用 allowedReadRoots（绝对路径目录列表）限制；留空 = 任何可读的图片都接受。

环境要求

- DeepSeek Harness，@deepseek-ai/schemastery >=3.18.1
- 一把 Agnes API Key
- Agnes 生图目前免费；生视频由 Agnes 按生成秒数计费（-flash 变体目前限 720P）

许可

MIT