kingcharleslzy-ai/dsh-qwen-studio

从第一张图，到满意的那一版

本地生图往往分散在终端、推理服务、输出文件夹和聊天窗口里。图像把这些环节放回 DSH：描述画面、选择参考、调整效果、查看进度，再收藏值得留下的作品。

面向 Qwen Image 2.1，提供两种入口：

• 直接创作：打开左侧「图像」，输入描述即可生成。LoRA、控制图和蒙版都能在高级设置里直接选择本机文件。
• 会话创作：对模型说「帮我画一张」。插件提供技能和工具，会话发起的任务在对话与创作页同步显示阶段、步数和完成图片。

应用里叫 图像，安装包叫 dsh-qwen-studio。项目独立维护、独立发版，无需安装旧 dsh-image-gen 插件。当前版本：2.10.0。

你来决定画什么，工作区负责把流程接好

高级功能，也可以直接点选

在 图像 → 创作 → 高级设置 中：

LoRA：选文件，调权重。 支持多文件选择、单独启停、移除和参数复用。导入按文件内容去重；变更组合时重新加载模型，避免上次烘焙的 LoRA 残留到下次普通生成。

原生参考编辑：按图改画风。 配套远程 Qwen 网关可选择「参考图用法 → 按指令编辑」，把参考图片与编辑要求一起编码，再按完整步数创作。适合照片转水彩、换颜色等变化；旧预设仍用参考变体及原来的变化幅度。本机暂时保留参考变体，原生编辑不与控制图或蒙版混用。

ControlNet：用图片表达结构。 本机选择控制图并调强度。需要已准备好的 Qwen Image 2.1 Union 权重；这里选择的是控制图片，不是控制模型文件。

局部重绘：先定保留区，再改画面。 选择原图和蒙版，可与 LoRA、结构控制组合。黑色区域从输出尺寸下的原图复制；保持源图尺寸时保留原始像素。

已选文件关联与参数自动保存在草稿里。返回创作后直接生成，结果原位显示。图片输入独立保存在资源库，不会把蒙版和控制图塞进作品图库。

选文件时先复制到本机资源库，原文件不变；远程生成时，本次选中的资源会同步到你配置的服务器私有缓存。PNG / JPEG / WebP 单张不超过 64MB，最长边 8192 像素且不超过 3200 万像素；LoRA 单文件不超过 2GB。灰色蒙版按亮度中点划分黑白，透明区域按保留区处理。移除草稿关联不会删除文件原件。

从调好的一次，到随时复用的一套

整套预设保存 LoRA 的选择、顺序、开关和权重，以及控制图、蒙版、原图、采样尺寸、步数、随机/固定种子、负向词、CFG 和调度器。支持保存、另存、切换、重命名、删除与立即撤销、设为默认和 JSON 导入/导出。画面描述始终由当前创作保留，预设不会覆盖已经提交的任务。

会话里的 Agent 可用 qwen_image_import 导入公开图片直链、本机文件或会话图片附件，直接接入参考变体、控制图、蒙版与整套预设，不需要先去图库手动选文件。导入不生图、不启动 SSH、不覆盖正在编辑的草稿。

会话里的 Agent 也能完成配置：qwen_image_resources 查询真实资源，qwen_image_presets 保存、加载和管理同一个预设库；只配置不会触发生图。预设加载后可合并用户描述交给 qwen_generate_image，进度与结果沿用插件流程。详见内置技能说明。

高级设置顶部可选择预设；修改参数后会显示「已修改」，可一键重新加载。默认预设只用于首次空白草稿和主动「恢复默认参数」，不会在每次进页面时覆盖现有草稿。预设与运行配置分开保存在图库的 state/ 下。

资源库选择合并托管 LoRA、图库下 loras/ 和自定义 LoRA 目录；已导入图片与图库作品可作为图像输入再次选择，无需重复上传。刷新清单不启动推理。参数解释收在小问号里，悬停或点击即可查看。

配置值可见：连接设置显示解析后的实际路径与「默认／已设置／环境变量」来源，支持恢复继承；只原子保存实际修改的字段，不会把未改动的默认路径写死。运行中 worker 的 Python、模型和缓存路径单独展示，避免把下次启动配置误当成当前值。API Key 只显示配置状态，不回显完整密钥。

导出的 JSON 不携带权重、图像文件、设备绝对路径或连接密钥。导入后按资源内容哈希重新匹配，缺失或已变化的资源会明确提示，须重新选择、移除或停用后才能生成。它是参数分享格式，不是完整模型或图库备份。

普通文生图中，CFG 需配合非空负向词使用；填写负向词且 CFG 为 1 时，界面会注明实际自动提升到 2.5。ControlNet/蒙版分支允许空负向词配合 CFG 大于 1，但仅支持 linear 调度器。配套远程 Qwen 网关使用相同参数；普通 Images API 不接受高级参数。

为 DSH 的使用方式设计

