dsh-gpt-image-playground 0.0.0-stage → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-gpt-image-playground contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,82 @@
-# Temporary Holding Version
+# GPT Image Playground for DeepSeek Harness
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/dsh-gpt-image-playground?label=npm)](https://www.npmjs.com/package/dsh-gpt-image-playground)
+[![license](https://img.shields.io/npm/l/dsh-gpt-image-playground)](LICENSE)
+[![node](https://img.shields.io/node/v/dsh-gpt-image-playground)](package.json)
+
+把 [CookSleep/gpt_image_playground](https://github.com/CookSleep/gpt_image_playground) 的**原版工作台**装进 [DeepSeek Harness](https://github.com/deepseek-ai)（DSH）：左栏多一个「生图工作台」，点开就是完整的画廊 / Agent 双模式、参考图与遮罩编辑、多供应商、收藏夹、历史管理。
+
+界面与功能来自上游官方构建（v0.8.3，原样 vendor），插件自己只负责**同源托管**和**可选的 API 代理**。
+
+![工作台](docs/screenshot-gallery.png)
+
+## 安装
+
+### 用 npm 包名（推荐）
+
+在 DSH 里打开 **插件 → 安装**，填：
+
+```
+dsh-gpt-image-playground
+```
+
+装完在插件列表里启用，刷新页面（Ctrl+R），左栏出现「相框」图标。
+
+命令行等价：
+
+```bash
+dsh plugin --profile desktop add dsh-gpt-image-playground
+```
+
+### 从 Release 压缩包
+
+下载 [最新 Release](https://github.com/southcul/dsh-gpt-image-playground/releases/latest) 里的 `gpt-image-playground-<版本>.zip`，解压后二选一：
+
+- DSH 插件页 → 安装 → 填解压目录的**绝对路径**（推荐）
+- 或右键 `install.ps1` → 使用 PowerShell 运行
+
+### 从仓库源码
+
+```bash
+git clone https://github.com/southcul/dsh-gpt-image-playground
+```
+
+DSH → 插件 → 安装 → 填克隆目录的绝对路径。
+
+## 第一次使用
+
+1. 打开工作台 → 右上角齿轮 → **API 配置**，填 API URL 与 Key（存在本机浏览器存储，不上传）。
+2. 若提示「接口不支持浏览器跨域请求」：点工作台**左下角 ⚙**（iframe 外的小按钮），填真实 API 地址并保存；再把面板里显示的代理地址复制到应用的「API URL」。
+
+代理地址形如 `http://127.0.0.1:13807/plugins/dsh-gpt-image-playground/proxy`，请求由 DSH 主机转发，`Authorization` 与 multipart 图片体原样透传。
+
+## 功能
+
+完整继承上游：
+
+- 画廊 / Agent 双模式；批量生成、迭代、多提示词提交、流式预览
+- 参考图（最多 16 张）、遮罩编辑器、画板标注（画笔/文字/图形/像素橡皮擦）、评论定位
+- 多 API 配置与多供应商（OpenAI 兼容 Images/Responses、sub2api 异步、fal.ai、自定义 HTTP 供应商）
+- 1K/2K/4K 尺寸预设与规整、真实参数与改写后提示词对比
+- 收藏夹、失败重试、框选/侧滑多选、大图预览、ZIP 备份
+- 透明背景（原生 / 本地后处理）、Codex CLI 兼容、提示词防改写、外观与习惯配置
+
+## 与上游的差异
+
+界面裁剪与信息改写都在 iframe 内用注入的方式完成，**不改上游构建产物**：
+
+- 隐藏右上角三个按钮：安装为应用 / 下载客户端 / 操作指南
+- 隐藏设置页的「关于」标签（上游的更新检查与赞助入口；第三方许可仍随包提供，见 `THIRD-PARTY-NOTICES.md`）
+- 设置页右上角的版本徽标改为**本插件版本**（不带提示、不显示上游版本）
+- 关闭上游公告卡（`vendor-app/announcements.json` 为 `[]`）
+- 工作台运行在常驻 iframe 中，因此 DSH 的窗口级快捷键不穿透到应用内部
+
+![设置页](docs/screenshot-settings.png)
+
+工作台之所以常驻在 `shell.overlay` 而不是 `main` 面板里：DSH 的 `main` 是 keyed 槽，切换面板会卸载工作台，正在跑的生成请求会随 iframe 一起被销毁。现在占位盒只负责定位，iframe 切走时仅隐藏、不卸载。
+
+## 许可与致谢
+
+- 本插件：MIT，见 [LICENSE](LICENSE)
+- `vendor-app/` 是 GPT Image Playground 的官方构建，MIT，版权归 **CookSleep**，详见 [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md)
+- 上游项目：https://github.com/CookSleep/gpt_image_playground

package/SHARE.md

@@ -0,0 +1,66 @@
+# 分享给你的朋友
+
+插件已经在 npm 上，所以**最省事的方式只需要一句话**：
+
+> DSH → 插件 → 安装 → 填 `dsh-gpt-image-playground`
+
+装完在插件列表里启用，刷新页面（Ctrl+R），左栏出现「相框」图标。
+
+---
+
+## 方式一：让朋友直接装（推荐）
+
+DSH 里打开 **插件** 页 → **安装 / 添加插件** → 「包名或地址」填：
+
+```
+dsh-gpt-image-playground
+```
+
+安装后**启用**它，刷新页面即可。
+
+**对方需要**：DSH 桌面端（能打开插件页），以及自己的图片 API（工作台里配置）。
+
+---
+
+## 方式二：发 Release 压缩包（对方网络不便时）
+
+1. 从 [Releases](https://github.com/southcul/dsh-gpt-image-playground/releases) 下载 `gpt-image-playground-<版本>.zip` 发给对方。
+2. 对方解压到任意目录（**不要**放进 DSH 安装目录）。
+3. 二选一：
+   - DSH 插件页 → 安装 → 填解压目录的**绝对路径**（推荐）
+   - 或右键 `install.ps1` → **使用 PowerShell 运行**
+
+**对方需要**：已安装并登录过一次 DSH 桌面端；不需要自己装 Node。
+
+**卸载**：在解压目录执行 `node install.mjs --uninstall`。
+
+---
+
+## 方式三：从 GitHub 装
+
+让对方在 DSH 插件页填仓库地址：
+
+```
+https://github.com/southcul/dsh-gpt-image-playground
+```
+
+或先 `git clone` 下来，再填本地目录的绝对路径。
+
+---
+
+## 朋友第一次用会遇到的两件事
+
+1. **要配 API**：工作台里点右上角齿轮，填 API URL 与 Key。数据只存在他那台机器的浏览器存储里。
+2. **可能跨域**：如果提示「接口不支持浏览器跨域请求」，点工作台**左下角 ⚙**（iframe 外的小按钮），填真实 API 地址，再把面板里显示的代理地址复制到应用的「API URL」。
+
+---
+
+## 安装小贴士
+
+- 填本地目录时必须是**绝对路径**，且目录里有 `package.json`（zip 解压后的顶层目录正好）。
+- 这种装法会记成 `file:` 依赖，那个目录**别删也别移动**；要挪就重装一次。
+- 插件提供方更新后，非官方包需要先**卸载再安装**（插件管理器会提示）。
+
+## 许可
+
+MIT；界面来自上游 GPT Image Playground（作者 CookSleep，同为 MIT），详见包内 `THIRD-PARTY-NOTICES.md`。

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,70 @@
+# Third-party notices
+
+This package redistributes a build of another project. Read this before
+publishing or shipping it.
+
+## GPT Image Playground (vendored build)
+
+- Project: GPT Image Playground
+- Author: CookSleep
+- Source: https://github.com/CookSleep/gpt_image_playground
+- Build redistributed: `vendor-app/` — the official production build published
+  at https://cooksleep.github.io/gpt_image_playground/ (application version
+  **v0.8.3**, as shown in its own about panel)
+- License: MIT
+
+Changes made to the redistributed build:
+
+1. `vendor-app/announcements.json` is replaced with `[]`, which turns off the
+   upstream announcement cards. No code was modified for this.
+2. Three header controls ("安装为应用", "下载客户端", "操作指南") are hidden at
+   runtime by CSS injected into the frame by `lib/client.js`. The shipped
+   JavaScript is untouched.
+
+No other files of the build were edited.
+
+### MIT License (GPT Image Playground)
+
+```
+MIT License
+
+Copyright (c) 2026 CookSleep
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## KaTeX fonts (inside `vendor-app/assets/`)
+
+Part of the upstream build, used by its math rendering.
+
+- Project: KaTeX — https://github.com/KaTeX/KaTeX
+- License: MIT
+
+## Fonts loaded at runtime, not bundled
+
+The upstream app can load HarmonyOS Sans SC and Maple Mono from a public CDN
+depending on its build settings; those files are **not** part of this package.
+Their licenses (HarmonyOS Sans Fonts License Agreement, SIL OFL 1.1) are
+documented in the upstream repository under `third-party-licenses/`.
+
+## Development-only dependencies
+
+`preview/vendor/react*.js` (React 18.3.1 UMD, MIT) and `puppeteer-core` (Apache
+2.0) are used by the local preview and test harness only. Neither is part of
+the published `files` list.

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# Bundle patch for dsh-gpt-image-playground: one loader entry, inserted by the
+# bundle layer so enabling the bundle in `dsh.profile.bundles` is enough.
+- insert:
+    - id: gpt-image-playground
+      name: dsh-gpt-image-playground
+      config: {}

package/install.mjs

@@ -0,0 +1,102 @@
+/**
+ * Install this plugin into a DSH profile and enable it.
+ *
+ *   node install.mjs                     # junction into the desktop profile
+ *   node install.mjs --copy              # copy the files instead (for a zip)
+ *   node install.mjs --profile web       # another profile (desktop | web | ...)
+ *   node install.mjs --uninstall
+ *
+ * `--copy` is what a packaged zip uses: the plugin keeps working even if the
+ * extracted folder moves or is deleted. `--link` (default) is for development:
+ * edits in this directory are picked up by DSH's HMR.
+ *
+ * The profile patch layer is watched by the Cordis loader, so enabling the
+ * plugin there applies without restarting the app; a page refresh is enough.
+ */
+import { cpSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, rmSync, symlinkSync, unlinkSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const PACKAGE = 'dsh-gpt-image-playground'
+const here = import.meta.dirname
+const argv = process.argv.slice(2)
+const has = (flag) => argv.includes(`--${flag}`)
+const arg = (name, fallback) => {
+  const index = argv.indexOf(`--${name}`)
+  return index >= 0 && argv[index + 1] ? argv[index + 1] : fallback
+}
+
+const uninstall = has('uninstall')
+const copyMode = has('copy')
+const profileName = arg('profile', 'desktop')
+const dshHome = process.env.DSH_HOME ?? join(process.env.USERPROFILE ?? '', '.dsh')
+const profileDir = join(dshHome, 'profiles', profileName)
+const nodeModules = join(profileDir, 'node_modules')
+const targetPath = join(nodeModules, PACKAGE)
+const packageFile = join(profileDir, 'package.json')
+const patchFile = join(profileDir, 'cordis.patch.yml')
+const SHIPPED = ['lib', 'vendor-app', 'cordis.patch.yml', 'README.md', 'LICENSE', 'THIRD-PARTY-NOTICES.md', 'install.mjs', 'package.json']
+
+function backup(file) {
+  if (existsSync(file)) copyFileSync(file, `${file}.bak-${Date.now()}`)
+}
+
+if (!existsSync(profileDir)) {
+  console.error(`找不到 DSH profile：${profileDir}\n先启动一次 DSH 桌面端，或用 --profile 指定其它 profile。`)
+  process.exit(1)
+}
+
+const existing = lstatSync(targetPath, { throwIfNoEntry: false })
+if (existing) {
+  if (existing.isSymbolicLink()) unlinkSync(targetPath)
+  else rmSync(targetPath, { recursive: true, force: true })
+}
+
+if (!uninstall) {
+  mkdirSync(nodeModules, { recursive: true })
+  if (copyMode) {
+    mkdirSync(targetPath, { recursive: true })
+    for (const entry of SHIPPED) {
+      const source = join(here, entry)
+      if (!existsSync(source)) continue
+      cpSync(source, join(targetPath, entry), { recursive: true })
+    }
+  } else {
+    symlinkSync(here, targetPath, 'junction')
+  }
+}
+
+// package.json: dependency + bundle selection
+const pkg = JSON.parse(readFileSync(packageFile, 'utf8'))
+backup(packageFile)
+pkg.dependencies = pkg.dependencies ?? {}
+pkg.dsh = pkg.dsh ?? {}
+pkg.dsh.profile = pkg.dsh.profile ?? {}
+pkg.dsh.profile.bundles = pkg.dsh.profile.bundles ?? []
+if (uninstall) {
+  delete pkg.dependencies[PACKAGE]
+  pkg.dsh.profile.bundles = pkg.dsh.profile.bundles.filter((name) => name !== PACKAGE)
+} else {
+  pkg.dependencies[PACKAGE] = copyMode ? 'file:' : `link:${here.replaceAll('\\', '/')}`
+  if (!pkg.dsh.profile.bundles.includes(PACKAGE)) pkg.dsh.profile.bundles.push(PACKAGE)
+}
+writeFileSync(packageFile, `${JSON.stringify(pkg, null, 2)}\n`)
+
+// profile patch layer: the live-reloadable insertion
+const patch = existsSync(patchFile) ? readFileSync(patchFile, 'utf8') : '[]\n'
+const marker = 'id: gpt-image-playground'
+backup(patchFile)
+if (uninstall) {
+  if (patch.includes(marker)) {
+    writeFileSync(patchFile, patch.replace(/\n- insert:\n {4}- id: gpt-image-playground\n {6}name: dsh-gpt-image-playground\n {6}config: \{\}\n?/g, '\n'))
+  }
+} else if (!patch.includes(marker)) {
+  const entry = `- insert:\n    - id: gpt-image-playground\n      name: ${PACKAGE}\n      config: {}\n`
+  writeFileSync(patchFile, `${patch.trimEnd()}\n${entry}`)
+}
+
+if (uninstall) {
+  console.log(`已卸载 ${PACKAGE}（profile: ${profileName}）`)
+} else {
+  console.log(`已安装 ${PACKAGE} → ${targetPath}（${copyMode ? '复制模式' : '链接模式'}）`)
+  console.log('刷新 DSH 页面（Ctrl+R），左栏会出现「生图工作台」。')
+}

package/install.ps1

@@ -0,0 +1,55 @@
+# 一键安装：把本目录的插件装进 DSH 桌面端（复制模式）
+#
+#   右键「使用 PowerShell 运行」，或：
+#   powershell -ExecutionPolicy Bypass -File .\install.ps1
+#
+# 会做三件事：复制插件到 profile 的 node_modules、把包加进依赖与
+# dsh.profile.bundles、在 cordis.patch.yml 追加一条启用项。改动前会备份原文件。
+
+$ErrorActionPreference = 'Stop'
+$here = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+Write-Host '==> 查找 DSH 自带的 Node'
+$candidates = @(
+  (Join-Path $env:USERPROFILE '.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe'),
+  'C:\Program Files\nodejs\node.exe'
+)
+$node = $null
+foreach ($candidate in $candidates) {
+  if (Test-Path $candidate) { $node = $candidate; break }
+}
+if (-not $node) {
+  $command = Get-Command node -ErrorAction SilentlyContinue
+  if ($command) { $node = $command.Source }
+}
+if (-not $node) {
+  Write-Host '找不到 node.exe。请先启动一次 DSH 桌面端（它会带上运行时），或安装 Node.js 后重试。' -ForegroundColor Red
+  Read-Host '按回车退出'
+  exit 1
+}
+Write-Host "    使用：$node"
+
+$profileDir = if ($env:DSH_HOME) {
+  Join-Path $env:DSH_HOME 'profiles\desktop'
+} else {
+  Join-Path $env:USERPROFILE '.dsh\profiles\desktop'
+}
+if (-not (Test-Path $profileDir)) {
+  Write-Host "找不到桌面端 profile：$profileDir" -ForegroundColor Red
+  Write-Host '请先启动并登录一次 DSH 桌面端，再运行本脚本。' -ForegroundColor Yellow
+  Read-Host '按回车退出'
+  exit 1
+}
+
+Write-Host '==> 安装插件'
+Push-Location $here
+try {
+  & $node 'install.mjs' '--copy'
+} finally {
+  Pop-Location
+}
+
+Write-Host ''
+Write-Host '完成。打开（或刷新）DSH：左栏会多出一个「生图工作台」图标。' -ForegroundColor Green
+Write-Host '第一次进去先点右上角齿轮配置 API URL 与 Key；若提示跨域，用工作台左下角 ⚙ 配代理。'
+Read-Host '按回车退出'