dsh-imagegen

DSH PLUGIN视觉与多模态

仓库 ninjasle/dsh-imagegen

视觉与多模态 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

dsh-imagegen 是 ninjasle 维护的 视觉与多模态 类 DSH 可安装插件, 仓库为 ninjasle/dsh-imagegen,许可证 MIT。 下面按「装什么、怎么装、验没验过、跑起来要注意什么」逐项列出。

一句话选型结论

按资料字段整理

dsh-imagegen 是视觉与多模态类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类视觉与多模态 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-23 创建于 2026-10-23
README 7.6 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add @danenze/dsh-imagegeneration@0.3.0
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

视觉与多模态
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

内容创作视觉识别

上游标签

dashscopedeepseek-harnessdsh-pluginimage-generationqwen-imagetext-to-image

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在视觉与多模态场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-imagegen当前 L5 · 运行验证通过 低风险 0 未标注 有
open-design L4 · 沙盒安装通过 低风险 10.0 万 未标注 有
awesome-gpt-image-2 L3 · 安装规范通过 低风险 3.4 万 未标注 无
PicGo L3 · 安装规范通过 低风险 2.7 万 未标注 无
iPolloWork L4 · 沙盒安装通过 低风险 6,775 未标注 有
modlens L5 · 运行验证通过 低风险 4,207 0.2.0-rc.2 等 13 个 有

仓库档案

视觉与多模态
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方ninjasle仓库 dsh-imagegen · 默认分支 main
分类视觉与多模态media
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-23 · 2026-10-23最后推送 2026-10-23
本站收录2026-10-30首次进入本站目录的时间

README 全文

7.6 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-imagegen

给 DeepSeek Harness 接上文生图能力的插件:模型可以直接画图,图片直接显示在对话里;输入框上还会多一个按钮,点开就能改接口地址 / 模型名 / API Key。

  • 默认后端 DashScope 的 Qwen-Image(qwen-image-3.0),也支持任何 OpenAI 兼容的 /images/generations 端点
  • 提供 4 个 agent 工具 + 1 个输入框按钮 + 1 张「插件」设置卡片
  • 配置改动即时生效,不用重启进程

为什么需要它

llm-pi-ai 这类 LLM provider 只串「文本进、文本出」的 chat 路由。qwen-image-* 是图像模型,不是 chat 模型,把它配成 provider 的模型只会得到:

404 Unsupported model `qwen-image-3.0` for OpenAI compatibility mode.
400 The product is not activated, please confirm that you have activated products ...

文生图要走 DashScope 原生的 multimodal-generation 端点,所以本插件以工具的形式暴露能力,而不是伪装成一个 chat 模型。

安装

前提:DSH ≥ 0.2,profile 里已装载 @deepseek-ai/dsh-tools(默认就有)与 @deepseek-ai/dsh-settings(Web profile 默认就有)。

已发布到 npm:

在 DSH 会话里让 agent 安装,或直接调 plugin_manager 工具,三选一:

# 1) npm(推荐,版本可锁)
plugin_manager(action: "install_bundle", target: "@danenze/dsh-imagegeneration")

# 2) GitHub 源码
plugin_manager(action: "install_bundle", target: "github:ninjasle/dsh-imagegen")

# 3) 本地源码目录(绝对路径)
plugin_manager(action: "install_bundle", target: "/path/to/dsh-imagegen")

安装成功后:

  • profile 的 package.json 出现 "@danenze/dsh-imagegeneration": "0.3.0"(或 link: / github: 形式)
  • dsh.profile.bundles 末尾出现 @danenze/dsh-imagegeneration
  • 重启一次 DSH Web / 桌面端(宿主插件在启动时组装,没有热更)

> npm 包名带 @danenze/ 前缀是因为 dsh-image-generation 这个无前缀名字已被别人占用,且 dsh-imagegeneration 被 npm 判为“与已有包过于相似”而拒收。

使用

1. 对话里直接说

「画一只戴围巾的橘猫」→ agent 调 generate_image,图片落盘并作为附件显示在对话里。

2. 输入框上的按钮

输入框左下角工具行会多一个图片按钮(在表情按钮右边)。点开是一个浮层,可以直接改:

字段 说明
接口地址 例如 https://dashscope.aliyuncs.com,或你自己的代理 / OpenAI 兼容端点
模型名 例如 qwen-image-3.0-pro
超时 单次生成超时(毫秒),默认 180000
API Key 只写不回显,存进 DSH 凭据库,不写进配置文件

保存后立刻生效(配置字段是 volatile 引用,loader 就地更新,不重载插件)。

同一张表单也会出现在 设置 → 插件 → 图片生成 里。

3. 用工具改

工具 说明
generate_image 文生图 / 参考图改图
imagegen_models 当前配置、可用模型、密钥来源(不回显密钥)
imagegen_config 读当前生效配置
imagegen_set_config 改接口地址 / 模型名 / 超时 / API Key

generate_image 参数:

参数 类型 说明
prompt string,必填 画面描述。具体写主体、动作、构图、风格、光线、配色;要出现文字就用引号写清楚
model string 覆盖默认模型
size string DashScope 用 1024*1024 形式,OpenAI 用 1024x1024;自动转换
n number 1–4 生成张数
negative string 不想出现的元素(DashScope 用负向提示词,OpenAI 拼进 prompt)
refImages string[] 最多 3 参考图 http(s) 地址,图生图 / 改图
watermark boolean 是否加水印
promptExtend boolean 服务端是否自动扩写提示词
name string 文件名前缀

