前言¶
在 DeepSeek Harness（DSH）里接图像模型，常见做法是自己在脚本或临时页面里调 DashScope，再把文件手工拷到项目目录。参数散落在终端历史或笔记里，想复现某张图的 seed、尺寸和模型往往要翻半天。Q Image Studio 是维护者 u-cha 发布的 DSH 插件（分类：模型推理），在 Harness 内提供完整工作页：写 prompt、挂参考图、选模型与尺寸、生成，并把每张结果连同参数写到本机磁盘。下面按安装、接入与日常使用说明。
这是什么¶
Q Image Studio 面向在 DSH 里迭代 Qwen 图像模型 prompt、且希望产出文件与参数都留在自己机器上的用户。插件在侧边栏打开独立页面，通过 DashScope 调用 qwen-image-* 系列模型；API Key 存在 DSH 凭据库，不写入插件配置、index.json 或日志。当前包版本为 0.1.0，许可证 MIT；官方标明兼容 DeepSeek Harness 0.2.2 构建。
核心功能¶
资料中列出的能力如下，均可在插件界面内完成。
两种生成模式
- Precise（精确）：一次生成一张图。
- Vibe Create：用不同 seed 并行生成四张独立图，便于挑方向。
尺寸
- 自动；或按长边预设配合宽高比并显示像素数；或直接指定宽高。
可复现
- 固定 seed 可得到相同图像；精确重复时插件会关闭 prompt 增强。
透明背景
- 向 Qwen 请求 RGBA，并检查结果是否带 alpha 通道；若无会提示。
参考图
- 从历史拖拽、从文件管理器拖入，或从剪贴板粘贴。
历史与灯箱
- 每条结果保存 prompt、模型、尺寸、seed、日期；点卡片可查看并复用设置。
其他
- prompt 字段旁提供 Qwen 英文 prompt 写作要点摘要；界面支持英文与俄文，在插件设置中切换。
安装与启用¶
在终端执行官方安装命令：
dsh plugin add @u-cha/dsh-q-image-studio
也可打开 DSH → Plugins → Install，粘贴 @u-cha/dsh-q-image-studio。若 GUI 提示需要重启，则重启 DSH。
插件与 DSH 主进程同一权限运行。安装前可在 GitHub 仓库 查看源码与 MIT 许可证，确认是否符合你的环境策略。
连接 DashScope¶
- 在 Alibaba Cloud Model Studio（国际）或 百炼（中国）申请 DashScope API Key。
- 打开 Plugins → Q Image Studio，新建 profile，填写端点：国际
https://dashscope-intl.aliyuncs.com，中国https://dashscope.aliyuncs.com。 - 粘贴 Key，点 Test connection；列表仅展示 Qwen 图像模型，选定后保存。
凭据库存于本机、对当前操作系统用户可读；同一账户下的工具或 agent 也可能读到 Key，需自行保证机器与账户安全。
典型用法¶
- 在侧边栏打开 Q Image Studio。
- 编写 prompt（文档建议英文效果较好）；若做图生图或编辑，添加参考图。
- 选择模式、模型与尺寸，点 Generate。
- 点击任意结果查看参数，可一键复用设置，或将该图作为下一条 prompt 的参考。
默认输出目录为 ~/Images/Q-Image-Studio（含图片与 index.json），可在插件设置中修改保存路径。
适用场景与注意¶
适合
- 已在 DSH 内工作、希望不离开 Harness 即可试 Qwen 出图并本地归档的用户。
- 需要对比四向创意（Vibe Create）或固定 seed 做 A/B 与复现的场景。
限制与依赖（摘自 README）
- 面向 Qwen 图像模型（
qwen-image-*）；其他模型与提供商不保证可用。 - 参考图编辑需 DashScope 兼容端点；透明背景取决于所选 Qwen 模型。
- 配额与模型可用性由 DashScope 账户决定；若出现
403 AllocationQuota.FreeTierOnly，表示该模型免费额度用尽，需换模型或开通计费。 package.json要求 Node^22.19.0 || >=24.0.0（插件构建/运行环境，以仓库说明为准）。
结尾¶
Q Image Studio 把 Qwen 图像生成与参数化历史收进 DSH 侧边栏，强调本地文件与可重复设置。目录页与源码分别见 SkillHub 插件页 与 GitHub：u-cha/dsh-q-image-studio。
