前言¶
DeepSeek Harness（DSH）支持通过插件扩展功能。dsh-openrouter-imagen-v2 是一个插件，它利用 OpenRouter 的图像 API，在 DSH 内部提供了一个独立的工作台和一个供 Agent 调用的工具。它解决了需要在智能体流程中集成图像生成能力的需求。
核心功能¶
该插件提供以下能力：
- 独立工作台：双栏布局，左侧为图片区与历史记录，右侧为对话区，分隔条支持拖动。
- 两种出图方式：既可以在工作台手动生成，也可以通过 Agent 调用工具生成。
- 提示词处理：支持「直接出图」（输入即提示词）或「让 AI 写提示词」（默认使用
google/gemini-2.5-flash模型）。 - 参考图支持：支持最多 4 张参考图，支持文件选择、粘贴或拖放。
- 模型管理：支持配置模型清单（最多 16 个），并可指定默认模型。
- 种子回填：生成后自动写入实际使用的种子，便于复现。
- 生成记录：保留最近 60 条记录，支持按相同参数重新生成。
- 随包 Skill：包含一个 skill，用于指导模型推导画风与提示词。
安装与启用¶
安装前请确认 DeepSeek Harness 版本为 0.2.x，且 Node.js 版本为 ^22.19.0 或 >=24.0.0。
通过 Git 安装：
dsh plugin --profile desktop add git+https://github.com/fancyui/dsh-openrouter-imagen-v2.git
安装完成后重启 DSH，在侧栏「插件」组下即可找到「图像生成」入口。
使用¶
工作台操作¶
进入「图像生成」工作台后，默认参数为：数量 1、质量 medium、背景 auto、宽高比 16:9、分辨率 1K。
- 提示词模式：在右栏输入描述，选择「直接出图」或「让 AI 写提示词」。
- 参考图：支持拖放或粘贴图片，图片仅随当次请求发送，不写入记录。
- 种子：生成后种子会自动回填到输入框，点击「随机」可清空。
设置配置¶
点击右上角设置，可配置以下内容：
- 密钥：配置 OpenRouter API Key，用于请求验证与额度查询。
- 模型：管理模型清单与默认模型。
- 高级：设置提示词模型、保存目录（默认为
generated-images）、Provider 排序及附加请求体 JSON。
Agent 调用¶
Agent 可调用工具 openrouter_generate_imagen_v2 生成单张 PNG 图片。
参数说明：
* prompt：必填，画面描述。
* save_dir：可选，保存目录（相对会话工作目录）。
* file_name：可选，文件名主干（扩展名固定为 .png）。
* aspect_ratio、resolution、quality、background、model、seed：可选，未指定时使用工作台设置。
固定行为：
单次调用仅生成一张图片。
注意事项¶
- 需要有效的 OpenRouter API Key。
- DeepSeek Harness 版本要求 0.2.x。
- 保存目录限制在会话工作目录内，越界会报错。
- 密钥不会通过任何接口返回原文。
- 分辨率档位
512、1K、2K、4K为名称，不对应固定像素值。 - Agent 调用单次仅生成一张 PNG 图片。
结语¶
该插件补充了 DSH 在模型推理方面的能力，使图像生成成为 DSH 生态的一部分。更多细节与源码可参考下方链接。
