前言¶
DeepSeek Harness（DSH）通过插件体系扩展功能。在聊天界面生成图片或视频，通常需要切出上下文或编写复杂指令。dsh-media-studio 插件将媒体生成能力直接接入对话流，通过后台任务和内联画廊，让模型在会话中直接输出结果。
安装与启用¶
运行环境要求：
* DeepSeek Harness 0.2.0-rc.2
* Node.js >= 22.19.0
- 打开 DSH 的 插件 页面。
- 点击右上角 「+ 添加插件」。
- 输入 GitHub 地址：
https://github.com/1497105876/dsh-media-studio
安装并启用后，插件详情页会出现设置卡片。
核心功能¶
- 文生图 / 图生图：支持本地路径、HTTPS URL、Data URI 作为参考图。
- 文生视频：支持文本生成与首尾帧（keyframe）、参考图模式。
- 发送本地媒体：将已有图片或视频文件通过画廊或文件卡片形式发送到会话。
- 斜杠命令：提供
/image和/video命令。 - 后台生成：默认使用
ctx.jobs后台任务，立即返回句柄，完成后自动推送。 - 富渲染：工具行和命令行支持内联画廊与视频播放器，支持下载、灯箱查看及系统默认应用打开。
- 自动保存：生成结果默认写入
~/.dsh/media-studio。 - 凭据安全：API Key 通过环境变量或凭据卡片管理，不写入配置文件。
- 设置卡片：插件详情页内的官方样式配置卡片，支持模型选择与参数设置。
配置与凭据¶
模型配置¶
默认内置 Agnes（有免费额度，支持文生图、图生图、文生视频）。其他服务商（如 OpenAI、Gemini、硅基流动、阿里百炼）通过设置卡片选择，支持自定义 baseURL + model。
凭据管理¶
每个模型条目通过 apiKeyEnv 引用一个环境变量名，插件运行时解析。例如使用 Agnes：
export AGNES_API_KEY=sk-...
或直接在插件详情页的设置卡片中填入 Key，Key 保存至 dsh 凭据库。
输出目录¶
生成结果默认保存至 ~/.dsh/media-studio（~ 展开为用户主目录）。
典型用法¶
斜杠命令¶
/image <提示词>：后台生成，完成后推送结果。/image --wait <提示词>：同步等待，在命令卡片内联展示。/video <提示词>：后台生成视频（通常几分钟）。/video --wait <提示词>：同步等待，卡片内联播放。
工具调用¶
插件向模型暴露三个工具：
* generate_image：必填 prompt，可选 model、resolution（1K–4K）、aspect_ratio、reference_images。
* generate_video：必填 prompt，可选 model、seconds（4–12）、size（720P–2K）、mode（text / keyframe / reference）。
* send_media：参数 paths（本地文件路径数组）+ 可选 caption。
注意事项¶
插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。需确保 Node.js 版本满足要求（>= 22.19.0）。
