前言¶
DeepSeek Harness 的理念是「一切皆插件」。在使用本地或 API 网关进行图片生成时，通常需要对接多个供应商的接口。dsh-image-generation 插件提供了设置页，用于集中管理多个供应商和模型配置，并在对话中通过 image_generate 工具调用当前选中的模型。
功能¶
多供应商配置¶
进入 设置 → 生图配置（左侧导航）。可以添加多个供应商，配置名称、Base URL、API 格式、API Key 以及模型组。密钥通过凭据服务存储，不直接写入配置文件。
对话模型选择¶
进入 设置 → 插件 → 插件配置 → 图形生成。从配置过的模型中仅选一个作为对话生图模型。在此处可开关工具、设置默认尺寸和质量。
工具调用¶
Agent 在对话中需要生成图片时调用 image_generate 工具。生成的图片会写入工作区 generate/image/ 目录，并在对话中内联显示。
安装与启用¶
使用 npm 安装：
dsh plugin --profile <name> add dsh-image-generation
注意：0.1.0 版本的
__ModuleLoader__id 为dsh-image-gen，DSH 会拒绝启动。请安装 0.1.1 或更新版本。安装前必须完全退出并重新打开 DSH（非刷新页面）。
典型用法¶
- 打开 设置 → 生图配置，添加供应商和模型，保存。
- 打开 设置 → 插件 → 插件配置，展开 图形生成，选择模型并保存。
- 在对话中让 Agent 生图，它会调用
image_generate。
工具参数：
prompt：必填，提示词。size：图片尺寸，支持1024x1024/1024x1536/1536x1024/auto。quality：质量，支持low/medium/high/auto。referenceImages：引用图片，数量 1–5 张。
注意事项¶
- 版本兼容：0.1.0 版本存在启动问题，请务必安装 0.1.1 及以上版本。
- 启动时机：DSH 在进程启动时组合插件。先启动后安装必须完全退出并重新打开，仅刷新页面无效。
- 插件重叠：与官方
@deepseek-ai/dsh-tool-image-generation功能重叠，本插件自带设置页，一般不必再装官方包。 - 工具名冲突：与
dsh-plugin-subscriptions的工具名均为image_generate。需根据需求选择（API 网关生图用本插件，订阅生图用 subscriptions）。
生态背景¶
DSH 是 DeepSeek 推出的智能体开发平台，插件生态由社区维护。本插件维护者为 whiteS18。
