dsh-image-forge
Qwen-Image 文生图与参考图编辑插件 适合需要多后端支持及精细控制宽高比的图像生成任务
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Demerier/dsh-image-forge说明文档
阅读完整 README ↗配置
全部字段都有默认值,下面这 8 个是你几乎只需要关心的。
| 字段 | 默认 | 说明 |
|---|---|---|
backend | auto | auto / api / comfyui / local 四选一 |
apiKey | 空 | 建议留空改用环境变量,key 就不会进 profile 文件 |
outputDir | ~/Pictures/dsh-image-forge | 图片落盘目录 |
timeoutMs | 180000 | 单次生成预算(ComfyUI 首次冷加载模型很慢,可调到 900000) |
comfyEndpoint | 空 | 如 http://127.0.0.1:8188;空 = 自动探测 comfyPorts,非回环地址会被拒绝 |
runtimeDir | ~/.dsh-image-forge | 插件自己拥有的运行时目录:venv、worker 日志、worker-state.json |
minFreeVramMiB | 5500 | 启动前门禁阈值:空闲显存低于它就拒绝拉起本地 worker(0 = 关掉这道门禁) |
localReferenceBudget | 0 | 只对 local 编辑生效的参考图条件化预算;0 = 按画布推导 |
完整 32 个字段(含默认值、边界、实测依据)见 docs/configuration.md;步数解析优先级 调用方显式 > 后端专属 comfyuiSteps/localSteps > defaultSteps,结果里回显 steps_used / steps_source。
设置页只展示日常字段 + 本地「一键部署」(建 venv / 装 torch / 下 10.63 GiB 权重);解释器路径、镜像、端口等自定义环境项不外露,默认值即可,要改写 profile。
Key 读取顺序:apiKey → QWEN_IMAGE_API_KEY → DASHSCOPE_API_KEY → OPENAI_API_KEY;key 只在内存里,不写盘、不进日志(报错里会被 `` 顶掉)。