dsh-plugin-image-workbench 0.0.0-stage → 1.1.6

package/install.mjs

@@ -0,0 +1,333 @@
+/**
+ * 把插件挂进当前 DSH desktop profile。
+ *
+ * 用法：
+ *   node install.mjs              安装（幂等，可在任意目录重复执行）
+ *   node install.mjs --uninstall  从 profile 配置里摘掉插件并断开目录联接
+ *
+ * 改动范围：
+ *   1. profile/node_modules 下建指向插件源码目录的目录联接（父目录自动创建）；
+ *   2. profile/package.json 的 dependencies 与 dsh.profile.bundles（改前备份）；
+ *   3. pnpm-lock.yaml 里直接补/删 importer 记录，不联网、不动 node_modules。
+ * 不会执行完整 pnpm install（避免重拉已装的其他插件），也不会重启 DSH。
+ *
+ * 顺序是「先建联接、后写配置」：联接建不起来时 profile 保持原样，DSH 照常启动，
+ * 不会出现「配置已注册、目录联接没建」的半装状态。这一点在全新 profile
+ * （没有 node_modules、没有 pnpm-lock.yaml）上尤其重要。
+ *
+ * 号池已经并入工作台：安装时顺手把旧的独立号池插件 dsh-plugin-image-pool
+ * 从 profile 摘掉（只改配置，不删它的源码目录和账号数据），侧栏就只剩一个
+ * 工作台入口。旧插件下次 DSH 启动不再加载，号池改由工作台后端自己拉起。
+ *
+ * 整包自包含：插件自带 vendor/chatgpt2api（号池服务端源码 + uv）与 server/
+ * （工作台后端代码）。开发机上仍优先用工作区里的 image-local/，把这个插件
+ * 单独拷到另一台机器时会自动落到 server/，不要求对方装任何第三方插件。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { fetchStyleImages as fetchSamples } from './scripts/fetch-style-images.mjs';
+
+const NAME = 'dsh-plugin-image-workbench';
+const LEGACY = 'dsh-plugin-image-pool';
+const PLUGIN_DIR = path.resolve(fileURLToPath(new URL('.', import.meta.url)));
+const PROFILE_DIR = path.join(process.env.DSH_HOME || path.join(os.homedir(), '.dsh'), 'profiles', 'desktop');
+const PKG_FILE = path.join(PROFILE_DIR, 'package.json');
+const LOCK_FILE = path.join(PROFILE_DIR, 'pnpm-lock.yaml');
+const LINK_PATH = path.join(PROFILE_DIR, 'node_modules', NAME);
+const uninstall = process.argv.includes('--uninstall');
+
+/* Node 16 及更早没有全局 fetch，脚本会在改完配置之后才报错，留下半装状态。
+   这里先拦一道，报错时 profile 一个字节都没动。 */
+const nodeMajor = Number(String(process.versions.node).split('.')[0]);
+if (nodeMajor < 18) {
+  console.error('当前 Node 版本为 ' + process.versions.node + '，本安装器需要 Node 18 及以上（建议 20+）。');
+  console.error('升级 Node 后重新执行；profile 未被修改。');
+  process.exit(1);
+}
+
+if (!fs.existsSync(PKG_FILE)) {
+  console.error('找不到 DSH profile：' + PKG_FILE);
+  console.error('请确认 DSH 桌面端已至少启动过一次，或用 DSH_HOME 指定数据目录。');
+  process.exit(1);
+}
+
+const raw = fs.readFileSync(PKG_FILE, 'utf8');
+const pkg = JSON.parse(raw);
+const deps = pkg.dependencies || (pkg.dependencies = {});
+const bundles = pkg.dsh?.profile?.bundles;
+if (!Array.isArray(bundles)) {
+  console.error('profile/package.json 缺少 dsh.profile.bundles，已停止，不做任何修改。');
+  process.exit(1);
+}
+
+/* ---------- 目录联接 ---------- */
+
+/** 判定当前联接状态：missing 不存在 / dir 是真实目录 / ok 有效联接 / dead 失效联接 */
+function linkState() {
+  let st = null;
+  try { st = fs.lstatSync(LINK_PATH); } catch { return 'missing'; }
+  if (!st.isSymbolicLink()) return 'dir';
+  try { fs.realpathSync(LINK_PATH); return 'ok'; } catch { return 'dead'; }
+}
+
+function removeLink() {
+  try { fs.unlinkSync(LINK_PATH); return true; } catch (_) { /* 试下面的 */ }
+  try { fs.rmdirSync(LINK_PATH); return true; } catch (_) { return false; }
+}
+
+/**
+ * 建立（或修正）目录联接。
+ * 三种非理想状态都必须处理，否则会出现「装上了但其实指向旧目录」的静默错误：
+ *   - 父目录不存在（全新 profile）  -> 自动创建
+ *   - 指向别的路径（换目录重装）    -> 删除后重建
+ *   - 死链（旧目录已被删）          -> 删除后重建
+ */
+function ensureLink() {
+  const parent = path.dirname(LINK_PATH);
+  const createdParent = !fs.existsSync(parent);
+  fs.mkdirSync(parent, { recursive: true });
+  if (createdParent) console.log('已创建目录 -> ' + parent);
+
+  const st = linkState();
+  if (st === 'dir') {
+    console.error('node_modules/' + NAME + ' 是一个真实目录，不是目录联接。');
+    console.error('为避免误删你的文件，安装器不做改动。请先手动移走它，再重新执行。');
+    process.exit(1);
+  }
+  if (st === 'ok') {
+    const cur = fs.realpathSync(LINK_PATH);
+    if (path.resolve(cur).toLowerCase() === path.resolve(PLUGIN_DIR).toLowerCase()) {
+      console.log('目录联接已存在，指向本目录 -> ' + LINK_PATH);
+      return;
+    }
+    console.log('目录联接原指向 ' + cur + '，与本次安装目录不同，正在重建。');
+    if (!removeLink()) {
+      console.error('无法删除旧联接：' + LINK_PATH);
+      process.exit(1);
+    }
+  } else if (st === 'dead') {
+    console.log('发现失效的目录联接（目标已不存在），重建中。');
+    if (!removeLink()) {
+      console.error('无法删除失效联接：' + LINK_PATH);
+      process.exit(1);
+    }
+  }
+
+  try {
+    fs.symlinkSync(PLUGIN_DIR, LINK_PATH, 'junction');
+  } catch (e) {
+    console.error('建立目录联接失败：' + (e && e.message || e));
+    console.error('常见原因：profile 目录无写入权限，或系统禁用了目录联接。profile 未被修改。');
+    process.exit(1);
+  }
+  console.log('已建立目录联接 -> ' + LINK_PATH);
+}
+
+/* ---------- 包完整性 ---------- */
+
+function checkAssets() {
+  const critical = ['host.js', 'client.js', 'cordis.patch.yml',
+                    'server/app.py', 'server/static/index.html', 'server/catalog.json'];
+  const optional = ['vendor/chatgpt2api/runtime/uv.exe', 'server/requirements.txt'];
+  const missing = critical.filter(f => !fs.existsSync(path.join(PLUGIN_DIR, f)));
+  if (missing.length) {
+    console.error('插件包不完整，缺少：' + missing.join('、'));
+    console.error('这通常是解压不完整或下载中断。请重新获取完整包后重试。');
+    process.exit(1);
+  }
+  for (const f of optional) {
+    if (!fs.existsSync(path.join(PLUGIN_DIR, f)))
+      console.warn('提醒：未找到 ' + f + '，首次启动时将改用系统 Python 或自动下载运行时。');
+  }
+}
+
+/* ---------- profile 配置 ---------- */
+
+let removedLegacy = false;
+
+/** 写入 dependencies 与 bundles，仅在确有变化时备份并落盘。 */
+function applyConfig() {
+  let changed = false;
+  if (uninstall) {
+    if (deps[NAME]) { delete deps[NAME]; changed = true; }
+    const i = bundles.indexOf(NAME);
+    if (i >= 0) { bundles.splice(i, 1); changed = true; }
+  } else {
+    const linkSpec = 'link:' + PLUGIN_DIR.replace(/\\/g, '/');
+    if (deps[NAME] !== linkSpec) { deps[NAME] = linkSpec; changed = true; }
+    if (!bundles.includes(NAME)) { bundles.push(NAME); changed = true; }
+    // 旧独立号池插件只从 bundle / 依赖里摘掉，文件与账号数据一律保留
+    if (deps[LEGACY]) { delete deps[LEGACY]; changed = true; removedLegacy = true; }
+    const j = bundles.indexOf(LEGACY);
+    if (j >= 0) { bundles.splice(j, 1); changed = true; removedLegacy = true; }
+  }
+
+  if (!changed) { console.log('profile 配置已经是目标状态，无需修改。'); return; }
+
+  // 写文件之前再确认一次目标文件没被别的进程改掉，降低覆盖别人改动的风险。
+  if (fs.readFileSync(PKG_FILE, 'utf8') !== raw) {
+    console.error('profile/package.json 在安装过程中被其他进程修改，已停止以免覆盖。');
+    console.error('请关闭 DSH 后重新执行，或手动核对配置。');
+    process.exit(1);
+  }
+
+  const stamp = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14);
+  const backup = PKG_FILE + '.bak_' + stamp;
+  fs.writeFileSync(backup, raw, 'utf8');
+  fs.writeFileSync(PKG_FILE, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+  console.log('已备份原配置 -> ' + backup);
+  console.log('已更新 -> ' + PKG_FILE);
+}
+
+/**
+ * 直接补/删 lock 的 importer 记录，不调用 pnpm install。
+ * link 依赖在 lock v9 里的标准写法（已实测，跨盘符时 specifier 与 version 都是绝对路径）。
+ * lock 不存在时跳过——DSH 下次执行 pnpm install 会自行生成。
+ */
+function dropLockEntry(text, name) {
+  const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  return text.replace(new RegExp('      ' + escaped + ':\\n(?:        [^\\n]*\\n){2}'), '');
+}
+
+function syncLock(linkSpec) {
+  if (!fs.existsSync(LOCK_FILE)) return;
+  const before = fs.readFileSync(LOCK_FILE, 'utf8');
+  const entry = '      ' + NAME + ':\n        specifier: ' + linkSpec + '\n        version: ' + linkSpec + '\n';
+  let after = before;
+  if (uninstall) after = dropLockEntry(after, NAME);
+  if (removedLegacy) after = dropLockEntry(after, LEGACY);
+  if (!uninstall && !before.includes('      ' + NAME + ':')) {
+    const marker = '\npackages:\n';
+    const at = after.indexOf(marker);
+    if (at < 0) { console.warn('lock 结构不符合预期，跳过（不影响插件加载）。'); return; }
+    after = after.slice(0, at) + entry + after.slice(at);
+  }
+  if (after === before) return;
+  const backup = LOCK_FILE + '.bak_' + new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14);
+  fs.writeFileSync(backup, before, 'utf8');
+  fs.writeFileSync(LOCK_FILE, after, 'utf8');
+  console.log('已备份并同步 -> ' + LOCK_FILE);
+}
+
+/* ---------- 后端代码同步 ---------- */
+
+/**
+ * 把开发目录 image-local/ 的纯代码同步进插件 server/。
+ * 只覆盖代码，绝不删目标里已有的图片、配置、数据库等运行态数据。
+ * 发布后的插件包旁边没有 image-local/，直接跳过，用包内自带的 server/。
+ */
+function syncServer() {
+  const src = path.resolve(PLUGIN_DIR, '..', 'image-local');
+  const dst = path.join(PLUGIN_DIR, 'server');
+  if (!fs.existsSync(path.join(src, 'app.py'))) {
+    console.log('旁边没有 image-local/，使用插件包内自带的 server/。');
+    return;
+  }
+  const skipDirs = new Set(['.venv', '__pycache__', 'images', 'thumbs', 'refs',
+                            'repo_images', 'workbench', '.pytest_cache']);
+  const skipFiles = new Set(['config.local.json', 'app.db', 'history.db', '.DS_Store']);
+  const junk = n => skipFiles.has(n) || /\.(log|pyc|db|vps_original)$/.test(n)
+                    || /\.bak_/.test(n);
+  // 开发机上的源文件可能是 CRLF，仓库里存的是 LF。不归一的话每次同步
+  // 都会把整个文件标成改动，commit 里几千行假 diff，历史没法看。
+  const textExt = new Set(['.py', '.html', '.js', '.mjs', '.json', '.txt',
+                           '.md', '.css', '.yml', '.yaml']);
+  const syncFile = (from, to) => {
+    if (!textExt.has(path.extname(from).toLowerCase())) {
+      fs.copyFileSync(from, to);
+      return;
+    }
+    const s = fs.readFileSync(from, 'utf8').replace(/\r\n?/g, '\n');
+    fs.writeFileSync(to, s, 'utf8');
+  };
+  let copied = 0;
+  const walk = (from, to) => {
+    fs.mkdirSync(to, { recursive: true });
+    for (const e of fs.readdirSync(from, { withFileTypes: true })) {
+      const a = path.join(from, e.name), b = path.join(to, e.name);
+      if (e.isDirectory()) { if (!skipDirs.has(e.name)) walk(a, b); continue; }
+      if (!e.isFile() || junk(e.name)) continue;
+      syncFile(a, b);
+      copied += 1;
+    }
+  };
+  walk(src, dst);
+  fs.writeFileSync(path.join(dst, 'requirements.txt'),
+                   'fastapi\nuvicorn\nhttpx\npydantic\npillow\npython-multipart\n', 'utf8');
+  console.log('已同步工作台后端代码 -> server/（' + copied + ' 个文件，不含账号/图片/配置）。');
+}
+
+/* ---------- 样图下载 ---------- */
+
+/**
+ * 安装时补齐真实样图（风格 / 图型 / 主题色预览）。
+ * 实现与 host.js 共用 scripts/fetch-style-images.mjs —— 一份逻辑两处调用，
+ * 免得「插件启动时补图」和「安装时补图」两套代码各自漂移。
+ */
+async function fetchStyleImages() {
+  const r = await fetchSamples({
+    serverDir: path.join(PLUGIN_DIR, 'server'),
+    log: text => console.log(text),
+  });
+  if (r.error) console.log('样图下载跳过：' + r.error);
+  if (r.fail) console.log('  ' + r.fail + ' 张失败（多为网络受限）。重跑 node install.mjs 可补齐，已存在的会自动跳过。');
+}
+
+/* ---------- 安装后自检 ---------- */
+
+function verify() {
+  const problems = [];
+  if (!bundles.includes(NAME)) problems.push('bundles 中未包含 ' + NAME);
+  if (!deps[NAME]) problems.push('dependencies 中未包含 ' + NAME);
+  if (linkState() !== 'ok') problems.push('目录联接不有效：' + LINK_PATH);
+  const viaLink = path.join(LINK_PATH, 'host.js');
+  if (!fs.existsSync(viaLink)) problems.push('通过目录联接读不到 host.js');
+  if (problems.length) {
+    console.error('自检未通过：');
+    for (const p of problems) console.error('  - ' + p);
+    return false;
+  }
+  console.log('自检通过：配置已注册，目录联接有效，插件文件可读。');
+  return true;
+}
+
+/* ---------- 主流程 ---------- */
+
+async function install() {
+  checkAssets();
+  syncServer();
+  ensureLink();          // 先建联接：失败则 profile 原样，不留半装
+  applyConfig();         // 再改配置
+  syncLock('link:' + PLUGIN_DIR.replace(/\\/g, '/'));
+  const ok = verify();
+  if (removedLegacy)
+    console.log('已摘除旧独立号池插件 ' + LEGACY + '（源码与账号数据保留，未删除）。');
+  await fetchStyleImages();
+  if (!ok) {
+    console.error('安装未完全成功，请根据上面的提示处理后重跑 node install.mjs。');
+    process.exit(1);
+  }
+  console.log('安装完成。多数情况下 DSH 会直接加载新 bundle；若侧栏未出现入口，完全退出 DSH 再启动一次。');
+  console.log('首次打开工作台会自动初始化后端与账号池，通常 1 分钟内就绪。');
+}
+
+if (!uninstall) {
+  install().catch(e => {
+    console.error('安装过程中发生异常：' + (e && e.stack || e));
+    process.exit(1);
+  });
+} else {
+  applyConfig();
+  syncLock('link:' + PLUGIN_DIR.replace(/\\/g, '/'));
+  // 断开联接：只删联接本身，不会碰插件源码目录与账号数据。
+  const st = linkState();
+  if (st === 'ok' || st === 'dead') {
+    console.log(removeLink() ? '已断开目录联接 -> ' + LINK_PATH : '警告：目录联接未能删除，可手动移除。');
+  } else if (st === 'dir') {
+    console.log('node_modules/' + NAME + ' 是真实目录，非联接，未做改动。');
+  }
+  console.log('已从 profile 摘除插件；插件源码目录与 ~/.dsh/chatgpt2api-image 数据保留。');
+  console.log('完全退出 DSH 再启动，侧栏入口即消失。确认不再需要时可自行删除源码目录。');
+}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "dsh-plugin-image-workbench",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.6",
+  "type": "module",
+  "description": "Bluxe手绘工坊 · 生图工作台（图文 / 摄影）：DSH 侧栏图像生成工作台，默认使用内置本地账号池，亦支持任意 OpenAI 兼容接口（Base URL / API Key / 模型）；可自定义工作台名称与图片存储目录。",
+  "main": "./host.js",
+  "exports": {
+    ".": "./host.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-layout"
+      ]
+    }
+  },
+  "files": [
+    "host.js",
+    "client.js",
+    "cordis.patch.yml",
+    "install.mjs",
+    "server/*.py",
+    "server/catalog.json",
+    "server/requirements.txt",
+    "server/static",
+    "vendor",
+    "scripts/vendor-snapshot.py",
+    "scripts/fetch-style-images.mjs"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guohwa/dsh-plugin-image-workbench.git"
+  },
+  "homepage": "https://github.com/guohwa/dsh-plugin-image-workbench#readme",
+  "bugs": {
+    "url": "https://github.com/guohwa/dsh-plugin-image-workbench/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "image-generation",
+    "openai-compatible",
+    "gpt-image",
+    "workbench"
+  ]
+}

