前言¶
在 DeepSeek Harness（DSH）里做智能体，一旦需要调用外部图生模型，往往要为每个厂商单独配置一套 API，来回切换时容易出错。DSH 的理念是「一切皆插件」，插件目录（SkillHub）是社区站点，与 DeepSeek / 幻方无官方从属关系。
dsh-image-hub 插件提供了一套统一的 provider 抽象，在 DSH 里为多个生图服务建立配置卡片，生成时指定使用哪一套。下面介绍它的核心能力与使用步骤。
插件定位¶
- 名称：dsh-image-hub
- 维护者：tianfangliu98-cpu
- 分类：模型推理
- 核心价值：在 DSH 中为多个生图服务（Labnana、OpenAI、Gemini、Seedream、DashScope、xAI、智谱、ComfyUI）提供统一的配置与调用方式，自带画廊与积分计量。
核心功能¶
- 多套 API 并存：每套卡片独立配置地址、Key、模型、比例、清晰度、代理。卡片可保存、恢复默认、启用/停用、删除，互不影响。
- 参考图支持：支持会话附件 id 或工作区路径，最多 14 张。
- 积分可见（Labnana）：生成前调用官方估算接口，生成后查余额，输出中显示「本次 X 积分，剩余 Y 积分」。
- 画廊：对话顶部「画廊」页签 +
image_gallery工具，记录落盘，重启不丢。 - 代理：自实现 HTTP CONNECT 隧道，不依赖系统代理设置，支持 http/https 代理。
支持的接口¶
- labnana：Labnana（火星电波）原生 OpenAPI，支持生图、改图、参考图、拉模型。
- openai：OpenAI 官方，支持生图、改图、参考图、拉模型。
- openai-compatible：OpenAI 兼容的中转站，支持生图、改图、参考图、拉模型。
- gemini：Google Gemini 原生 generateContent，支持生图、改图、参考图、拉模型。
- seedream：火山方舟 Seedream / SeedEdit，支持生图、改图、参考图。
- dashscope：通义万相 / Qwen-Image，支持生图、改图、参考图。
- xai：xAI Grok Imagine，支持生图、拉模型。
- zhipu：智谱 GLM-Image，支持生图。
- comfyui：本地 ComfyUI（导入 API 格式工作流），支持生图。
- chatgpt-sub / grok-sub：订阅通道（实验性：填访问令牌直连，令牌会过期）。
- google-sub：订阅通道（暂未支持，v1internal 专有协议）。
安装与启用¶
在终端中执行以下命令安装插件：
pnpm dsh plugin --profile desktop add github:tianfangliu98-cpu/dsh-image-hub
本地目录调试可用：
pnpm dsh plugin --profile desktop add ./dsh-image-hub
安装后重启 DSH，在「设置 → 插件 → 生图配置」里进行配置。
配置¶
- 点击「+ 添加 API」，选择接口类型，填写地址 / Key / 模型（可点击「拉取模型」自动获取），点击该卡片的「保存」。
- 每套卡片独立保存；底部「保存全局设置」只负责默认用哪套、工作区选项。
- 停用的配置不会参与生成，工具会明确提示「已停用」。
- 配置文件路径：
<DSH_HOME>/image-hub/config.json（权限 0600）。
代理设置¶
Node 的 fetch 不读取 Windows 系统代理，即使开启了系统代理，DSH 里的请求也可能仍然直连。插件自实现 HTTP CONNECT 隧道，在对应配置的「代理」字段中填写：
http://127.0.0.1:7890
http://user:pass@127.0.0.1:7890
支持 http/https 代理；SOCKS5 请把代理开成 TUN/全局模式。生图、改图、拉模型、测试连接都会走这条代理。
用法¶
在对话中使用 image_generate 或 image_edit 工具，支持以下参数：
| 参数 | 说明 |
|---|---|
prompt |
必填 |
profile |
使用哪套配置（名称或 id），默认当前激活的那套 |
model |
本次覆盖模型 |
aspect_ratio |
1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 |
image_size |
1K / 2K / 4K |
source_attachment_ids / source_paths |
参考图（会话附件 id 或工作区路径） |
示例：
- 画一张雨夜霓虹港口，16:9
- 用 Labnana 的 seedream-5-0-pro 生成一张 2K 的产品图
- 把这张图背景换成草原，人物别动
- 看看这次对话生成的图（或：打开画廊）
数据与隐私¶
- Key 只存储在本地，只发送给对应配置中填写的地址。
- 画廊记录路径：
<DSH_HOME>/image-hub/gallery.jsonl（仅记录本插件生成的图，不含上传的图）。 - 生成结果写入会话附件；开启「工作区保存」时另存到
<会话目录>/dsh-image-hub/。 - 不经过任何第三方中转。
已知限制¶
- 订阅通道是实验性令牌直连，没有 OAuth 登录与自动续期。
- Google 订阅走 v1internal 专有协议，未实现。
- Seedream / DashScope / 智谱没有公开的模型列表接口，「拉取模型」不可用，需手填 id。
- ComfyUI 只支持生图，需自备 API 格式工作流。
- 项目与 Labnana（火星电波）、OpenAI、Google 等厂商均无隶属关系。
适用场景与注意¶
适合需要同时调用多个图生模型服务的 DSH 用户，尤其是需要统一管理不同厂商配置、查看积分、管理画廊的场景。
插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
小结¶
dsh-image-hub 为 DSH 提供了一套多 API 生图插件，支持 Labnana、OpenAI、Gemini、Seedream、DashScope、xAI、智谱、ComfyUI 等 provider，具备多套配置、画廊记录与积分计量能力。对需要集成多种图生模型服务的开发者，是一个可落地的选择。
- 目录页：https://www.skillhub.cn/plugins/tianfangliu98-cpu/dsh-image-hub
- GitHub：https://github.com/tianfangliu98-cpu/dsh-image-hub