• 跟随宿主外观：字体、字号、主题色和基础控件沿用 DSH，参数区可滚动，生成按钮保持可用。
• 创作不被打断：生成后留在原页；完成结果、最近版本、参考图对比与下载都在预览区。
• 清空工作台，保留作品：清除预览不会删除图库原件或取消后台任务。
• 进度来自真实任务：本机与配套远程网关显示资源同步、排队、加载、真实采样步数和保存；普通 Images API 显示处理状态。没有伪造百分比或半成品实时预览。
• 图库能整理：搜索、收藏、全选、批量归档、回收站、恢复与确认后永久删除。
• 模型能发现工具：内置 qwen-image 技能，简介与执行说明使用同一来源。实际生图优先走插件队列；仅写提示词时不自动生图，失败时不静默改跑独立脚本。

先试稿，再收藏

默认流程是：生成 → 隐私图库；收藏 → 普通图库。

普通图库默认显示收藏；隐私图库、归档和回收站从右上角菜单进入。可以在设置中关闭隐私图库，恢复浏览全部作品。

隐私图库只控制图库分类。对话里的生成进度、新图片和历史图片始终正常显示。 它不是加密、密码锁或访问控制。图库删除也不会清理 DSH 独立保存的对话附件。

安装

从 Releases 下载编译好的安装包，再运行：

dsh plugin --profile desktop add /absolute/path/dsh-qwen-studio-2.10.0.tgz

macOS 没有全局 dsh 命令时，可使用桌面版内置 CLI：

sh "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add /absolute/path/dsh-qwen-studio-2.10.0.tgz

正常退出并重新打开 DSH，进入插件设置配置「图像」。发布包已包含编译好的前后端、技能、worker 与环境安装脚本；模型权重需要自行准备。

已有 dsh-qwen-studio 可原位升级，保留原数据目录和配置。不要靠修改安装目录或运行目录维持补丁；源码、安装包和更新记录均由本仓库管理。

本地 Mac

需要 Apple Silicon + Python 3.12 + MFLUX 0.22.0，以及完整的 Qwen Image 2.1 模型和共享组件。内存需求取决于权重精度、分辨率与附加模型。

sh scripts/setup-local.sh "$HOME/.local/share/qwen-studio/venv"

在插件设置中选择 Python 环境、模型目录、可选 Hugging Face 缓存目录、图库目录及空闲释放时间。路径支持手动输入和本机选择器。高级创作中导入的 LoRA 无需手动搬进配置文件夹。

详见 安装与连接，模型结构参考 MFLUX Qwen Image 2.1 文档。插件不自动下载大模型。

自部署远程服务

填写 /v1 基地址、模型名和可选 API Key。服务需支持 GET /models、POST /images/generations，接收尺寸、种子与采样步数，返回 PNG 格式的 data[0].b64_json。

配套 Qwen 网关已支持 LoRA、ControlNet、蒙版、参考变体、负向词与三个调度器。 创作页和会话沿用同一套预设，选中的 Mac 资源会自动校验并同步到远程缓存，真实采样步数同步回 DSH。模型按需加载、空闲退出；图片保存回原图库，隐私分类不影响对话图片。

普通 OpenAI Images 服务仍作为基础文生图接口兼容。不支持的组合明确报错，不静默丢弃参数；ComfyUI 原生地址不能直接填写为 Images 接口。见 远程高级网关。

会话调用

无需手动复制技能目录，启用插件即可注册：

直接说：

画一张清晨山间小屋的横版插画，柔和光线，不要文字。

上网找一张山间小屋参考图，沿用构图画成水彩，用插件生成。

沿用刚才那张图的构图，再做一版水彩风格。

把刚才生成的图再显示一次，不要重新生成。

工具支持基础采样、强度式图生图、负向 / CFG / 调度器、LoRA、ControlNet 和蒙版。会话工具使用已存在的图片资源 ID；新参考图通过 qwen_image_import 导入，生成时传返回的真实 ID。换画风或按指令修改可选择 reference_mode=edit（更新后的配套远程网关、linear、32倍数尺寸，不传变化幅度/控制图/蒙版）；默认 variation 仍沿用强度式变体。支持 PNG/JPEG/WebP 公开直链；网页需先用搜索/浏览器工具取出图片链接。插件不自带搜索引擎、不自动提取姿态或绘制蒙版。网址逐跳校验公网地址、限制大小和下载时长；兼容 Fake-IP 代理 DNS 时会单独通过 HTTPS DNS 核验，不改系统 DNS 或代理。

已在 DSH / DeepSeek-V41-Flash 实测自动加载技能与工具调用。其他模型是否正确选用仍取决于其工具能力、会话上下文和 DSH 权限。独立 CLI 任务不经过插件队列，不自动获得本插件的会话进度卡片。

连接随任务来，任务结束后释放