返回:图片写入 outputDir,同时存进 DSH 附件服务,最终以 text + image 内容块渲染,所以对话里能直接看到图。

配置项

cordis.patch.yml 里的 config,全部可在运行时改(credentialsFile 除外):

键 默认 说明
provider dashscope dashscope 走 multimodal-generation;openai 走 /v1/images/generations
baseURL https://dashscope.aliyuncs.com 端点根地址
model qwen-image-3.0 默认模型
apiKeyEnv DASHSCOPE_API_KEY 从这个环境变量找密钥
apiKey 空 直接把密钥写配置里(不推荐,优先用凭据库)
credentialsFile $DSH_HOME/.credentials.yaml DSH 凭据文件路径
credentialsKey MULTIMODAL_GENERATION_API_KEY 从凭据文件读哪个键
outputDir $DSH_HOME/imagegen 图片落盘目录
timeoutMs 180000 单次生成超时

密钥解析顺序:调用参数 key > config.apiKey > 环境变量 apiKeyEnv > DSH 凭据服务(apiKeyEnv 与 credentialsKey 两个名字都试)> 直接扫 credentialsFile。

密钥不会出现在工具返回值、日志或配置文件里(apiKey 字段标了 role('secret'),跨线前被剔除)。

已知模型

qwen-image-3.0(默认)、qwen-image-3.0-pro、qwen-image-2.1-pro、qwen-image-2.0-pro、qwen-image-2.0。

列表只是提示——服务端支持但没列出的 id 也能直接传。

实现要点(给要改代码的人)

  • 宿主侧(index.js):defineTool 注册工具;Config 是真 schemastery schema,可编辑字段标 .volatile(),密钥标 .role('secret');每次工具调用都重新摊平配置(cfg(config) 解包 volatile 引用),所以改配置无需重启。
  • 客户端(lib/client.js):手写的预打包 bundle(window.__ModuleLoader__.load 包装),往 conversation.input.left + conversation.input.overlay 注册按钮与浮层,往 plugins.item 注册设置卡片。表单用 @deepseek-ai/dsh-client-ui-primitives 的 SettingsFormModel,密钥走 ctx.remote.credentials.set()。
  • 投递指令:插件向 ctx.systemPrompt 注册一条 section,要求模型出图后在回复正文里内嵌图片,避免「只在磁盘上生成了,用户看不见」。

踩过的坑

  1. Config 必须是真 schemastery schema(带 ~standard.validate)。写成普通对象会让 cordis 的 resolveConfig 抛 Cannot read properties of undefined (reading 'validate'),整条 entry fiberPhase: failed,一个工具都不注册。
  2. @deepseek-ai/schemastery 必须写进 dependencies。profile 用 nodeLinker: hoisted + autoInstallPeers: false,声明了才会进依赖树。
  3. @deepseek-ai/dsh-tools 只在 runtime 树里,profile 侧解析不到,所以 index.js 用 createRequire 从多个候选目录找它,找不到再用动态 import。
  4. volatile 字段解析后是引用对象,不是裸值。z.string().volatile() 拿到的是 { get() },读配置必须解包,否则业务代码会拿到包装对象。
  5. .volatile() 是方法,不是属性。写成 .volatile 会退化成一个 type: "is" 的坏节点,类型全丢。
  6. 客户端组件不能用 jsx(Component) 少传 props。React 的 jsx runtime 会直接读 config.key,undefined 抛 TypeError,组件崩溃后被插槽监督机制静默移除(看不见、日志里也没有)。
  7. 客户端 bundle 缓存是 immutable 的。改完 lib/client.js 要重启服务才重新算 rev,只刷新页面不够。

许可证

MIT

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-imagegen 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add @danenze/dsh-imagegeneration@0.3.0` 即可。

dsh-imagegen 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-imagegen 安全吗?

低风险。

dsh-imagegen 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-imagegen 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

8 条
不同作者的仓库分开列,请确认你要装的是哪一个
视觉与多模态
按星标排序,可作替代方案

open-design

open-design

L4 · 沙盒安装通过 10.0 万 星

awesome-gpt-image-2

awesome-gpt-image-2

GPT Image 2 / 2.5 提示词与案例库,530+ 个案例、20+ 套工业级模板与可复用 Skills,新增 2.5 同提示词对比

L3 · 安装规范通过 3.4 万 星

PicGo

PicGo

L3 · 安装规范通过 2.7 万 星

iPolloWork

iPolloWork

L4 · 沙盒安装通过 6,775 星

modlens

modlens

ModLens 是 DeepSeek Harness 的视觉插件,为纯文本模型外挂视觉能力,粘贴图片即得结构化 JSON 证据(OCR、版面

L5 · 运行验证通过 4,207 星

OpenBiliClaw

OpenBiliClaw

本地私有、开源的自进化跨平台 AI 内容发现 Agent:先理解你,再主动从 B站、小红书、抖音、YouTube、X、知乎、Reddit、微

L4 · 沙盒安装通过 3,398 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。