dsh-image-gen 使用指南

为 DeepSeek Harness Web 端补上对话内生图能力，支持 Google Gemini、OpenAI 与字节 Seedream 三家厂商，并自带本地生图画廊。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add dsh-image-gen

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

💬 对话中直接生图：不需要切换到其他网站，也不需要手动复制 Prompt，直接告诉 Agent 你想画什么即可。
🖼️ 历史生图画廊：顶栏自带「画廊」Tab，自动汇总所有历史生成的图片，支持关键词搜索、厂商筛选与一键复制/下载。
🔍 交互式图片工具：支持点击全屏大图预览、一键复制图片到剪贴板、本地下载与新标签页打开。
🎨 多 Provider 支持：目前支持 Google Gemini、OpenAI Images、OpenAI Compatible API 以及 ByteDance Seedream / Volcengine Ark。Provider、模型和 Endpoint 都可以在设置界面中自由修改。
🔑 BYOK (自带 Key)：插件使用你自己的 API Key。API Key 通过 DeepSeek Harness 的 credentials 服务管理，采用写保护隔离，不需要写进项目源码或配置文件，前端不存明文。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装后在哪里填 API Key？

打开 DSH Web（默认 http://localhost:3080），进入 Settings → Plugins → Image generation，展开卡片后选择 Provider 并填写对应 API Key 保存即可。Key 通过 DSH 凭据服务加密保存，前端不显示明文。

是不是必须给三个 Provider 都准备 Key？

不必，只需要给当前选中的那个 Provider 准备即可，切换 Provider 后再补对应的 Key。

OpenAI Compatible 模式可以接哪些服务？

凡是提供与 OpenAI /v1/images/generations 兼容接口的服务都可以，包括各类中转站、自部署网关或火山方舟等同协议接入点，把 Base URL 改成对应服务的 /v1 地址即可。

生成的图片存在哪里？

图片二进制由 DSH 自身的 Attachment 服务持久化，可随历史会话重新打开；画廊使用的索引元数据（Prompt、Provider、模型等）保存在浏览器 IndexedDB，卸载插件或换浏览器不会自动同步。

顶栏看不到"画廊"Tab 怎么办？

画廊 Tab 由插件注入到 conversation.view 槽位，安装完成后会自动出现；如果没出现，请确认当前是 web profile，刷新页面或检查插件是否被禁用。

报错 "generate_image requires the XXX credential" 是什么意思？

当前选中 Provider 对应的 API Key 尚未配置，回到 Settings → Plugins → Image generation 填写并保存即可，对应的环境变量名是 GEMINI_API_KEY / OPENAI_API_KEY / ARK_API_KEY。

一次能生成多张图片吗？

generate_image 工具每次调用返回一张图，但 Agent 可根据需要自动连续多次调用，所有结果都会进入画廊统一管理。

可以把生成的图片下载到本地吗？

可以。鼠标悬停到对话里的图片或画廊卡片，会出现工具条，点击下载图标即可保存为 PNG/JPEG 到本地。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则