@dickpy/dsh-imagegen 1.5.6 → 1.5.7

package/src/model-catalog.ts

@@ -1,124 +1,149 @@
-/**
- * Model catalog: protocol-family detection and capability annotation shared by
- * the engine, the settings card, and the panel. Known id patterns map onto the
- * OpenAI-compatible image protocol families this plugin shapes requests for;
- * anything unrecognized falls back to the generic OpenAI protocol (best
- * effort) and is flagged as unknown so the UI can warn without blocking.
- *
- * Framework-free (pure data + regex), safe for the client bundle to inline.
- */
-
-export type ModelFamily = 'gpt-image' | 'dall-e' | 'grok' | 'nanobanana' | 'seedream' | 'zhipu' | 'qwen' | 'unknown'
-
-/** Capability/identity annotation for one model id. */
-export interface ModelCatalogEntry {
-  /** Family the request is shaped for. */
-  family: ModelFamily
-  /** Short badge label (en). */
-  label: string
-  /** Short badge label (zh). */
-  labelZh: string
-  /** Whether the family is known (false = best-effort OpenAI protocol). */
-  known: boolean
-  /** Whether the family supports image-to-image edits. */
-  supportsEdit: boolean
-  /** Whether the family natively takes aspect-ratio dials. */
-  supportsAspectRatio: boolean
-  /** Quality tiers the family interprets natively. */
-  qualityTiers: string[]
-}
-
-const ENTRIES: Record<Exclude<ModelFamily, 'unknown'>, Omit<ModelCatalogEntry, 'family'>> = {
-  'gpt-image': {
-    label: 'gpt-image',
-    labelZh: 'GPT 图像',
-    known: true,
-    supportsEdit: true,
-    supportsAspectRatio: false,
-    qualityTiers: ['1K', '2K', '4K'],
-  },
-  'dall-e': {
-    label: 'DALL·E',
-    labelZh: 'DALL·E',
-    known: true,
-    supportsEdit: true,
-    supportsAspectRatio: false,
-    qualityTiers: ['auto'],
-  },
-  grok: {
-    label: 'grok',
-    labelZh: 'Grok',
-    known: true,
-    supportsEdit: true,
-    supportsAspectRatio: true,
-    qualityTiers: ['1K', '2K'],
-  },
-  nanobanana: {
-    label: 'nanobanana',
-    labelZh: 'Nano Banana',
-    known: true,
-    supportsEdit: true,
-    supportsAspectRatio: true,
-    qualityTiers: ['1K', '2K', '4K'],
-  },
-  seedream: {
-    label: 'seedream',
-    labelZh: 'Seedream',
-    known: true,
-    supportsEdit: true,
-    supportsAspectRatio: true,
-    qualityTiers: ['1K', '2K'],
-  },
-  zhipu: {
-    label: 'GLM-Image',
-    labelZh: '智谱图像',
-    known: true,
-    supportsEdit: false,
-    supportsAspectRatio: false,
-    qualityTiers: ['HD'],
-  },
-  qwen: {
-    label: 'qwen-image',
-    labelZh: '千问图像',
-    known: true,
-    supportsEdit: true,
-    supportsAspectRatio: true,
-    qualityTiers: ['auto'],
-  },
-}
-
-/** Official Gemini image ids served by Nano Banana gateways. */
-const NANOBANANA_GEMINI_IDS = new Set([
-  'gemini-3-pro-image',
-  'gemini-3-pro-image-preview',
-  'gemini-3.1-flash-image',
-  'gemini-3.1-flash-image-preview',
-  'gemini-3.1-flash-lite-image',
-  'gemini-2.5-flash-image',
-])
-
-/** Classify one upstream model id into its request-shaping family. */
-export function describeModel(model: string): ModelCatalogEntry {
-  const id = model.trim()
-  if (/^gpt-image/i.test(id)) return { family: 'gpt-image', ...ENTRIES['gpt-image'] }
-  if (/^dall-e/i.test(id)) return { family: 'dall-e', ...ENTRIES['dall-e'] }
-  if (/^grok-imagine(?:-|$)/.test(id)) return { family: 'grok', ...ENTRIES.grok }
-  if (/^nanobanana/i.test(id) || NANOBANANA_GEMINI_IDS.has(id)) return { family: 'nanobanana', ...ENTRIES.nanobanana }
-  if (/^(?:doubao-)?seedream/i.test(id)) return { family: 'seedream', ...ENTRIES.seedream }
-  if (/^(?:glm-image|cogview(?:-|$))/i.test(id)) return { family: 'zhipu', ...ENTRIES.zhipu }
-  if (/^qwen-image(?:[-_.]|$)/i.test(id)) return { family: 'qwen', ...ENTRIES.qwen }
-  return { family: 'unknown', label: 'unknown', labelZh: '未知协议', known: false, supportsEdit: true, supportsAspectRatio: false, qualityTiers: [] }
-}
-
-/** Conservative fallback for providers whose /models response only has ids.
- *  Metadata-aware filtering lives in prompt-enhancer.ts; this catches common
- *  image model naming conventions without treating every unknown model as an
- *  image model. */
-export function isLikelyImageModelId(model: string): boolean {
-  return /(?:^|[-_.])(?:image|img|diffusion|flux|cogview|imagen|seedream|nanobanana|grok-imagine|dall-e|stable-diffusion|sdxl|pixart|kolors|ideogram|midjourney|recraft|hunyuan|jimeng|wanx|hidream|playground)(?:$|[-_.])/i.test(model.trim())
-}
-
-/** The family a model id routes its request through. */
-export function modelFamily(model: string): ModelFamily {
-  return describeModel(model).family
-}
+/**
+ * Model catalog: protocol-family detection and capability annotation shared by
+ * the engine, the settings card, and the panel. Known id patterns map onto the
+ * OpenAI-compatible image protocol families this plugin shapes requests for;
+ * anything unrecognized falls back to the generic OpenAI protocol (best
+ * effort) and is flagged as unknown so the UI can warn without blocking.
+ *
+ * Framework-free (pure data + regex), safe for the client bundle to inline.
+ */
+
+export type ModelFamily = 'gpt-image' | 'dall-e' | 'grok' | 'nanobanana' | 'seedream' | 'zhipu' | 'qwen' | 'minimax' | 'unknown'
+
+/** Capability/identity annotation for one model id. */
+export interface ModelCatalogEntry {
+  /** Family the request is shaped for. */
+  family: ModelFamily
+  /** Short badge label (en). */
+  label: string
+  /** Short badge label (zh). */
+  labelZh: string
+  /** Whether the family is known (false = best-effort OpenAI protocol). */
+  known: boolean
+  /** Whether the family supports image-to-image edits. */
+  supportsEdit: boolean
+  /** Whether the family natively takes aspect-ratio dials. */
+  supportsAspectRatio: boolean
+  /** Quality tiers the family interprets natively. */
+  qualityTiers: string[]
+}
+
+const ENTRIES: Record<Exclude<ModelFamily, 'unknown'>, Omit<ModelCatalogEntry, 'family'>> = {
+  'gpt-image': {
+    label: 'gpt-image',
+    labelZh: 'GPT 图像',
+    known: true,
+    supportsEdit: true,
+    supportsAspectRatio: false,
+    qualityTiers: ['1K', '2K', '4K'],
+  },
+  'dall-e': {
+    label: 'DALL·E',
+    labelZh: 'DALL·E',
+    known: true,
+    supportsEdit: true,
+    supportsAspectRatio: false,
+    qualityTiers: ['auto'],
+  },
+  grok: {
+    label: 'grok',
+    labelZh: 'Grok',
+    known: true,
+    supportsEdit: true,
+    supportsAspectRatio: true,
+    qualityTiers: ['1K', '2K'],
+  },
+  nanobanana: {
+    label: 'nanobanana',
+    labelZh: 'Nano Banana',
+    known: true,
+    supportsEdit: true,
+    supportsAspectRatio: true,
+    qualityTiers: ['1K', '2K', '4K'],
+  },
+  seedream: {
+    label: 'seedream',
+    labelZh: 'Seedream',
+    known: true,
+    supportsEdit: true,
+    supportsAspectRatio: true,
+    qualityTiers: ['1K', '2K'],
+  },
+  zhipu: {
+    label: 'GLM-Image',
+    labelZh: '智谱图像',
+    known: true,
+    supportsEdit: false,
+    supportsAspectRatio: false,
+    qualityTiers: ['HD'],
+  },
+  qwen: {
+    label: 'qwen-image',
+    labelZh: '千问图像',
+    known: true,
+    supportsEdit: true,
+    supportsAspectRatio: true,
+    qualityTiers: ['auto'],
+  },
+  minimax: {
+    label: 'MiniMax',
+    labelZh: 'MiniMax 图像',
+    known: true,
+    supportsEdit: true,
+    supportsAspectRatio: true,
+    qualityTiers: ['auto'],
+  },
+}
+
+/** Documented upstream prompt hard limits (UTF-16 code units). The engine
+ *  fast-fails on these before any network call and the panel counter shows
+ *  them live; families absent here have no documented limit. */
+const PROMPT_CHAR_LIMITS: Partial<Record<Exclude<ModelFamily, 'unknown'>, number>> = {
+  // MiniMax image-01 rejects prompts >= 1500 chars upstream (base_resp 2013).
+  minimax: 1500,
+}
+
+/** The documented prompt character limit for a model id, or null when the
+ *  family has no known limit. Single source of truth for engine enforcement
+ *  and the panel's live counter. */
+export function promptCharLimit(model: string): number | null {
+  const { family } = describeModel(model)
+  return (family !== 'unknown' ? PROMPT_CHAR_LIMITS[family] : undefined) ?? null
+}
+
+/** Official Gemini image ids served by Nano Banana gateways. */
+const NANOBANANA_GEMINI_IDS = new Set([
+  'gemini-3-pro-image',
+  'gemini-3-pro-image-preview',
+  'gemini-3.1-flash-image',
+  'gemini-3.1-flash-image-preview',
+  'gemini-3.1-flash-lite-image',
+  'gemini-2.5-flash-image',
+])
+
+/** Classify one upstream model id into its request-shaping family. */
+export function describeModel(model: string): ModelCatalogEntry {
+  const id = model.trim()
+  if (/^gpt-image/i.test(id)) return { family: 'gpt-image', ...ENTRIES['gpt-image'] }
+  if (/^dall-e/i.test(id)) return { family: 'dall-e', ...ENTRIES['dall-e'] }
+  if (/^grok-imagine(?:-|$)/.test(id)) return { family: 'grok', ...ENTRIES.grok }
+  if (/^nanobanana/i.test(id) || NANOBANANA_GEMINI_IDS.has(id)) return { family: 'nanobanana', ...ENTRIES.nanobanana }
+  if (/^(?:doubao-)?seedream/i.test(id)) return { family: 'seedream', ...ENTRIES.seedream }
+  if (/^(?:glm-image|cogview(?:-|$))/i.test(id)) return { family: 'zhipu', ...ENTRIES.zhipu }
+  if (/^qwen-image(?:[-_.]|$)/i.test(id)) return { family: 'qwen', ...ENTRIES.qwen }
+  if (/^(?:minimax[-_/])?image-\d+/i.test(id)) return { family: 'minimax', ...ENTRIES.minimax }
+  return { family: 'unknown', label: 'unknown', labelZh: '未知协议', known: false, supportsEdit: true, supportsAspectRatio: false, qualityTiers: [] }
+}
+
+/** Conservative fallback for providers whose /models response only has ids.
+ *  Metadata-aware filtering lives in prompt-enhancer.ts; this catches common
+ *  image model naming conventions without treating every unknown model as an
+ *  image model. */
+export function isLikelyImageModelId(model: string): boolean {
+  return /(?:^|[-_.])(?:image|img|diffusion|flux|cogview|imagen|seedream|nanobanana|grok-imagine|dall-e|stable-diffusion|sdxl|pixart|kolors|ideogram|midjourney|recraft|hunyuan|jimeng|wanx|hidream|playground)(?:$|[-_.])/i.test(model.trim())
+}
+
+/** The family a model id routes its request through. */
+export function modelFamily(model: string): ModelFamily {
+  return describeModel(model).family
+}

