前言¶
在 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。
