前言¶

DeepSeek Harness（DSH）的对话能力统一走 POST /v1/chat/completions，而 Agnes 的图像与视频模型分别在 POST /v1/images/generations 和 POST /v1/videos（再轮询 GET /v1/videos/{id}）上。这些端点不在 chat 协议里，单靠对话界面很难把「后台长跑、本地历史、分镜串片」做成稳定工作流。社区插件 dsh-agnes-media（维护者 zzsszz1122，分类：模型推理）在侧边栏提供「Agnes 创作室」面板：由宿主进程直接调用上游媒体 API，结果落盘，浏览器不接触 API Key；任务在宿主后台执行，关闭页面也不中断。

下面介绍它是什么、能做什么，以及如何安装与配置。

这是什么¶

dsh-agnes-media（npm 包名 dsh-agnes-media，当前版本 0.7.0，MIT 许可证）的定位是：在 DeepSeek Harness 侧边栏里使用 Agnes 生图、生视频，并提供可持久化的后台任务与生成历史。简介原文为：Agnes image and video models inside a DeepSeek Harness sidebar panel, with durable background tasks and history.

与同模型、同宿主的 LittleBeaverStudio/agnes-media 可并存：后者让模型在对话里调用 generate_image / generate_video 工具；本插件面向人在面板里操作，带短剧分镜、剧本导入、ffmpeg 合成与角色锁脸流程。要 AI 在对话里画图用前者；要排一集短剧并盯住同一张脸，用本插件。

核心功能¶

单条生图与生视频¶

左栏「Agnes 创作室」顶部有「生图」「生视频」页签。

生图支持 7 种尺寸（如 1024×1024、1280×720、2048×2048 等）；生视频支持分辨率 720P / 1080P，时长 4 / 5 / 6 / 8 / 10 / 12 秒。提示词最多 4000 字符，可填 seed 复现结果。

后台任务与历史¶

提交后立即返回任务 ID；宿主每 6 秒轮询上游进度，对 429 / 5xx 退避重试并在面板显示重试次数。切换面板、刷新或关标签页不影响任务；Host 重启后「排队中 / 生成中」的任务会恢复轮询。单任务最长等待 40 分钟（TASK_DEADLINE_MS），超时记失败。各界面可取消，宿主侧会停止轮询与退避。

历史缩略图常驻，可预览、下载（宿主支持 Range 拖动）、新窗口打开、复制链接、单条删除。本地保留最近 80 条，单个结果文件上限 512MB；数据在 <DSH 主目录>/agnes-media/。

画布¶

「画布」页签提供节点图：拖拽排版、滚轮缩放、空白处平移，自动保存。可从文件资源管理器直接拖入视频或图片作为素材节点；导入文件存于 projects/<pid>/assets/imports/。

节点连线仅用于可视化衔接关系；实际生成顺序由分镜表的镜头数组决定，改连线不会改变执行顺序。

短剧模式¶

含三个子页签：

1. 镜头：分镜表、提示词 / 时长 / 镜头语言、时间线总时长。
2. 角色：人物三视图（正 / 侧 / 背 / 额外）与锁脸状态。
3. 静帧审片：整集静帧网格，通过 / 打回 / 重生成。

支持粘贴纯文本剧本（含 第X集、EP、场…、1. 等标记），按规则拆成集 / 场 / 镜头草稿，不调用大模型。「一键生成」按镜头顺序串行执行，单并发、单项目互斥，可从任一镜续跑；单镜失败只标记该镜，不拖垮整条链路。已完成镜头可用 ffmpeg 归一化拼成一集 mp4（仅当每段都带音轨时才混音）。

长时长可选 5 / 10 / 15 / 20 / 25 / 30 秒（5 的倍数）；上游单次最多 12 秒，超出部分均分拆段，抽尾帧作下一段首帧，最后用 ffmpeg 拼成单文件。

人物一致性与首尾帧¶

三层手段（按优先级）：角色库公网 HTTPS 参考图 → mode: reference；本镜首帧 → mode: keyframe；否则 mode: text。可先静帧后视频，通过的静帧成为该镜首帧。链路启动前有门禁：要锁脸的镜头若无公网参考图、已批准静帧或上一镜尾帧，会拒绝启动并列出原因；可传 skipPreflight 绕过。

