dsh-agnes-create
zxygithub/dsh-agnes-create
Sidebar panel for Agnes image and video generation: for images, plain text-to-image or image-to-image and multi-image composition from up to eight reference images — chosen from local files or from results already in the panel — at 1K-4K across eight aspect ratios; for video, agnes-video-2.5-flash at 720p, 4-12 seconds, submitted as an async task and polled with a live percentage. See the result inline as an image or a seekable video, revisit the last eight generations, and repoint the API-key file or output directory from the panel settings without editing code or restarting. Polling backs off on the query endpoint 429 rate limit instead of failing the task, and a 503 queue-full submit retries automatically. Needs an Agnes AI API key saved in a local file (default ~/.agnes-key.txt).
インストール
dsh plugin --profile web add github:zxygithub/dsh-agnes-createREADME
dsh-agnes-create
在 DeepSeek Harness（dsh）里直接出图和出视频的侧边栏插件。侧边栏点一下「Agnes创作」，输入提示词就能出片，结果自动保存到本地并可在面板里回看。
仓库：https://github.com/zxygithub/dsh-agnes-create · npm：
dsh-agnes-create
- 出图：
agnes-image-2.5-flash— 支持1K/2K/3K/4K与 8 种宽高比 - 出视频：
agnes-video-2.5-flash— 720P，4–12 秒，异步任务带百分比进度 - Key 文件位置、输出目录都能在界面里改，改完即时生效
- 最近 8 条生成结果可回看，一键清空界面（不删文件）
安装
在插件市场里搜 dsh-agnes-create 安装，或命令行：
dsh plugin --profile <profile> add dsh-agnes-create
装好后面板出现在左侧边栏，标签为 Agnes创作。
准备 API Key
插件从文件读取 Key，不接受把 Key 写在配置里或代码里。默认路径：
~/.agnes-key.txt
文件里只放 Key 本身，不要带 Bearer 前缀、不要加引号：
sk-xxxxxxxxxxxxxxxxxxxxxxxx
Key 从 Agnes AI 平台 获取。端点默认走中国站 https://api.agnes-ai.cn/v1。
配置
面板底部的「设置」卡片可以改两项，保存后立即生效（不用重启）：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| Key 文件路径 | ~/.agnes-key.txt | 支持 ~/ 开头或绝对路径 |
| 输出目录 | ~/Desktop/Agnes出图 | 图片和视频都存这里，不存在会自动创建 |
- 输入框留空并保存 = 回退到默认值
- 配置存在
~/.dsh/agnes-image/config.json - 优先级：显式传参 > 已保存配置 > 环境变量（
AGNES_KEY_FILE/AGNES_OUT_DIR）> 默认值 - 配置文件损坏时会静默回退默认值，不会让插件加载失败
用法
- 侧边栏点 Agnes创作
- 顶部选择 图片 或 视频
- 输入提示词，
Cmd/Ctrl + Enter或点按钮生成 - 结果直接显示在面板里；图片用
<img>、视频用<video>播放（支持拖动进度条）
提示词建议按「主体 + 场景 + 动作/镜头 + 光线 + 风格 + 构图」组织，例如：
一只胖乎乎的橘色虎斑猫坐在木质窗台上，午后暖阳斜射，窗外虚化的街景，浅景深，写实摄影，中景构图，高细节
参数范围：
| 类型 | 尺寸 | 宽高比 | 其它 |
|---|---|---|---|
| 图片 | 1K 2K 3K 4K | 1:1 3:4 4:3 16:9 9:16 2:3 3:2 21:9 | 可选 1–8 张参考图（图生图 / 多图合成） |
| 视频 | 固定 720P | 21:9 16:9 4:3 1:1 3:4 9:16 | 时长 4–12 秒 |
图生图 / 多图合成
「参考图」区有两种来源，可以混着加，最多 8 张：
- ＋ 本地图片 —— 从磁盘选一个或多个文件（PNG / JPEG / WebP / GIF）
- ＋ 生成结果 —— 从下方「最近生成」里挑一张（视频不能当参考图）
加好之后提示词写「想怎么改」，按钮会变成 图生图：
| 参考图数量 | 实际行为 |
|---|---|
| 0 张 | 纯文生图 |
| 1 张 | 图生图（按参考图重绘 / 改风格 / 换背景） |
| 2–8 张 | 多图合成（把多张图的元素 / 配色融合） |
实现细节：
- 图片在浏览器侧先下采样到长边 1280 再编码成 data URI（PNG 优先保留透明通道，超过 800 KB 自动转 JPEG），所以一张 4K 原图发出的请求也只有几百 KB
- 参考图走接口的
extra_body.image；多图就是往这个数组里放多条 - 校验在前端和内核各做一次：只接受
http(s)或data:image/…;base64，超过 8 张、空串、非图片类型都会直接报错，不会把脏数据发给上游 - 本地文件路径不会被读取或上传到别处：文件内容只在内存里转成 base64 随请求发给 Agnes
关于费用
插件的费用由 Agnes AI 账号结算，本插件不涉及任何计费。
- 图片：1K 刊例价约
$0.010/张，2K 约$0.018/张 - 视频：
$0.025/秒（4 秒约$0.10）
官方文档标注当前为体验价（$0）。具体以平台公告为准。
已知限制
- 视频为异步任务：提交后轮询，通常需要 1–4 分钟；队列繁忙时提交会返回
503，插件会自动重试 - 查询接口有频率限制，触发
429时面板会显示「限流重试中…」并退避，任务不会因此失败 - 视频只支持文生视频：暂无首尾帧、参考音频与视频输入（Flash 版接口本身不支持这些）
- 参考图最多 8 张；单张在浏览器侧压到长边 1280，细节极多的小字参考图重绘后可能看不清
- 生成结果只保留最近 8 条（本次会话内），刷新页面后历史清空；文件本身在输出目录里不会丢
开发
包内是纯 ESM，没有构建步骤：lib/client.js 是手写的客户端 bundle（window.__ModuleLoader__.load 包装），宿主侧 lib/index.js 注册 HTTP 路由，lib/agnes.js 是与命令行共用的内核。
lib/
├── agnes.js 内核：请求构造、视频任务轮询、落盘、配置解析
├── index.js 宿主半：/agnes/health /agnes/config /agnes/generate /agnes/video /agnes/media
└── client.js 客户端半：侧边栏入口 + 面板 UI
cordis.patch.yml 把插件行插入 profile
改动后无需构建，重载窗口即可生效；宿主路由的改动需要重启应用。
License
MIT