前言¶
在 DeepSeek Harness（DSH）裏做圖像生成或編輯，常見做法是單獨開瀏覽器標籤頁跑工作臺，或在智能體流程裏自己拼 API 調用。前者和 DSH 左欄、會話上下文脫節；後者很難複用現成的畫廊、參考圖、遮罩編輯和多供應商配置。CookSleep/gpt_image_playground 已經提供完整的生圖工作臺（畫廊 / Agent 雙模式等）。dsh-gpt-image-playground 由社區維護者 southcul 發佈，把上游官方構建（v0.8.4）以 vendor 方式打進插件，在 DSH 內同源提供頁面，並可選走 DSH 側 API 代理，解決跨域與「生成中途切面板導致 iframe 被卸載」兩類集成問題。
這是什麼¶
一句話：把 GPT Image Playground 原版工作臺裝進 DSH——左欄多一個「生圖工作臺」入口，點開即完整上游 UI；插件本身主要負責同源託管與可選代理，不 fork 上游業務邏輯。
- npm 包名：
dsh-gpt-image-playground（當前資料中 package 版本 0.2.4） - 分類：模型推理（社區目錄 SkillHub 插件頁）
- 上游：
vendor-app/來自 CookSleep 的 gpt_image_playground 官方構建，MIT；本插件亦爲 MIT
核心功能¶
完整能力繼承自上游 v0.8.4，資料中明確列出的包括：
- 畫廊 / Agent 雙模式；批量生成、迭代、多提示詞提交、流式預覽
- 參考圖（最多 16 張）、遮罩編輯器、畫板標註（畫筆 / 文字 / 圖形 / 像素橡皮擦）、評論定位
- 多 API 配置與多供應商：OpenAI 兼容 Images / Responses、sub2api 異步、fal.ai、自定義 HTTP 供應商
- 1K / 2K / 4K 尺寸預設與規整、真實參數與改寫後提示詞對比
- 收藏夾、失敗重試、框選 / 側滑多選、大圖預覽、ZIP 備份
- 透明背景（原生 / 本地後處理）、Codex CLI 兼容、提示詞防改寫、外觀與習慣配置
與獨立打開上游站點的差異（均在 iframe 內注入，不改上游構建產物）：
- 隱藏「安裝爲應用 / 下載客戶端 / 操作指南」等入口；設置頁隱藏「關於」標籤；版本徽標顯示本插件版本；關閉上游公告卡
- 工作臺掛在
shell.overlay的常駐 iframe：切換 DSH 主面板時 iframe 僅隱藏不卸載，避免 keyed 的main槽卸載導致進行中的生成請求被銷燬 - DSH 窗口級快捷鍵不穿透到 iframe 內應用
可選 API 代理：當接口不支持瀏覽器跨域時，由 DSH 主機轉發，Authorization 與 multipart 圖片體原樣透傳。
安裝與啓用¶
DSH 生態強調「一切皆插件」；社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。安裝前建議自行查看 GitHub 倉庫 源碼與 LICENSE、THIRD-PARTY-NOTICES.md。插件隨當前 DSH 進程權限運行，API Key 存本機瀏覽器存儲（資料說明不上傳），仍須按組織策略評估 Key 與代理暴露面。
用 npm 包名（推薦）¶
在 DSH 中打開 插件 → 安裝，填寫：
dsh-gpt-image-playground
裝完後在插件列表啓用，刷新頁面（Ctrl+R），左欄出現「相框」圖標。
命令行等價：
dsh plugin --profile desktop add dsh-gpt-image-playground
從 Release 壓縮包¶
下載 最新 Release 中的 gpt-image-playground-<版本>.zip，解壓後任選其一：
- DSH 插件頁 → 安裝 → 填寫解壓目錄的絕對路徑（推薦）
- 或在 Windows 上右鍵
install.ps1→ 使用 PowerShell 運行
從倉庫目錄¶
若已從倉庫取得源碼目錄，在 DSH → 插件 → 安裝 → 填寫該目錄絕對路徑即可（README 亦給出 clone 地址，此處不展開 clone 步驟）。
典型用法¶
第一次使用可按 README 順序操作：
- 打開工作臺 → 右上角齒輪 → API 配置，填寫 API URL 與 Key。
- 若提示「接口不支持瀏覽器跨域請求」：點工作臺左下角 ⚙（iframe 外的小按鈕），填寫真實 API 地址並保存；將面板顯示的代理地址複製到應用內的「API URL」。
代理地址形如：
http://127.0.0.1:13807/plugins/dsh-gpt-image-playground/proxy
請求由 DSH 主機轉發至你配置的真實 API。
適用場景與注意¶
適合：已在 DSH 桌面 / Web 側做智能體或對話開發，希望左欄一鍵進入完整生圖工作臺，且需要與 DSH 同域部署、必要時走內置代理的場景。
注意：
peerDependencies要求@deepseek-ai/cordis（>=4.0.0 <5）與react（>=18.2.0 <19）；Node 引擎爲^22.19.0 || >=24.0.0（見 package.json）- 界面裁剪與代理行爲以插件 README 爲準；第三方許可見包內
THIRD-PARTY-NOTICES.md
結尾¶
dsh-gpt-image-playground 的價值在於：不重複造生圖 UI，把 CookSleep 的 GPT Image Playground v0.8.4 以 vendor 方式嵌入 DSH，並用 overlay iframe 與可選 /proxy 解決集成時的生命週期與 CORS 問題。目錄與文檔：
