dsh-imagegen

DSH PLUGIN视觉与多模态

仓库 xuan25/dsh-imagegen

视觉与多模态 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

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

一句话选型结论

按资料字段整理

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

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

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:xuan25/dsh-imagegen
  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 查看包信息

能做什么

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

适用场景

内容创作视觉识别

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

选择建议

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

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-imagegen当前 L4 · 沙盒安装通过 低风险 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 个 有

仓库档案

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

README 全文

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

dsh-imagegen

Image-generation plugin for dsh: one imagegen tool that renders images
through any OpenAI-compatible image backend, so agents can generate images
without per-backend glue. The same tool lists the configured routes, echoes
the declared model lists, and live-probes the backends.

Tool verbs

verb network what it does
generate yes Generates the requested images. The tool writes the image files to disk and runs magic-byte checks on them.
providers no Lists the configured routes with their fields, the originating layer of each field, and the credential state. The verb reads the local configuration and makes no network request.
models no Echoes the declared model list of each route from the config layer. The verb makes no network request; the live model listing is the status verb.
status yes Probes each route's GET {baseURL}/models endpoint and reports reachability plus the live model list.

Key generate behaviors:

  • The prompt argument is required, and it is the only required argument.
  • When the call omits model, the tool uses the route's single declared
    model. When a route declares no models, the tool resolves the model by a
    live /models probe. When the declared or probed model list contains
    several models, the call fails and lists the candidates.
  • The tool sends size and negativePrompt verbatim, and only when the call
    sets them. The seed argument must be an integer, and the tool sends it
    only when the call sets it. The n argument is an integer >= 1 with a
    default of 1, and a value greater than 1 requests a batch.
  • When the call sets out, the output path is that argument (a file path for
    n = 1, or a directory marked by a trailing separator or by existing on
    disk). When the call omits out, the tool writes the files to
    /images/_.. The file extension comes from
    the image magic bytes (png / jpg / webp).
  • The tool checks the written bytes for PNG, JPEG, or WebP magic. When the
    payload is not a recognized image, the call fails with code: output, and
    the tool keeps the file on disk. When the path cannot be written, the call
    fails the same way.
  • The generate timeout is 180 s by default, and a timeout argument of
    1-3600 s overrides it per call. The probe timeout is 10 s.

The plugin ships a dsh-imagegen skill. The skill is the full tool reference
for agent contexts: it carries the parameter table, the env contract, and the
error codes.

Installation

dsh-imagegen is an out-of-tree plugin for a dsh profile. Install it with the
dsh plugin command:

dsh plugin --profile  add dsh-imagegen

Configuration is layered: built-in defaults, the IMAGEGEN_* env contract, a
cordis patch file, a dsh-imagegen settings section (see below); the plugin
creates no config or state files.

Configuration

Providers are configured in any of four layers, lowest to highest priority;
the providers verb reports the originating layer of every field, so a
shadowed value is never silent:

  1. the built-in default (api: openai-compatible),
  2. the IMAGEGEN_* env contract (static per process boot),
  3. the cordis config layer (a patch entry with id dsh-imagegen and a
    config object, or profile-level patches),
  4. the dsh-imagegen: section in the user settings document
    ($DSH_HOME/settings.yaml), which the plugin re-reads on every call, so
    settings edits apply without a restart.
dsh-imagegen:
defaultProvider: local
providers:
local:
baseURL: http://:/v1
hosted:
baseURL: https://api.example.com/v1
apiKeyEnv: IMAGEGEN_HOSTED_KEY
models: [flux-1]
displayName: Hosted Images

The env contract mirrors the config fields 1:1: IMAGEGEN_DEFAULT_PROVIDER,
and per route the variables `IMAGEGEN_PROVIDER__BASEURL`, `IMAGEGEN_PROVIDER__API`, `IMAGEGEN_PROVIDER__APIKEYENV`, `IMAGEGEN_PROVIDER__HEADERS`, `IMAGEGEN_PROVIDER__MODELS`, `IMAGEGEN_PROVIDER__DISPLAYNAME`. The segment is the route name
uppercased with - written as _. The headers value is a JSON object
string, and the models value is a comma-separated list of model ids. The
baseURL value is the OpenAI-compatible base URL including the /v1 prefix
(the same shape as an LLM provider base URL); the plugin appends
/images/generations and /models to it verbatim, and the image contract has
no server-root endpoints. The apiKeyEnv value is a reference to an
environment variable name, never a secret in config; per request the value
resolves from the process environment, then from
$DSH_HOME/.credentials.yaml.

Examples

// Generate with the default route and its single declared model.
{ "verb": "generate", "prompt": "a lighthouse in fog", "size": "1024x1024" }
// Pick a route and model explicitly, and keep the output name deterministic.
{ "verb": "generate", "provider": "hosted", "model": "flux-1",
"prompt": "an isometric pixel-art garden", "seed": 42, "out": "/tmp/garden.png" }
// Generate a batch into an existing directory.
{ "verb": "generate", "prompt": "three weather variations", "n": 3, "out": "renders/" }
// List what is configured, and where each field comes from.
{ "verb": "providers" }
// List the declared model lists per route (no network).
{ "verb": "models" }
// Probe the backend health (the live /models probe).
{ "verb": "status" }

Troubleshooting

A failing call returns the document { ok: false, error: { code, message, provider?, elapsed_ms } }. The code set is invalid_param / config /
network / timeout / http / protocol / output.

  • When a config error carries the message "no provider route is
    configured", no route survived configuration. Check the base URLs; the tool
    reports each route that configuration drops as a warning in the log.
  • When a config error carries the message "credential missing: environment
    variable "X" is not set", the credential reference does not resolve. Set
    X in the environment or add it to $DSH_HOME/.credentials.yaml.
  • When a config error carries the message "unknown provider "x"", the route
    name matches no configured route. Route names match case-insensitively and
    treat _ and - as the same separator; the error lists the configured
    names.
  • When a config error carries the message "multiple providers configured
    (...) and no default is set", pass the provider argument explicitly, or
    set IMAGEGEN_DEFAULT_PROVIDER, or set the settings defaultProvider.
  • When an output error carries the message "write failed", the tool could
    not write to the out path. Check the directory and its permissions.
  • When an output error carries the message "not a recognized image", the
    backend returned bytes with no PNG, JPEG, or WebP magic. Inspect the kept
    file; the backend may return an unsupported container.

Build

pnpm install
pnpm run build     # tsc -> lib/
pnpm run lint      # eslint src/ test/
pnpm run selftest  # in-process: HTTP stub + config matrix + magic-byte checks

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:xuan25/dsh-imagegen` 即可。

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

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-imagegen 安全吗?

低风险。

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

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

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

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

同名或近似条目

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 星

xuan25 的其它插件

6 个

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