它做什么
dsh-image-gen 把 web profile 变成一个图像工作台。README 把它定位为「DeepSeek Harness 的原生 AI 图像创作套件」而非单一文生图工具,功能面也相应很宽:五个入口、七家云厂商、三条免 API Key 的订阅通道,以及一条本地 ComfyUI 路径。
| 入口 | README 声称最合适 | 能做什么 |
|---|---|---|
| 对话 | 快速表达想法 | 文生图、图生图、连续编辑、版本切换 |
| 画布 | 视觉与空间创意 | 草稿生成、参考图组合、持续修改 |
| 工作台 | 精细控制参数 | 批量生成、多图参考、高级设置 |
| 灵感 | 寻找创作方向 | 500+ Prompt 案例,一键复用 |
| 图库 | 管理生成结果 | 搜索、收藏、下载、重新使用 |
画布基于 tldraw(精确锁定 5.3.0),界面基于 lucide-react,两者都是声明在 dependencies 里的运行时依赖——也就是说这个插件带的是一块真正的绘图面,不是一张表单。
Provider、模型与接入方式
package.json 声明了 dsh.bundle.patch(cordis.patch.yml)与 dsh.client(platform: "web"),注入八个宿主 UI 包(dsh-client-connection、dsh-api-remotes、dsh-client-ui-conversation、-settings、-settings-plugins、-sidebar-right、-tool、-locale)。宿主插件与浏览器 bundle 在同一个包里,所以厂商列表与画布天然一致。
README 给出的 Provider 矩阵(默认值均可在「设置 → 插件 → 插件配置 → 图像生成」中修改):
| Provider | 默认模型 | 默认 Endpoint |
|---|---|---|
| Google Gemini | gemini-3.1-flash-image |
generativelanguage.googleapis.com/v1beta/interactions |
| OpenAI Images | gpt-image-2 |
api.openai.com/v1 |
| OpenAI Compatible(中转站) | 自定义 | 自定义 Base URL |
| ByteDance Seedream / 火山方舟 | doubao-seedream-5-0-260128 |
ark.cn-beijing.volces.com/api/v3 |
| Aliyun DashScope / Qwen Image | qwen-image-3.0 |
dashscope.aliyuncs.com/api/v1 |
| xAI Grok Imagine | grok-imagine-image |
api.x.ai/v1 |
| 智谱 GLM-Image | glm-image |
open.bigmodel.cn/api/paas/v4 |
| 本地 ComfyUI | 用户导入的 API Format Workflow | 默认 127.0.0.1:8188 |
三条订阅通道——ChatGPT、Grok、Google——通过登录而非粘贴 Key 配置,通道内模型固定(gpt-image-2.5-flare、grok-imagine-image-2.0、gemini-3-pro-image)。
有两个编辑器侧的便利值得一提,因为它们直接决定你要读多少厂商文档:「测试连接」按钮,以及「拉取模型」——把该厂商支持的图像模型拉进选择器,而不是让你手打模型 id。
要求与安装
-
Node
^22.19.0 || >=24.0.0(engines)。 -
一个
dsh plugin命令可用的 DSH 环境。 README 要求「DeepSeek Harness 稳定版本」,但未声明版本范围,因此本条目不记录dshTarget,等级为 L2:安装命令可对已发布包解析,但作者没有可记录的兼容声明。 -
安装 —— README 的第一推荐路径:
dsh plugin --profile web add dsh-image-gen@latest若
dsh不是全局命令,则用pnpm dsh plugin --profile web add dsh-image-gen@latest。README 另列:用git+https://github.com/shanliuling/dsh-image-gen.git装默认分支最新代码,或本地 clone 后按路径安装用于开发。 -
package.json声明了prepare脚本(pnpm run build)。它对 git / 本地安装会执行,对消费已发布 tarball 的安装不会——但这意味着 git 方式安装会在你机器上触发一次构建。其余脚本为typecheck、build、test、pack:check;没有preinstall/install/postinstall。 -
安装或升级后重启对应 profile。 若「图像生成」设置页没出现,README 自己的诊断方式是
dsh --profile web --dump-config——输出里没有dsh-image-gen就重装。 -
peer 依赖全部为 optional(
@deepseek-ai/cordis、@deepseek-ai/schemastery、react),这也是同一个包能同时承载宿主与浏览器两半、又不钉死宿主 React 的原因。 -
发布的
files包含lib/index.js、lib/client.js及其 sourcemap、.d.ts目录、skills/**/*.md、cordis.patch.yml、各语言 README、docs/assets/readme/*.webp与许可证。
网络与数据
凭据进 DSH 凭据库,不进插件。 API Key 由 DSH Credentials 保存,设置页不回显明文。订阅令牌同样保存在凭据库,且与 API Key 完全隔离;README 声明浏览器侧不接触令牌。
出网的内容就是厂商所需的内容。 提问词与本次使用的参考图会发送给所选 Provider——这是使用托管图像模型的固有前提,README 提示遵守对应服务条款。ComfyUI 的请求只发往你配置的地址。
生成文件落盘由你指定。 开启「保存到工作区」后,对话结果进入当前工作区下的 dsh-image-gen/ 目录(可改)。Studio 的候选图先留在临时画布,只有你选中的才会落盘。图库元数据与收藏状态存在浏览器本地存储;删除图库条目不会改写原聊天消息,是否清理工作区里的本地图片是另一个需要显式确认的步骤。
灵感库元数据随插件发布,图片按需加载并缓存在本机,README 说明该缓存可随时清理。
未记录遥测——README 与发布清单都没有描述外发分析。本条目为 security: unverified:没有第三方扫描或独立审计记录。
已知限制
- Studio 与多模型对比仅支持云端 Provider。 ComfyUI 可用于 Agent 对话(文生图、单图编辑、多个命名工作流),但不会出现在 Studio 与对比视图里。
- 智谱 GLM-Image 上游本身不支持图生图,README 将其列为「不支持」而非缺陷。
- xAI 图生图走 OpenAI 兼容的 multipart 协议,部分网关可能尚未实现。
- 订阅通道使用通道默认参数,参考图最多 5 张,且每通道模型固定。
- 多模型对比调用的是你已在设置中配置好的模型,未配置的 Provider 只是不出现在对比里,而不是报错。
- README 自带破坏性版本提示:作者要求老用户升级到最新版本,因为本次版本变化较大。如果你的工作流依赖画布,请钉住一个已验证版本。
- Star(426)代表关注度,不代表审查。 本站没有任何条目声称 L4/L5,本条目也不表示已在本机冒烟安装。
何时用 / 何时不用
适合你想在 Harness 会话内完成图像工作、而不是另开浏览器标签的人:用画布拼参考图、用 Studio 跑批量、用对比视图在模型间取舍、在没有灵感时翻 Prompt 库。订阅通道是它最独特的点——如果你已经付了 ChatGPT、Grok 或 Google,README 的主张是可以不用另买 API Key 就出图。
不要指望它是无头图像 API、ComfyUI 工作流编辑器,或者能在 GLM-Image 上跑图生图。如果你每次会话只需要一次文生图调用,更窄的插件用更小的表面积就能完成;如果你不希望提问词离开本机,这里唯一符合条件的模式只有本地 ComfyUI。
FAQ
它一定需要 API Key 吗?
不一定。七家 Provider 走 BYOK Key,但 ChatGPT、Grok、Google 三条订阅通道通过登录使用——README 的主张就是已有订阅即可开始出图。
生成的图片保存在哪里?
开启工作区保存后,对话结果落在当前工作区的 dsh-image-gen/ 子目录,位置可配置。Studio 只保存你选中的候选图。图库状态在浏览器本地存储里。
为什么 Studio 里看不到 ComfyUI?
因为 Studio 与多模型对比按设计仅支持云端 Provider。ComfyUI 在 Agent 对话中可用,需要导入 API Format Workflow JSON,并且可以同时挂多个命名工作流。
它会不会把数据发到我未选择的地方?
一次请求的提问词与参考图会发给你选定的 Provider——托管图像生成本来就是这样。ComfyUI 流量只发往你配置的地址。README 未描述自身的任何分析上报,密钥与订阅令牌留在 DSH 凭据库而非插件内。
该钉哪个版本?
看 README 自己的升级提示:这个版本变化大到作者请老用户迁移到最新版。如果画布是你的工作流的一部分,请安装一个你已经实际跑过的版本,而不是跟默认分支最新代码。

