dsh-plugin-use-images

把生成图片的 HTTP API 适配成 DeepSeek Harness (dsh) 可选模型。用户在聊天框选中图片模型后，最后一条用户文本会作为 prompt 发送给图片 API；响应会被转换为 DSH 原生图片块，持久化到会话附件存储中。

支持的响应

• JSON URL，如 data[*].url
• JSON base64，如 data[*].b64_json
• JSON data URL
• text/plain 的 URL 或 data URL
• HTTP 直接返回 image/png / image/jpeg / image/webp / image/gif

请求 body 是可配置的 JSON 模板，可用 {{prompt}}、{{model}}、{{n}} 和 {{apiKey}}。响应字段使用简化路径，例如 data[*].url、output.images[*]。

在设置页添加 API

安装并重启 DSH 后，打开「设置 → 图片 / 视频 API」。点击「新增 API」并选择接口预设，填写 Base URL、API Key 和模型 ID 即可。高级接口还可在同一页调整请求 JSON、Headers 和响应提取路径。

页面内可以直接新增、编辑和删除接口，保存后 DSH 模型列表会热更新，无需手工编辑 settings.yaml。

安装

# 从 GitHub 直接安装（推荐）
dsh plugin --profile web add github:chuling-lingling/dsh-plugin-use-images

# 卸载
dsh plugin --profile web remove dsh-plugin-use-images

安装后重启 dsh web 即可生效。完整的接口配置见 EXAMPLE.md。

YAML 备用配置方式

通常不需要手工改 YAML。如果 Web 设置页不可用，仍可用 inbox 导入：

use-images:
  inbox: |-
    {"把 EXAMPLE.md 中的 JSON 粘贴到这里": true}

如果解析失败，错误会保留在 use-images.lastError。已生效的路由保存在 use-images.routes，修改设置后会热更新模型列表。

关键字段

字段	用途
id	DSH 供应商 id，只能用小写字母、数字和 -
models	在聊天模型选择器中显示的模型
request	发送给生图 API 的 JSON 模板
extractUrls	从 JSON 响应提取 URL 的路径
extractB64	从 JSON 响应提取 base64 的路径
responseMode	auto、json 或 binary
maxResponseBytes	单张下载图片上限，默认 20 MiB
timeoutMs	生成及下载的总超时，默认 120 秒

设计说明

DSH 的 LLM runtime 只接收统一的流事件，而图片 API 通常是一次性 JSON 或二进制响应。本插件实现自定义 LlmAdapter：先执行图片 HTTP 请求，再把结果存入 attachments，最后发出 block-start(image) / block-end(image) / finish 事件。因此不需要修改 DSH 的文本适配器。