前言¶

DeepSeek Harness (DSH) 采用插件化架构，其核心运行时主要针对文本流式响应进行适配。直接接入图片生成 API（如 Stable Diffusion、DALL-E 等）通常需要编写自定义适配器，将 API 响应转换为 DSH 原生的图片块并持久化到会话附件中。dsh-plugin-use-images 插件通过自定义适配层，解决了这一集成问题。

这是什么¶

这是一个将图片生成 HTTP API 适配为 DSH 可选模型的插件。由用户 chuling-lingling 维护。它允许用户在 DSH 聊天界面中直接调用外部图片生成接口，并将返回的图片作为会话附件处理。

核心功能¶

• API 适配：将生成图片的 HTTP API 适配为 DSH 可选模型。
• 响应格式支持：支持 JSON URL、JSON base64、JSON data URL、text/plain URL/data URL 以及 HTTP 直接返回的 image/png/jpeg/webp/gif。
• 模板变量：支持在请求 JSON 模板中使用 {{prompt}}、{{model}}、{{n}} 和 {{apiKey}} 变量。
• 配置方式：支持在设置页配置 Base URL、API Key、模型 ID，以及高级接口的 JSON 模板、Headers 和响应提取路径。支持 YAML 备用配置及热更新。

安装与启用¶

使用官方安装命令添加插件：

dsh plugin --profile web add github:chuling-lingling/dsh-plugin-use-images

安装完成后重启 dsh web 即可生效。

典型用法¶

1. 在聊天框的模型选择器中选中图片模型。
2. 在设置页的「图片 / 视频 API」区域新增接口，填写 Base URL、API Key 和模型 ID。
3. 在聊天界面发送文本，该文本将作为 prompt 发送给图片 API，响应结果会转换为 DSH 原生图片块并保存到会话附件中。

适用场景与注意¶

• Node 版本要求：运行环境需安装 Node.js >= 20。
• 模型 ID 规则：DSH 模型 ID 仅支持小写字母、数字和 -。
• 性能限制：单张下载图片上限默认为 20 MiB，生成及下载总超时默认为 120 秒。

短结尾¶

该插件通过将 HTTP 图片 API 统一适配为 DSH 模型，简化了在 DSH 中使用外部生图服务的流程。完整的配置示例和源码可查看 GitHub。