package/scripts/fetch-style-images.mjs

@@ -0,0 +1,104 @@
+/**
+ * 样图下载器（风格 / 图型 / 主题色三类预览图）。
+ *
+ * 为什么要有这个文件：repo_images/ 里的 574 张样例图不进 npm 包（包体积会从
+ * 几百 KB 涨到十几 MB，而且图片本来就该放 CDN）。但工作台后端的 /img/{path}
+ * 在文件缺失时会返回一张渐变 SVG 占位图，于是全新安装打开「配色库 / 风格库」
+ * 全是色块 —— 看起来像装坏了。安装包里必须自带一次「把样图拉下来」的动作，
+ * 光靠 README 让用户手跑 `node install.mjs` 是不够的。
+ *
+ * 约定：
+ *   - 由 host.js 在插件启动时后台调用（不阻塞工作台启动），失败只写日志；
+ *   - install.mjs 也复用它，安装完顺手补齐，两处逻辑只有这一份；
+ *   - 幂等：已存在且非空的文件直接跳过，重跑只补缺失项；
+ *   - 只接受 image/* 响应，避免把 Gitee 的 302 登录页 HTML 写成 .webp 坏图。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+
+/** 样图源，按「CDN 单文件 → Gitee 镜像 → GitHub raw」顺序尝试。 */
+export const IMAGE_SOURCES = [
+  'https://img.handraw-style.com',
+  'https://gitee.com/yang02010/handraw-style/raw/master',
+  'https://raw.githubusercontent.com/yang0/handraw-style/main',
+];
+
+/** catalog.json 里 img 字段形如 images/individual/FA/FA-001.webp，落到 repo_images/ 时去掉 images/ 前缀。 */
+export function localPathOf(repoImages, rel) {
+  return path.join(repoImages, String(rel).replace(/^images\//, ''));
+}
+
+/** 从 catalog.json 收集需要下载的样图相对路径（去重）。 */
+export function collectRels(serverDir) {
+  const file = path.join(serverDir, 'catalog.json');
+  const rels = [];
+  const cat = JSON.parse(fs.readFileSync(file, 'utf8'));
+  for (const key of ['styles', 'layouts', 'colors']) {
+    for (const item of cat[key] || []) if (item && item.img) rels.push(item.img);
+  }
+  return [...new Set(rels)];
+}
+
+/**
+ * 下载缺失样图。
+ * @param {{serverDir:string, log?:Function, concurrency?:number, timeoutMs?:number, sources?:string[]}} opts
+ * @returns {Promise<{ok:boolean, total:number, done:number, skip:number, fail:number, error?:string}>}
+ */
+export async function fetchStyleImages(opts = {}) {
+  const serverDir = opts.serverDir;
+  const log = opts.log || (() => {});
+  const concurrency = Math.max(1, Math.min(24, opts.concurrency || 12));
+  const timeoutMs = opts.timeoutMs || 15000;
+  const sources = opts.sources || IMAGE_SOURCES;
+  if (!serverDir) return { ok: false, total: 0, done: 0, skip: 0, fail: 0, error: '缺少 serverDir' };
+
+  const repoImages = path.join(serverDir, 'repo_images');
+  let rels = [];
+  try {
+    rels = collectRels(serverDir);
+  } catch (e) {
+    return { ok: false, total: 0, done: 0, skip: 0, fail: 0,
+             error: '读取 catalog.json 失败：' + (e && e.message || e) };
+  }
+  if (!rels.length) return { ok: true, total: 0, done: 0, skip: 0, fail: 0 };
+
+  fs.mkdirSync(repoImages, { recursive: true });
+  const exists = p => { try { return fs.statSync(p).size > 0; } catch { return false; } };
+
+  const missing = rels.filter(rel => !exists(localPathOf(repoImages, rel)));
+  const skip = rels.length - missing.length;
+  if (!missing.length) return { ok: true, total: rels.length, done: 0, skip, fail: 0 };
+
+  log(`正在下载缺失样图 ${missing.length} 张（共 ${rels.length} 张，已存在 ${skip} 张）…`);
+  let done = 0, fail = 0;
+
+  const getOne = async rel => {
+    const dst = localPathOf(repoImages, rel);
+    fs.mkdirSync(path.dirname(dst), { recursive: true });
+    for (const base of sources) {
+      const url = base.replace(/\/$/, '') + '/' + String(rel).replace(/^\/+/, '');
+      try {
+        const ac = new AbortController();
+        const timer = setTimeout(() => ac.abort(), timeoutMs);
+        const res = await fetch(url, { signal: ac.signal, redirect: 'follow' });
+        clearTimeout(timer);
+        if (!res.ok) continue;
+        const type = (res.headers.get('content-type') || '').toLowerCase();
+        if (!type.startsWith('image/')) continue;
+        const buf = Buffer.from(await res.arrayBuffer());
+        if (buf.length < 200) continue;
+        fs.writeFileSync(dst, buf);
+        done += 1;
+        return;
+      } catch { /* 换下一个源 */ }
+    }
+    fail += 1;
+  };
+
+  for (let i = 0; i < missing.length; i += concurrency) {
+    await Promise.all(missing.slice(i, i + concurrency).map(getOne));
+  }
+
+  log(`样图下载结束：已下 ${done} 张，跳过 ${skip} 张，失败 ${fail} 张`);
+  return { ok: fail === 0, total: rels.length, done, skip, fail };
+}

package/scripts/vendor-snapshot.py

@@ -0,0 +1,154 @@
+"""把本机一份 ChatGPT2API 号池源码，做成插件自带的 vendor 快照。
+
+用途：工作台插件发布到别的机器时，不再要求对方先装任何第三方号池插件。
+这个脚本只在「升级号池源码」时手动跑一次，日常运行完全不依赖它。
+
+用法：
+    python vendor-snapshot.py [源号池 home 目录]
+
+默认源：~/.dsh/chatgpt2api-image
+输出：  <插件目录>/vendor/chatgpt2api/
+
+严格排除：账号库 data/、虚拟环境 .venv/、日志、备份、缓存、明文密钥与代理配置。
+config.json 会被清洗成 config.default.json（auth-key / proxy / 云存储凭据一律置空）。
+"""
+from __future__ import annotations
+
+import json
+import os
+import shutil
+import sys
+from pathlib import Path
+
+PLUGIN_DIR = Path(__file__).resolve().parent.parent
+OUT = PLUGIN_DIR / "vendor" / "chatgpt2api"
+
+# 只带运行需要的代码与静态资源，不带文档 / 测试 / 容器配置
+DIRS = ["api", "services", "utils", "web", "assets", "scripts"]
+FILES = ["main.py", "pyproject.toml", "uv.lock", ".python-version",
+         ".env.example", "LICENSE", "README.md", "VERSION"]
+
+EXCLUDE_NAMES = {"__pycache__", ".git", ".codex", ".pytest_cache", ".mypy_cache"}
+EXCLUDE_SUFFIX = (".pyc", ".pyo", ".log", ".db", ".db-shm", ".db-wal", ".enc")
+
+
+def keep(p: Path) -> bool:
+    n = p.name
+    if n in EXCLUDE_NAMES or n.startswith(".dsh-"):
+        return False
+    if n.endswith(EXCLUDE_SUFFIX) or ".bak" in n or n.endswith(".tmp"):
+        return False
+    return True
+
+
+def clean_config(raw: dict) -> dict:
+    """出厂默认配置：任何凭据、代理、本机状态都不带进插件包。"""
+    d = json.loads(json.dumps(raw))          # 深拷贝
+    d["auth-key"] = ""
+    d["proxy"] = ""
+    pr = d.get("proxy_runtime") or {}
+    pr["enabled"] = False
+    pr["proxy_url"] = ""
+    pr["resource_proxy_url"] = ""
+    cl = pr.get("clearance") or {}
+    cl["cf_cookies"] = ""
+    cl["cf_clearance"] = ""
+    d["backup"] = {**(d.get("backup") or {}),
+                   "enabled": False, "access_key_id": "",
+                   "secret_access_key": "", "passphrase": ""}
+    d["ai_review"] = {**(d.get("ai_review") or {}),
+                      "enabled": False, "base_url": "", "api_key": ""}
+    img = d.get("image_storage") or {}
+    img.update({"enabled": False, "webdav_username": "", "webdav_password": ""})
+    return d
+
+
+def main() -> int:
+    home = Path(sys.argv[1]) if len(sys.argv) > 1 else (
+        Path(os.environ.get("DSH_HOME", Path.home() / ".dsh")) / "chatgpt2api-image")
+    src = home / "source"
+    if not (src / "main.py").is_file():
+        print("找不到号池源码：" + str(src))
+        return 1
+    if OUT.resolve() == src.resolve():
+        print("源目录不能是 vendor 输出目录")
+        return 1
+
+    if OUT.exists():
+        shutil.rmtree(OUT)
+    (OUT / "source").mkdir(parents=True)
+    (OUT / "runtime").mkdir(parents=True)
+
+    copied = 0
+    for d in DIRS:
+        s = src / d
+        if not s.is_dir():
+            continue
+        shutil.copytree(s, OUT / "source" / d, ignore=lambda _, names: [
+            n for n in names if not keep(Path(n))], dirs_exist_ok=True)
+        copied += sum(1 for _ in (OUT / "source" / d).rglob("*") if _.is_file())
+    for f in FILES:
+        s = src / f
+        if s.is_file() and keep(s):
+            shutil.copy2(s, OUT / "source" / f)
+            copied += 1
+
+    cfg = src / "config.json"
+    if cfg.is_file():
+        try:
+            data = clean_config(json.loads(cfg.read_text(encoding="utf-8")))
+            (OUT / "source" / "config.default.json").write_text(
+                json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+            copied += 1
+        except Exception as e:
+            print("警告：config.json 清洗失败，未生成默认配置：" + str(e))
+
+    uv = ""
+    for c in (home / "runtime" / "uv.exe", home / "runtime" / "uv",
+              shutil.which("uv") or ""):
+        if c and Path(c).is_file():
+            uv = str(c)
+            break
+    if uv:
+        shutil.copy2(uv, OUT / "runtime" / Path(uv).name)
+        copied += 1
+    else:
+        print("警告：没找到 uv.exe，全新机器初始化时会退回系统 Python + pip")
+
+    note = """# 内置号池运行时
+
+本目录是 ChatGPT2API 号池服务端的**代码快照**，随「Bluxe手绘工坊 · 生图工作台」插件一起分发，
+安装后由工作台后端（pool_service.py）释放到本机数据目录并自建虚拟环境。
+
+* 后端上游：[basketikun/chatgpt2api](https://github.com/basketikun/chatgpt2api)，`source/VERSION` 与 `SOURCE.json` 记录快照版本；DSH 插件封装：[yang0/chatgpt2api-dsh](https://github.com/yang0/chatgpt2api-dsh)。
+* 许可：MIT License，Copyright (c) 2026 kunkun，LICENSE 原文见 `source/LICENSE`。本目录仅快照后端源码，不含 DSH 插件外壳与任何账号数据。
+* 已包含本工作台需要的两处补丁：round-robin 游标持久化、限流号排除；首次初始化时还会幂等复打一次。
+* **不含**任何账号、token、密钥、代理配置或图片数据。`source/config.default.json` 是清洗后的出厂默认配置。
+* 升级方式：改完本机号池源码后，重跑 `scripts/vendor-snapshot.py`，再重新发布插件。
+
+分工：工作台插件负责「拉起并守护」号池进程；本目录只提供「能跑起来的代码」。
+两者都不需要安装任何第三方 DSH 插件。
+"""
+    (OUT / "README.md").write_text(note, encoding="utf-8")
+    (OUT / "SOURCE.json").write_text(json.dumps({
+        "name": "chatgpt2api", "license": "MIT",
+        "version": (src / "VERSION").read_text(encoding="utf-8").strip()
+        if (src / "VERSION").is_file() else "",
+        "python": (src / ".python-version").read_text(encoding="utf-8").strip()
+        if (src / ".python-version").is_file() else "",
+        "files": copied,
+        "version_source": "source/VERSION",
+        "copyright": "Copyright (c) 2026 kunkun",
+        "upstream_backend": "https://github.com/basketikun/chatgpt2api",
+        "upstream_dsh_plugin": "https://github.com/yang0/chatgpt2api-dsh",
+    }, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+
+    size = sum(f.stat().st_size for f in OUT.rglob("*") if f.is_file())
+    print("vendor 已生成：" + str(OUT))
+    print("文件数 %d，体积 %.1f MB" % (copied, size / 1024 / 1024))
+    print("含 uv 运行时：" + ("是" if uv else "否"))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())