前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。虽然 DSH 自身包含多种模型能力，但并非所有模型都具备生图或改图的能力。对于开发者或用户而言，在纯文本模型中直接调用生图功能通常需要复杂的集成。
dsh-image-bridge 解决了这个问题。它作为一个独立的插件，为 DSH 内没有作图能力的模型挂载了 image_generate（生图）和 image_edit（改图）两个工具。通过配置外部服务，模型即可获得绘图能力，且图片会作为持久附件出现在对话中，并自动保存到会话工作区。
插件信息¶
- 名称：kkj-luna/dsh-image-bridge
- 维护者：kkj-luna
- 类别：联网工具
- 许可协议：MIT
- 核心价值：给 DeepSeek Harness 里没有作图能力的模型接上外部生图服务。
安装与启用¶
插件已发布在 npm 上，安装过程非常简单。需要在 Web profile 下运行命令。
- 执行安装命令：
dsh plugin --profile web add kkj-luna-dsh-image-bridge
-
安装完成后，必须重启
dsh web。插件代码不支持热重载，修改代码后也需要重启。 -
重启后，打开 设置 → 生图桥，确认页面能正常加载。
核心功能¶
该插件主要提供以下能力：
- 工具挂载：为模型挂载
image_generate和image_edit两个工具。 - 持久化存储：生成的图片会作为持久附件出现在对话流中，并另存到会话工作区的
generated-images/目录下。 - 多服务商支持：支持任何 OpenAI 兼容的接口（如 OpenAI、智谱、通义千问、SiliconFlow 等）。
- 容错机制：支持主用与备用模型自动切换。当主用模型连接失败或生成超时（在请求发出后），会自动切换到备用模型。
- Web 界面配置：所有服务商配置、模型选择均在 Web 界面完成。
- 安全性：
- API Key 安全存储在 DSH 的凭据服务中（
$DSH_HOME/.credentials.yaml），不回传浏览器，也不写入配置文件。 - 对方返回的图片地址会经过 SSRF 安全关卡检查，仅允许
http/https并拦截本地与私网地址。
- API Key 安全存储在 DSH 的凭据服务中（
典型用法¶
配置过程分为三个步骤：
-
添加服务商
在 设置 → 生图桥 中点击「＋ 添加模型提供商」，输入接口地址（如https://api.openai.com/v1）和 API Key。 -
测试并保存模型列表
点击「测试连接」，获取可用模型列表后，点击浮层上的「保存」。注意，只有保存后模型才会出现在下拉列表中。 -
选择模型并使用
在页面的「模型」区块，为生图和改图各选择一个模型（可各配一个备用）。点击「保存模型设置」。之后，直接在对话中对模型下达指令，例如「帮我画一只戴宇航头盔的柴犬」，模型即可调用插件进行生图。
注意事项与限制¶
- 重启要求：修改插件代码后必须重启 DSH 才能生效。
- 密钥管理：密钥不存储在配置文件中，仅存储在凭据服务里。删除服务商配置不会自动清理已存储的密钥，需手动删除。
- 导航栏图标：当前导航栏图标为权宜方案，未来将依赖官方能力。
- 超时策略：插件默认只会在连接失败时切换备用模型，不会因为生成速度慢而切换。