package/src/presets.ts

@@ -1,86 +1,95 @@
-/**
- * Built-in provider catalog (presets). A preset is an official or well-known
- * OpenAI-compatible endpoint with its known model list, so the user only fills
- * in the API key. The list ships with the package and is served to the
- * settings card through a host route, so it can later be refreshed online like
- * the template library.
- *
- * Framework-free (pure data), safe for the host routes to serve directly.
- */
-
-import type { ModelMapping } from './protocol.ts'
-
-/** One built-in provider the settings card can instantiate a channel from. */
-export interface PresetProvider {
-  /** Stable preset id stored on channels created from it ('' = custom). */
-  id: string
-  /** Display name shown in the picker (also the channel's default name). */
-  name: string
-  /** Official base URL prefilled into the channel. */
-  apiUrl: string
-  /** One-line description shown in the picker. */
-  hint: string
-  /** Known model list prefilled into the channel's model catalog. */
-  models: ModelMapping[]
-}
-
-export const IMAGE_PRESETS: PresetProvider[] = [
-  {
-    id: 'volc-ark-seedream',
-    name: '字节 · 火山方舟（Seedream）',
-    apiUrl: 'https://ark.cn-beijing.volces.com/api/v3',
-    hint: '字节跳动官方 Seedream 文生图/图生图入口',
-    models: [
-      { alias: 'seedream-5.0-pro', id: 'seedream-5.0-pro' },
-      { alias: 'seedream-5.0', id: 'seedream-5.0' },
-      { alias: 'seedream-4.0', id: 'seedream-4.0' },
-    ],
-  },
-  {
-    id: 'openai-official',
-    name: 'OpenAI 官方',
-    apiUrl: 'https://api.openai.com/v1',
-    hint: 'OpenAI 官方图像生成接口',
-    models: [
-      { alias: 'gpt-image-2', id: 'gpt-image-2' },
-    ],
-  },
-  {
-    id: 'zhipu-official',
-    name: '智谱 AI 官方',
-    apiUrl: 'https://open.bigmodel.cn/api/paas/v4',
-    hint: '智谱官方 GLM-Image 图像生成接口',
-    models: [
-      { alias: 'glm-image', id: 'glm-image' },
-    ],
-  },
-  {
-    id: 'aliyun-dashscope-qwen',
-    name: '阿里云百炼（Qwen-Image）',
-    apiUrl: 'https://dashscope.aliyuncs.com/api/v1',
-    hint: '阿里云百炼 DashScope 原生接口：通义千问 Qwen-Image 系列（该渠道不可复用于提示词增强）',
-    models: [
-      { alias: 'qwen-image-3.0-pro', id: 'qwen-image-3.0-pro' },
-      { alias: 'qwen-image-3.0', id: 'qwen-image-3.0' },
-      { alias: 'qwen-image-2.0-pro', id: 'qwen-image-2.0-pro' },
-      { alias: 'qwen-image-2.0', id: 'qwen-image-2.0' },
-      { alias: 'qwen-image-max', id: 'qwen-image-max' },
-      { alias: 'qwen-image-plus', id: 'qwen-image-plus' },
-      { alias: 'qwen-image', id: 'qwen-image' },
-    ],
-  },
-  {
-    id: 'xai-grok',
-    name: 'xAI（Grok）',
-    apiUrl: 'https://api.x.ai/v1',
-    hint: 'xAI 官方接口：Grok Imagine 系列',
-    models: [
-      { alias: 'grok-imagine-image', id: 'grok-imagine-image' },
-    ],
-  },
-]
-
-/** Look up one built-in provider by id. */
-export function presetById(id: string): PresetProvider | undefined {
-  return IMAGE_PRESETS.find(preset => preset.id === id)
-}
+/**
+ * Built-in provider catalog (presets). A preset is an official or well-known
+ * OpenAI-compatible endpoint with its known model list, so the user only fills
+ * in the API key. The list ships with the package and is served to the
+ * settings card through a host route, so it can later be refreshed online like
+ * the template library.
+ *
+ * Framework-free (pure data), safe for the host routes to serve directly.
+ */
+
+import type { ModelMapping } from './protocol.ts'
+
+/** One built-in provider the settings card can instantiate a channel from. */
+export interface PresetProvider {
+  /** Stable preset id stored on channels created from it ('' = custom). */
+  id: string
+  /** Display name shown in the picker (also the channel's default name). */
+  name: string
+  /** Official base URL prefilled into the channel. */
+  apiUrl: string
+  /** One-line description shown in the picker. */
+  hint: string
+  /** Known model list prefilled into the channel's model catalog. */
+  models: ModelMapping[]
+}
+
+export const IMAGE_PRESETS: PresetProvider[] = [
+  {
+    id: 'volc-ark-seedream',
+    name: '字节 · 火山方舟（Seedream）',
+    apiUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+    hint: '字节跳动官方 Seedream 文生图/图生图入口',
+    models: [
+      { alias: 'seedream-5.0-pro', id: 'seedream-5.0-pro' },
+      { alias: 'seedream-5.0', id: 'seedream-5.0' },
+      { alias: 'seedream-4.0', id: 'seedream-4.0' },
+    ],
+  },
+  {
+    id: 'openai-official',
+    name: 'OpenAI 官方',
+    apiUrl: 'https://api.openai.com/v1',
+    hint: 'OpenAI 官方图像生成接口',
+    models: [
+      { alias: 'gpt-image-2', id: 'gpt-image-2' },
+    ],
+  },
+  {
+    id: 'zhipu-official',
+    name: '智谱 AI 官方',
+    apiUrl: 'https://open.bigmodel.cn/api/paas/v4',
+    hint: '智谱官方 GLM-Image 图像生成接口',
+    models: [
+      { alias: 'glm-image', id: 'glm-image' },
+    ],
+  },
+  {
+    id: 'aliyun-dashscope-qwen',
+    name: '阿里云百炼（Qwen-Image）',
+    apiUrl: 'https://dashscope.aliyuncs.com/api/v1',
+    hint: '阿里云百炼 DashScope 原生接口：通义千问 Qwen-Image 系列（该渠道不可复用于提示词增强）',
+    models: [
+      { alias: 'qwen-image-3.0-pro', id: 'qwen-image-3.0-pro' },
+      { alias: 'qwen-image-3.0', id: 'qwen-image-3.0' },
+      { alias: 'qwen-image-2.0-pro', id: 'qwen-image-2.0-pro' },
+      { alias: 'qwen-image-2.0', id: 'qwen-image-2.0' },
+      { alias: 'qwen-image-max', id: 'qwen-image-max' },
+      { alias: 'qwen-image-plus', id: 'qwen-image-plus' },
+      { alias: 'qwen-image', id: 'qwen-image' },
+    ],
+  },
+  {
+    id: 'minimax-official',
+    name: 'MiniMax 官方（国际站）',
+    apiUrl: 'https://api.minimax.io/v1',
+    hint: 'MiniMax 原生 /image_generation 接口：image-01（国内站请把地址改为 https://api.minimaxi.com/v1；/models 不列出图片模型，请直接使用预填目录）',
+    models: [
+      { alias: 'image-01', id: 'image-01' },
+    ],
+  },
+  {
+    id: 'xai-grok',
+    name: 'xAI（Grok）',
+    apiUrl: 'https://api.x.ai/v1',
+    hint: 'xAI 官方接口：Grok Imagine 系列',
+    models: [
+      { alias: 'grok-imagine-image', id: 'grok-imagine-image' },
+    ],
+  },
+]
+
+/** Look up one built-in provider by id. */
+export function presetById(id: string): PresetProvider | undefined {
+  return IMAGE_PRESETS.find(preset => preset.id === id)
+}