前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话时，若需要示意图、概念稿或演示用配图，常见做法是切到外部绘图站点或单独写脚本调 API，再把文件拖回会话。流程长，上下文也容易断。
下面介绍的 dsh-image-generator（维护者 MR-MaoJiu）把生图收进 DSH：注册 generate_image 工具与 image-generation 技能，生成过程带 Codex 风格进度动效，成图以附件和大图形式留在当前对话。插件在 SkillHub 目录中归类为「模型推理」；仓库当前约 1 star，版本见 package.json（资料中为 1.0.3）。
这是什么¶
dsh-image-generator 是 DSH 社区插件，源码托管于 GitHub，目录页：SkillHub 插件页。SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系；DSH 生态奉行「一切皆插件」，本插件即其中面向文生图的一类扩展。
安装并刷新后，插件会向运行时注册：
- Host 工具
generate_image - 技能
image-generation（引导模型打磨提示词、调用工具并汇报结果） - Web 端工具卡片视图（
tool.call.toolview，key：generate_image）
核心功能¶
对话内一键出图¶
模型在会话中调用 generate_image，参数含 prompt 与可选 size；图片作为附件保存并在界面中大图展示。
后端与凭证¶
- 默认优先 OpenAI 兼容生图：复用 DSH 模型配置里已保存的
OPENAI_API_KEY，默认模型gpt-image-2.6-flare，基址https://api.openai.com/v1。 - 未配置 key 时自动回退免费后端 Pollinations（模型默认
flux）；资料注明同 IP 约 45 秒 1 张，尺寸可能被服务端缩放。
可通过配置项 provider 显式选择 openai 或 pollinations。
分辨率与校验¶
常用尺寸包括 1024x1024、1792x1024、1024x1792、768x768；也可传自定义宽高（须 16 整除、宽高比 1:3～3:1、最长边 ≤3840），由工具校验并归一化。
界面与动效¶
生成中展示按目标宽高比渲染的深灰点阵卡片（双层点阵、光晕呼吸、绿色百分比胶囊），出图时布局尽量不跳动；完成后直接大图展示。
安装与启用¶
从 GitHub 安装（命令来自仓库 README）：
dsh plugin add git+https://github.com/MR-MaoJiu/dsh-image-generator.git
本地开发可将路径换为本机克隆目录：
dsh plugin add /path/to/dsh-image-generator
安装完成后重启或刷新 DSH 页面。开发迭代时可先移除再指向本地目录：
dsh plugin remove dsh-image-generator
dsh plugin add ./dsh-image-generator
配置要点¶
可在插件配置中覆盖下表项（默认值见 README）：
| 配置项 | 默认值 | 说明 |
|---|---|---|
provider |
自动 | openai / pollinations |
openaiBaseUrl |
https://api.openai.com/v1 |
OpenAI 兼容 API 地址 |
openaiModel |
gpt-image-2.6-flare |
生图模型 |
openaiApiKey |
空 | 留空则读 DSH 凭证中的 OPENAI_API_KEY |
openaiApiKeyEnv |
OPENAI_API_KEY |
凭证引用名 |
pollinationsModel |
flux |
Pollinations 模型 |
pollinationsEnhance |
false |
是否开启提示词增强 |
timeoutMs |
120000 |
单次生成超时（毫秒） |
典型用法¶
模型调用工具时的 JSON 形态如下（示例来自 README）：
{ "prompt": "a cozy Japanese ramen shop at night, warm lantern light, photorealistic", "size": "1792x1024" }
指定免费后端：
{ "prompt": "...", "size": "1024x1024", "provider": "pollinations" }
用户只需用自然语言描述画面需求；具备 image-generation 技能后，模型会据此组织提示词并调用 generate_image。
适用场景与注意¶
适合：在 DSH 内做 UI 概念图、配图草稿、演示素材，希望不离开会话即可完成生成与预览的开发者与用户。
注意：
- 插件在当前 DSH 进程权限下运行，安装前应阅读 源码 与 MIT 许可证，确认 API 密钥与网络出站策略符合你的环境。
- OpenAI 路径依赖有效 key 与配额；Pollinations 路径有速率与尺寸限制，不适合高并发批量生产。
- 修改插件 JS 后可用
node --check index.js、node --check client.js做语法检查，再重新安装使改动生效。
结尾¶
dsh-image-generator 把文生图工具、技能与 Web 动效打包进 DSH，有 key 时走 OpenAI 默认模型，无 key 时回退 Pollinations，适合在 Harness 对话里快速验证视觉想法。
- 目录页：https://www.skillhub.cn/plugins/MR-MaoJiu/dsh-image-generator
- 仓库：https://github.com/MR-MaoJiu/dsh-image-generator
