前言¶
在 DeepSeek Harness（dsh）里做对话式智能体时，文字模型本身不会画图。常见做法是另开脚本或单独调绘图 API，再把图片路径贴回会话，步骤割裂，也不利于后续多模态模型继续读图。
dsh-image-relay 把「文生图」做成模型可调用的 image_generate 工具：请求走你自配的 OpenAI 兼容中转站，生成结果以附件形式留在 DSH 会话里。下面介绍它是什么、怎么装、怎么配、以及使用时要注意什么。
这是什么¶
维护者为 Bai-Ziyi。插件在 SkillHub 目录 中归类为「联网工具」；源码与说明见 GitHub：Bai-Ziyi/dsh-image-relay（MIT，当前 package 版本 0.2.0）。
一句话：通过任意 OpenAI 兼容中转站的 /images/generations 接口，按文字提示生成图片，并挂到当前 DeepSeek Harness 对话中。插件不内置中转站地址或模型，也不会把 API Key 发到除你配置的 Base URL 以外的地址。
核心功能¶
经 README 核实，插件提供的能力如下。
- 工具
image_generate：模型在判断需要画图时才会调用，不会自动批量出图。 - 参数：
prompt必填；size、model可选，未传时使用插件配置里的默认值。 - 结果形态：支持中转站返回
b64_json或url；若为 URL 会由插件下载。图片经 DSH attachment 服务持久化，会话内可回看，也便于支持图片输入的模型继续查看。 - 可选本地副本：配置「另存目录」后，除附件库外还会在指定目录写入带
.png/.jpg等扩展名的文件，并在工具结果中返回绝对路径。 - 出站网络：请求使用 Host 的全局
fetch，已配置的 DSH 出站代理会一并生效。
明确不支持：图生图、编辑、n>1、quality 等超出 OpenAI 兼容 /images/generations 最小集的能力。
安装与启用¶
安装命令以仓库 README 为准；按你使用的 profile 二选一。
# Web profile
dsh plugin --profile web add github:Bai-Ziyi/dsh-image-relay
# 桌面端使用的 profile
dsh plugin --profile desktop add github:Bai-Ziyi/dsh-image-relay
安装后重启一次 DSH，再打开 插件 → 已安装 → Image Relay / 图片中转 → 配置，填写中转站信息。
兼容性方面，README 写明面向 DSH 0.2.x，在 0.2.1-rc.2 上测试过；客户端配置页依赖同版本 DSH 的「插件」能力（半侧注册到 plugins.row.config）。
配置项¶
在配置页填写下列字段（含义与默认值见下表）。
| 字段 | 默认值 | 含义 |
|---|---|---|
| Base URL | 空 | OpenAI 兼容地址，例如 https://your-relay.example/v1。 |
| API Key | 空 | 中转站的 key；界面可切换显示/隐藏，默认隐藏。 |
| 模型 | 空 | 中转站要求的图片模型 id。 |
| 默认尺寸 | 1024x1024 |
调用未指定 size 时使用。 |
| 超时 | 180000 |
单次生成最长等待毫秒数。 |
| 另存目录 | 空 | 可选。留空只存附件库；相对路径基于当前工作区，也可填绝对路径。 |
安全与权限：API Key 会以明文保存在 profile 的 cordis.patch.yml 中。请使用仅在中转站生效、可随时吊销的 key，不要填主账号长期密钥。Key 只出现在发往你所填 Base URL 的 Authorization 请求头里。
若填写「另存目录」，副本以 Host 权限写入，请只填你信任的目录；留空则仅保存到 DSH 附件库。
典型用法¶
配置完成后，在对话里用自然语言描述即可，例如：
画一张 1024x1024 的橘猫头像，扁平插画风，白色背景
模型会调用 image_generate，按你的描述请求中转站；返回的图片在会话中以附件展示，若中转站直接返回 URL，结果里也会带上该 URL。
工作原理（简述）¶
经过上面的配置，单次生成大致按以下步骤执行。
- 向
POST {Base URL}/images/generations发送 JSON：{ model, prompt, size }。 - 解析
b64_json或url响应，必要时下载 URL 所指图片。 - 通过 DSH attachment 服务落盘，供会话与后续多模态使用。
- 若配置了另存目录，再写一份带扩展名的副本并返回绝对路径。
适用场景与注意¶
适合：已在使用 DSH 0.2.x、手头有 OpenAI 兼容文生图中转站，希望对话里「说一句就画图」且图片留在会话附件链路上的开发者。
注意：
- 插件以当前
dsh进程权限运行；安装前请自行查看 源码与许可证，确认符合你的安全与合规要求。 - SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系；星标与版本以你安装时拉取的仓库为准（目录页当前星标为 0，package 版本
0.2.0）。 - 仅当模型主动调用工具时才会消耗中转站配额；未配置 Base URL、模型或 Key 时，应按插件逻辑拒绝无效请求（开发侧用 mock fetch 覆盖相关路径，见仓库
npm test）。
结尾¶
dsh-image-relay 把 OpenAI 兼容中转站接进 DSH 的工具层，让文生图与对话、附件、可选工作区落盘在同一条链路上完成，而不捆绑具体厂商或中转地址。
- 目录页：https://www.skillhub.cn/plugins/Bai-Ziyi/dsh-image-relay
- GitHub：https://github.com/Bai-Ziyi/dsh-image-relay