镜间衔接：上游完成后宿主用 ffmpeg 抽尾帧，下一镜以 keyframe 提交。需本机 ffmpeg（或 AGNES_FFMPEG / 插件 config.ffmpegPath）。

安装与启用¶

从插件市场安装（推荐）：DeepSeek Harness →「设置 → 插件市场」→ 搜索 dsh-agnes-media → 一键安装。

从 npm 安装：

dsh plugin add dsh-agnes-media

从 GitHub 安装（跟进最新提交）：

dsh plugin add github:zzsszz1122/dsh-agnes-media

桌面版请在应用内「设置 → 插件」里安装；CLI 在应用运行时不会改动桌面版的 profile。

安装后在「设置 → 插件」确认 dsh-agnes-media 已启用，左侧栏出现「Agnes 创作室」图标。若未出现，确认插件已启用；宿主代码变更需重启 DSH。

兼容性（README 与 package.json）：DeepSeek Harness ≥ 0.2.1-rc.3，Node.js ≥ 20，零运行时 npm 依赖；ffmpeg 缺失时不影响静帧与单条生成，但尾帧衔接与合成会提示「ffmpeg 未安装」。

配置¶

插件读取「设置 → 模型」里 agnes provider 的凭据（默认 apiKeyEnv: AGNES_API_KEY）。默认模型：

• 视频：agnes-video-2.5-flash
• 图像：agnes-image-2.5-flash

接口默认 https://api.agnes-ai.cn/v1。可在插件行 config 覆盖，例如：

- id: dsh-agnes-media
  config:
    baseURL: https://api.agnes-ai.cn/v1
    apiKeyEnv: AGNES_API_KEY
    videoModel: agnes-video-2.5-flash
    imageModel: agnes-image-2.5-flash
    ffmpegPath: '' # 可选；留空依次尝试 AGNES_FFMPEG 与 PATH

提示未配置 Key 时，先在「设置 → 模型」为 agnes 填好 AGNES_API_KEY。

典型用法¶

1. 安装并启用插件，配置 agnes provider 与 API Key。
2. 打开左侧「Agnes 创作室」→「生图」或「生视频」，填写提示词与参数，提交后在结果区与历史中查看进度与成品。
3. 做短剧：新建项目 →「短剧模式」导入剧本或手建镜头 →「角色」补三视图并填写公网 HTTPS 参考 URL（参考模式必需）→ 可选「静帧审片」再生成视频 →「一键生成」串镜 →「合成导出」得到 mp4。
4. 需要镜间连续时，确保 ffmpeg 可用；画布可拖入本地素材作节点，与分镜表并行使用。

宿主 HTTP API 均挂在 /agnes-media/api 前缀下，需已登录的 DSH Web 会话；面板 UI 已封装常见操作，扩展集成可参考仓库 README 中的路由表。

适用场景与注意¶

适合：在 DSH 里人工操控 Agnes 媒体模型、需要关页面仍继续生成、本地历史回看、短剧分镜与人物锁脸工作流的开发者或创作者。

注意：

• 插件在当前 DSH 宿主进程权限下运行，会直接请求上游 API 并读写本地 agnes-media/ 目录；安装前应查看 源码与 LICENSE，确认符合你的安全与合规要求。
• API Key 仅在宿主内解析；三视图与生成结果默认留本机，只有你填入的公网 URL 会随参考模式发给上游。
• 本插件非 Agnes 或 DeepSeek 官方产品；社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系。
• 修改 client.js 刷新页面即可；修改 index.js 或 lib/ 需重启 DSH。

结尾¶

dsh-agnes-media 把 Agnes 的生图、生视频端点接到 DSH 侧边栏，用宿主后台任务补齐 chat 协议覆盖不到的媒体工作流，并在短剧模式下把分镜、锁脸、静帧审核与 ffmpeg 合成串成可复现的本地流程。

• 插件目录页：https://www.skillhub.cn/plugins/zzsszz1122/dsh-agnes-media
• 源码与文档：https://github.com/zzsszz1122/dsh-agnes-media