在插件设置里填写已有的 SSH 主机别名，隧道就由插件接管：真正生图才连接，上传和生成期间保持，空闲到时确认远程模型卸载后再断开。浏览图库、加载预设、查询状态都不会唤醒连接。空闲时间在设置的运行位置下面，本机与配套远程网关共用。 Mac 意外断线时服务器也有独立的空闲释放。

对话里说“切到本机，先不生成”或“切回远程，把空闲卸载改为 10 分钟”，Agent 可用 qwen_image_connection 查询、实时切换和持久保存；已有任务会阻止切换，预设、图库和密钥保持不变。详情见按需连接说明。

验证过什么

完整证据范围见 VERIFICATION：自动测试覆盖文件导入、任务持久化与去重、图片输入快照、参数组合、LoRA 隔离、蒙版保留、图库分流、会话进度和结果恢复。

2.10.0 已通过 65 项工具/界面测试 + 28 项后端测试。原生 DSH 中，Agent 自行搜索、导入参考图，再根据能力选择原生编辑；真实 4090 完成 40/40 步，把同一蓝杯转为水彩。对话与创作页进度、完成图及图库任务同步，切页不中断。现有配置、预设和原图库文件保留。详见验证记录。

2.8.0 已通过 55 项工具/界面测试 + 26 项后端测试。按需 SSH 完成两轮真实连接、生图、模型卸载、断开与再次连接；状态查询不启动连接。原生 DSH 中，Agent 实时切换本机/远程并分别完成生图，修改与恢复空闲时间均无需重启，原有设置及预设保留。

此前在 RTX 4090 D 上完成 9 组真实推理：基础、LoRA、控制强度对照、蒙版、全部组合、参考变体及三种调度器，并验证错误 LoRA 报错与运行中取消。

重启后的原生 DSH 中，创作页通过 macOS 文件选择器导入原图、控制图和蒙版，与现有 LoRA 组合生成；会话 Agent 加载同一预设再生成。两处均显示真实步数，切页继续，完成图片同时在对话、创作页与隐私图库可见。蒙版黑色区域逐像素不变，原有预设及默认项保持不变。

已有本机推理验收包括普通生图、合成零增量 LoRA、ControlNet、蒙版及组合任务；原生 DSH 验收涵盖自然语言触发、切页进度、图片卡片与只读取回。第三方权重的兼容性与画质需按实际模型验证，不能由接口可用推断。

远程 GPU 实测范围为 Windows / RTX 4090 D / 官方 Qwen Image 2.1 INT8。Linux 启停分支尚未完成真实 GPU 验收。CI 不下载模型、不运行真实 GPU 推理。

开发与贡献

Node.js ^22.19.0 || >=24；worker 测试需要 Python 3.12 和 Pillow 11–12。

git clone https://github.com/kingcharleslzy-ai/dsh-qwen-studio.git
cd dsh-qwen-studio
npm ci
npm run check
npm run check:package

前端与宿主接口在 src/，推理队列与输入处理在 backend/，技能在 skills/qwen-image/。CI 构建安装包，Release 附带 .tgz 和 SHA-256。模型、个人配置、生成作品与运行日志不进入仓库或安装包。

欢迎用 Issues 反馈可复现问题。提交环境版本、操作步骤与错误信息即可；分享图片、日志前请先移除个人内容。

English

Qwen Studio is a local-first Qwen Image 2.1 workspace for DeepSeek Harness. Create directly without a chat model, or let a tool-capable model generate images inside a conversation.

• Native file picking: select LoRAs, control images, sources and masks from your computer.
• LoRA / ControlNet / inpainting: compose effects in the advanced creation panel; toggle LoRAs and adjust weights.
• Persistent jobs: keep working while pages change, with real sampling progress and recoverable results.
• On-demand MLX / MFLUX: start local inference when needed and release it after a configurable idle period.
• Private drafts, curated favorites: new images enter the private gallery; starred works appear in the main gallery. Conversation images remain visible. This is organization, not encryption.
• Self-hosted option: use an OpenAI-compatible Images API for remote text-to-image generation. The bundled private Qwen gateway supports LoRA, Union ControlNet, masked inpainting, img2img, content-addressed asset sync and real sampling progress in both chat and the creation panel. Ordinary Images servers remain text-to-image only.

Download a compiled .tgz from Releases, install with dsh plugin --profile desktop add, restart DSH and configure 图像. Local inference requires Apple Silicon, Python 3.12, MFLUX 0.22.0 and separately prepared Qwen Image 2.1 weights. See setup and verification for requirements and tested limits.

致谢与许可证

源于 shanliuling/dsh-image-gen 的 DSH 生图集成，现以独立的 Qwen 创作工作区维护。保留原始署名，并按 Apache-2.0 发布，来源说明见 NOTICE。

推理依赖 MFLUX / MLX 与 Qwen 模型，分别遵循各自许可证。本项目不是 Qwen、MFLUX 或 DeepSeek 官方插件。