@goodandready/dsh-image-gen 0.10.21 → 0.10.23

package/README.md

@@ -41,6 +41,18 @@
 
 ---
 
+## 🚀 Updates v0.10.23: In-App Auto-Updater, Settings Synchronization, Active Probes & Language Purity (#232)
+* **One-Click In-App Auto-Updater**: Direct 1-click update support inside the plugin Settings Card (`UpdaterSection`) backed by `/api/dsh-image-gen/update`. Fetches the npm registry for release manifests, verifies semver differences, and securely triggers `dsh plugin add @goodandready/dsh-image-gen@latest` restricted to loopback and private LAN connections.
+* **1:1 Settings Synchronization**: Fully synchronized host `Config` schema in `lib/index.js` with client UI fields (`lib/client.js`), exposing `autoEnhancePrompt` and `defaultStylePreset` under the `✨ Enhancer` tab.
+* **Active Diagnostic Probes**: Added real HTTP network probes in `testProviderConnection` for Replicate (`/v1/models`), Google Gemini (`/v1beta/models`), and ByteDance Seedream with timeout protection and live roundtrip latency tracking.
+* **Strict Multi-Language Compliance**: Pure standard `en` and `zh` localization bundles embedded in core package; modularized Russian language support via `goodandready/dsh-russian-lang` per DSH plugin guidelines. Exactly 0 Cyrillic characters in product code (`lib/`).
+* **WAI-ARIA Accessibility Hardening**: Enhanced tab navigation and input form validation with `role="tablist"`, `role="tab"`, `aria-selected`, `aria-controls`, `role="tabpanel"`, `aria-describedby`, and `role="alert"`.
+
+## 🚀 Updates v0.10.22: Referential Stability & React Error #185 Infinite Loop Fix (#230)
+* **Settings Card Referential Stability**: Resolved React Error #185 (`Maximum update depth exceeded`) in `FalSettingsCardController` and `CardForm.prototype.bind`. Store snapshots are referentially cached during render cycles (`Object.is(prev, next) === true`), completely preventing infinite re-render loops in React 18 / `useSyncExternalStore`.
+* **Deep DSH Store Integration**: Added seamless runtime integration with `@deepseek-ai/dsh-client-store` (`runtime.createSnapshotStore`) paired with a robust standalone snapshot caching fallback.
+* **Automated Regression Test Suite**: Added dedicated referential identity test in `test/client-syntax.test.mjs` verifying snapshot immutability across repeated reads, single-notification publish triggers, and clean listener lifecycle.
+
 ## 🚀 Updates v0.10.21: Variations Workbench, Smart Aspect Ratio Crop & Brand Asset Pack (#228)
 * **Variations & Style Remix Workbench**: Interactive visual drawer embedded directly in `FalImageCard` and Gallery. Fine-tune variations with a continuous creativity / denoising strength slider (0.05 to 0.95), preset quick buttons ("Subtle 0.25", "Creative 0.65"), and prompt modifier guidance.
 * **Intelligent Aspect-Ratio Canvas Cropper & Resizer (`smart_crop_image`)**: Instant lossless aspect ratio framing for social and responsive surfaces (`1:1`, `16:9`, `9:16`, `4:3`, `3:2`, `2:3`) supporting focal heuristics (`auto_focus`, `center`, `rule_of_thirds`, `letterbox`) via zero-dependency pure Node.js SVG vector raster wrapper.

package/README.ru.md

@@ -34,6 +34,18 @@
 </div>
 
 ---
+## 🚀 Обновления v0.10.23: Встроенное автообновление, синхронизация настроек, диагностические пробы и чистота языка (#232)
+* **Встроенное обновление в 1 клик**: Прямая проверка и обновление плагина прямо из карточки настроек (`UpdaterSection`) через эндпоинт `/api/dsh-image-gen/update`. Опрашивает реестр npm, сравнивает semver-версии и безопасно запускает установку через `dsh plugin add` с защитой по loopback и доверенной локальной сети (RFC 1918).
+* **Синхронизация настроек 1:1**: Полное выравнивание схемы хоста `Config` в `lib/index.js` и полей UI `FIELDS` в `lib/client.js` — во вкладку «✨ Промпт и стили» добавлены тумблеры `autoEnhancePrompt` и выпадающий список `defaultStylePreset`.
+* **Активные диагностические пробы**: Добавлены реальные сетевые проверки в `testProviderConnection` для Replicate (`/v1/models`), Google Gemini (`/v1beta/models`) и ByteDance Seedream с защитой по тайм-ауту и замером сетевой задержки.
+* **Строгое соответствие стандарту мультиязычности**: Чистые стандартные словари `en` и `zh` в ядре плагина; русские переводы модульно вынесены в `goodandready/dsh-russian-lang` в соответствии с правилами DSH. Ровно 0 символов кириллицы в исходном коде (`lib/`).
+* **Доступность интерфейса (WAI-ARIA A11y)**: Реализована разметка вкладок и валидации форм с атрибутами `role="tablist"`, `role="tab"`, `aria-selected`, `aria-controls`, `role="tabpanel"`, `aria-describedby` и `role="alert"`.
+
+## 🚀 Обновления v0.10.22: Стабилизация состояния карточки настроек и устранение React Error #185 (#230)
+* **Референциальная стабильность карточки настроек**: Устранена критическая ошибка React #185 (`Maximum update depth exceeded`) в `FalSettingsCardController` и `CardForm.prototype.bind`. Снимки состояния кэшируются по ссылке (`Object.is(prev, next) === true`) во время циклов рендера, полностью предотвращая бесконечные циклы перерисовки в React 18 / `useSyncExternalStore`.
+* **Глубокая интеграция со стором DSH**: Добавлена бесшовная поддержка официального `@deepseek-ai/dsh-client-store` (`runtime.createSnapshotStore`) с автономным отказоустойчивым кэширующим fallback-режимом.
+* **Автоматические регрессионные тесты**: Добавлен специализированный тест стабильности ссылок в `test/client-syntax.test.mjs`, контролирующий идентичность снимков при последовательных чтениях, атомарность уведомлений и корректную отписку.
+
 ## 🚀 Обновления v0.10.21: Верстак вариаций, умный кроппер и экспорт бренд-ассетов (#228)
 * **Интерактивный верстак вариаций и ремиксов (Remix Workbench)**: Встроенная панель в `FalImageCard` и галерее генераций. Настройка силы вариаций ползунком креативности (0.05–0.95), быстрые пресеты («Тонкие правки 0.25», «Креатив 0.65») и текстовое до-руливание стилем.
 * **Умное кадрирование под стандарты пропорций (`smart_crop_image`)**: Мгновенный пересчет и кадрирование под соцсети и баннеры (`1:1`, `16:9`, `9:16`, `4:3`, `3:2`, `2:3`) с режимами центрирования, третей (`rule_of_thirds`), умного фокуса и рамки (`letterbox`) на чистом SVG без внешних бинарников.

package/README.zh.md

@@ -47,6 +47,18 @@
 
 ---
 
+## 🚀 更新 v0.10.23: 应用内一键更新、设置同步、真实探针与语言规范 (#232)
+* **应用内一键自动更新**: 设置卡片内新增「插件更新」模块（`UpdaterSection`），配合 `/api/dsh-image-gen/update` 接口。自动查询 npm 官方注册表，对比语义化版本号，并在本地回环或私有局域网安全授权下执行 `dsh plugin add @goodandready/dsh-image-gen@latest`。
+* **1:1 核心配置与界面设置同步**: 严格对齐 `lib/index.js` 宿主 `Config` 与 `lib/client.js` 界面字段，在「✨ 提示词增强」标签页下完整呈现 `autoEnhancePrompt`（智能自动增强提示词）与 `defaultStylePreset`（默认风格预设）。
+* **真实网络诊断探针**: 在 `testProviderConnection` 中为 Replicate (`/v1/models`)、Google Gemini (`/v1beta/models`) 及字节跳动 Seedream 增加带超时保护的真实 HTTP 网络探测与延迟往返测速。
+* **严格多语言纯度标准**: 核心代码完全遵照 DSH 插件规范，内置纯净完整的 `en` 和 `zh` 词典；俄语支持通过 `goodandready/dsh-russian-lang` 独立注册。`lib/` 源码中完全清理非拉丁字符。
+* **WAI-ARIA 无障碍访问支持**: 为标签页切换与表单错误提示加入 `role="tablist"`, `role="tab"`, `aria-selected`, `aria-controls`, `role="tabpanel"`, `aria-describedby` 和 `role="alert"`。
+
+## 🚀 更新 v0.10.22: 设置卡片状态引用稳定性与修复 React Error #185 无限循环 (#230)
+* **设置卡片状态引用稳定性**: 修复了 `FalSettingsCardController` 和 `CardForm.prototype.bind` 中引发的 React Error #185（`Maximum update depth exceeded`）。快照在渲染周期内进行引用缓存（`Object.is(prev, next) === true`），彻底杜绝 React 18 / `useSyncExternalStore` 的无限重新渲染死循环。
+* **深度 DSH 运行时集成**: 无缝集成官方 `@deepseek-ai/dsh-client-store`（`runtime.createSnapshotStore`），并提供零依赖的高性能独立快照缓存兜底。
+* **自动化回归测试集**: 在 `test/client-syntax.test.mjs` 中引入针对引用一致性的专项测试，严密校验多次连续读取的一致性、单次发布通知机制与监听器注销完整性。
+
 ## 🚀 更新 v0.10.21: 变体工作台、智能比例裁切与品牌资源包导出 (#228)
 * **交互式变体与风格重混工作台 (Remix Workbench)**: 直接集成在 `FalImageCard` 和图库中的交互抽屉。支持连续创意度/去噪强度滑块 (0.05 到 0.95)、预设快捷按钮（“微调 0.25”、“强创意 0.65”）及提示词引导。
 * **智能比例无损画布裁切器 (`smart_crop_image`)**: 快速裁切适配各大社交与设计标准比例 (`1:1`, `16:9`, `9:16`, `4:3`, `3:2`, `2:3`)，支持自动对焦、三分法构图 (`rule_of_thirds`) 与黑边留白 (`letterbox`)。

package/lib/client.js

@@ -17,12 +17,20 @@ window.__ModuleLoader__.load({
       }
     }
 
+    let runtime = null
+    for (const id of ['@deepseek-ai/dsh-client-store', '@deepseek-ai/dsh-client-runtime/client']) {
+      try {
+        runtime = require(id)
+        if (runtime && typeof runtime.createSnapshotStore === 'function') break
+      } catch (_) {}
+    }
+
     const NS = 'dsh-image-gen'
     const SETTINGS_NS = 'dsh-image-gen'
     const TITLE = 'Image Studio'
     const SUBTITLE = 'Multi-provider AI image generation, editing, upscale & vectorization.'
 
-    // Ядровый шеврон раскрытия; в урезанной сборке — запасной SVG той же формы.
+    // DSH UI primitives chevron icon with fallback SVG.
     let ChevronIcon = null
     try {
       const primitives = require('@deepseek-ai/dsh-client-ui-primitives')
@@ -266,6 +274,8 @@ window.__ModuleLoader__.load({
       { field: 'subscriptionQuality', spec: selectField('subscriptionQuality', ['', 'low', 'medium', 'high']), kind: 'select', options: ['', 'low', 'medium', 'high'], labelKey: 'f.subscriptionQuality', hintKey: 'f.subscriptionQualityHint', when: ['codex', 'grok'], tab: 'provider' },
 
       // Enhancer & Style
+      { field: 'autoEnhancePrompt', spec: booleanField('autoEnhancePrompt'), kind: 'select', options: ['true', 'false'], labelKey: 'f.autoEnhancePrompt', hintKey: 'f.autoEnhancePromptHint', tab: 'enhancer' },
+      { field: 'defaultStylePreset', spec: selectField('defaultStylePreset', STYLE_PRESET_OPTIONS), kind: 'select', options: STYLE_PRESET_OPTIONS, labelKey: 'f.defaultStylePreset', hintKey: 'f.defaultStylePresetHint', tab: 'enhancer' },
       { field: 'enhancePrompt', spec: booleanField('enhancePrompt'), kind: 'select', options: ['true', 'false'], labelKey: 'f.enhancePrompt', hintKey: 'f.enhancePromptHint', tab: 'enhancer' },
       { field: 'enableLlmEnhancer', spec: booleanField('enableLlmEnhancer'), kind: 'select', options: ['true', 'false'], labelKey: 'f.enableLlmEnhancer', hintKey: 'f.enableLlmEnhancerHint', tab: 'enhancer' },
       { field: 'enhanceModel', spec: textField('enhanceModel'), kind: 'text', labelKey: 'f.enhanceModel', hintKey: 'f.enhanceModelHint', placeholderKey: 'p.enhanceModel', tab: 'enhancer' },
@@ -298,11 +308,22 @@ window.__ModuleLoader__.load({
         }
       }
       bind(project) {
+        if (runtime && typeof runtime.createSnapshotStore === 'function') {
+          const store = runtime.createSnapshotStore(project())
+          this.listeners.add(() => store.set(project()))
+          return store
+        }
+        let cached = project()
+        const storeListeners = new Set()
+        this.listeners.add(() => {
+          cached = project()
+          for (const listener of storeListeners) listener()
+        })
         return {
-          getSnapshot: () => project(),
+          getSnapshot: () => cached,
           subscribe: (cb) => {
-            this.listeners.add(cb)
-            return () => this.listeners.delete(cb)
+            storeListeners.add(cb)
+            return () => storeListeners.delete(cb)
           },
         }
       }
@@ -494,16 +515,128 @@ window.__ModuleLoader__.load({
           className: invalid ? 'ig-input ig-input-invalid' : 'ig-input',
           type: 'text',
           ...(entry.kind === 'number' ? { inputMode: 'numeric' } : {}),
+          'aria-invalid': invalid ? true : undefined,
+          'aria-describedby': invalid ? id + '-err' : undefined,
           value: state.text,
           placeholder: entry.placeholderKey ? t(entry.placeholderKey) : '',
           disabled,
           onChange: (e) => onEdit(e.target.value),
         }),
-        react.createElement('p', { className: invalid ? 'ig-field-err' : 'ig-field-hint' }, invalid ? fieldProps.invalidLabel : hint)
+        react.createElement('p', {
+          id: invalid ? id + '-err' : undefined,
+          role: invalid ? 'alert' : undefined,
+          className: invalid ? 'ig-field-err' : 'ig-field-hint',
+        }, invalid ? fieldProps.invalidLabel : hint)
       )
     }
 
 
+
+    // -------------------------------------------------------------- Updater Section
+    function UpdaterSection(props) {
+      const t = props.t || ((k) => k)
+      const [status, setStatus] = react.useState(null)
+      const [loading, setLoading] = react.useState(false)
+      const [updating, setUpdating] = react.useState(false)
+      const [msg, setMsg] = react.useState(null)
+
+      const checkUpdate = react.useCallback(async () => {
+        setLoading(true)
+        setMsg(null)
+        try {
+          const res = await fetch('/api/dsh-image-gen/update', {
+            headers: { accept: 'application/json' },
+            cache: 'no-store',
+          })
+          if (!res.ok) throw new Error('HTTP ' + res.status)
+          const data = await res.json()
+          setStatus(data)
+        } catch (e) {
+          setMsg({ ok: false, text: (t('updater.failed') || 'Update check failed: ') + (e?.message || String(e)) })
+        } finally {
+          setLoading(false)
+        }
+      }, [t])
+
+      const onUpdateNow = async () => {
+        setUpdating(true)
+        setMsg(null)
+        try {
+          const res = await fetch('/api/dsh-image-gen/update', {
+            method: 'POST',
+            headers: {
+              'x-dsh-plugin-update': '1',
+              'content-type': 'application/json',
+            },
+          })
+          const data = await res.json()
+          if (!res.ok) throw new Error(data?.error || 'HTTP ' + res.status)
+          setStatus(data)
+          setMsg({ ok: true, text: t('updater.success') || 'Plugin updated successfully! Restart DSH to apply.' })
+        } catch (e) {
+          setMsg({ ok: false, text: e?.message || String(e) })
+        } finally {
+          setUpdating(false)
+        }
+      }
+
+      react.useEffect(() => {
+        checkUpdate()
+      }, [checkUpdate])
+
+      const currentVer = status?.currentVersion || '0.10.22'
+      const latestVer = status?.latestVersion
+      const updateAvailable = Boolean(status?.updateAvailable && latestVer && latestVer !== currentVer)
+
+      return react.createElement(
+        'div',
+        { className: 'ig-stat-box', style: { gap: '10px', marginTop: '12px' } },
+        react.createElement(
+          'div',
+          { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', flexWrap: 'wrap', gap: '8px' } },
+          react.createElement(
+            'div',
+            { style: { display: 'flex', alignItems: 'center', gap: '8px' } },
+            react.createElement('span', { style: { fontSize: '13px', fontWeight: 600, color: 'var(--dsw-alias-label-primary)' } }, '🔄 ' + t('updater.title')),
+            react.createElement('span', { className: 'ig-badge ' + (updateAvailable ? 'ig-badge-warn' : 'ig-badge-ok') },
+              updateAvailable ? 'v' + latestVer + ' available' : 'v' + currentVer + ' (' + t('updater.upToDate') + ')'
+            )
+          ),
+          react.createElement(
+            'div',
+            { style: { display: 'flex', gap: '8px' } },
+            updateAvailable
+              ? react.createElement(
+                  'button',
+                  {
+                    type: 'button',
+                    className: 'ig-btn ig-btn-primary',
+                    style: { padding: '4px 10px', fontSize: '12px' },
+                    onClick: onUpdateNow,
+                    disabled: updating || loading,
+                  },
+                  updating ? (t('updater.updating') || 'Updating…') : (t('updater.updateNow') || 'Update now').replace('{version}', latestVer)
+                )
+              : null,
+            react.createElement(
+              'button',
+              {
+                type: 'button',
+                className: 'ig-btn',
+                style: { padding: '4px 10px', fontSize: '12px' },
+                onClick: checkUpdate,
+                disabled: loading || updating,
+              },
+              loading ? (t('updater.checking') || 'Checking…') : (t('updater.check') || 'Check updates')
+            )
+          )
+        ),
+        msg
+          ? react.createElement('div', { className: msg.ok ? 'ig-alert-ok' : 'ig-alert-bad', style: { padding: '6px 10px', fontSize: '12px' } }, msg.text)
+          : null
+      )
+    }
+
     // -------------------------------------------------------------- Diagnostics Panel
     function DiagnosticsPanel(props) {
       const t = props.t || ((k) => k)
@@ -1046,13 +1179,17 @@ window.__ModuleLoader__.load({
               // Tab Navigation
               react.createElement(
                 'div',
-                { className: 'ig-tabs' },
+                { className: 'ig-tabs', role: 'tablist', 'aria-label': 'Settings Sections' },
                 tabs.map((tab) =>
                   react.createElement(
                     'button',
                     {
                       key: tab.id,
+                      id: 'tab-btn-' + tab.id,
                       type: 'button',
+                      role: 'tab',
+                      'aria-selected': activeTab === tab.id,
+                      'aria-controls': 'tab-panel-' + tab.id,
                       className: activeTab === tab.id ? 'ig-tab-btn ig-tab-btn-active' : 'ig-tab-btn',
                       onClick: () => setActiveTab(tab.id),
                     },
@@ -1063,7 +1200,13 @@ window.__ModuleLoader__.load({
               // Active Tab Fields
               react.createElement(
                 'div',
-                { style: { display: 'flex', flexDirection: 'column', gap: '8px' } },
+                {
+                  id: 'tab-panel-' + activeTab,
+                  role: 'tabpanel',
+                  'aria-labelledby': 'tab-btn-' + activeTab,
+                  style: { display: 'flex', flexDirection: 'column', gap: '8px' },
+                },
+                activeTab === 'general' ? react.createElement(UpdaterSection, { t }) : null,
                 currentTabFields.map((entry) =>
                   react.createElement(Field, {
                     key: entry.field,
@@ -1488,6 +1631,23 @@ window.__ModuleLoader__.load({
       'f.subscriptionQuality': 'Subscription Quality',
       'f.subscriptionQualityHint': 'Target quality profile when using Codex or Grok subscriptions.',
 
+      'f.autoEnhancePrompt': 'Auto Enhance Prompt',
+      'f.autoEnhancePromptHint': 'Enrich prompts with photography, lighting, and composition quality tokens.',
+      'f.defaultStylePreset': 'Default Style Preset',
+      'f.defaultStylePresetHint': 'Default style preset applied to generations (e.g. cinematic, anime, photorealistic).',
+      'p.defaultStylePreset': 'none',
+
+      'updater.title': 'Plugin Updates',
+      'updater.check': 'Check updates',
+      'updater.checking': 'Checking…',
+      'updater.current': 'Current version',
+      'updater.latest': 'Latest version',
+      'updater.upToDate': 'Up to date',
+      'updater.updateNow': 'Update to v{version}',
+      'updater.updating': 'Updating…',
+      'updater.success': 'Plugin updated successfully! Please restart DSH service.',
+      'updater.failed': 'Update check failed: ',
+
       'f.enhancePrompt': 'LLM Prompt Enhancer',
       'f.enhancePromptHint': 'Expand concise prompts with rich artistic details before generation.',
       'f.enableLlmEnhancer': 'Enable LLM Enhancer (Legacy)',
@@ -1675,6 +1835,16 @@ window.__ModuleLoader__.load({
       'f.defaultStylePresetHint': '生成图像时应用的默认艺术或摄影风格（如 cinematic, anime 等）。',
       'p.defaultStylePreset': 'none',
 
+      'updater.title': '插件更新',
+      'updater.check': '检查更新',
+      'updater.checking': '正在检查…',
+      'updater.current': '当前版本',
+      'updater.latest': '最新版本',
+      'updater.upToDate': '已是最新',
+      'updater.updateNow': '一键更新至 v{version}',
+      'updater.updating': '正在更新…',
+      'updater.success': '插件更新成功！请重启 DSH 服务以生效。',
+      'updater.failed': '更新检查失败：',
       'f.enhancePrompt': 'LLM 提示词扩展',
       'f.enhancePromptHint': '在生成前由会话模型自动丰富短提示词细节。',
       'f.enableLlmEnhancer': '启用 LLM 提示词增强 (Legacy)',
@@ -1711,190 +1881,6 @@ window.__ModuleLoader__.load({
       'p.cacheTtlDays': '0',
     }
 
-    const ru = {
-      'settings.navLabel': 'Image Studio',
-      'settings.title': 'Генерация изображений',
-      'settings.description': 'Мультипровайдерная студия: генерация, инпейнтинг, вариации, апскейл и векторизация.',
-      'settings.unavailable': 'Настройки плагина инициализируются. Они появятся автоматически через несколько секунд.',
-      'settings.unsaved': 'Несохранённые изменения',
-      'settings.saving': 'Сохранение…',
-      'settings.save': 'Сохранить настройки',
-      'settings.discard': 'Сбросить изменения',
-      'settings.saveFailed': 'Не удалось сохранить настройки. Проверьте параметры и попробуйте снова.',
-      'settings.readOnly': 'Настройки доступны только для чтения.',
-      'settings.overridden': 'переопределено',
-      'settings.reset': 'Сбросить к умолчанию',
-      'settings.invalidNumber': 'Введите корректное число',
-      'settings.collapse': 'Свернуть',
-      'settings.expand': 'Развернуть',
-      'settings.credentialHint': 'Ключи API хранятся в DSH Credentials (~/.dsh/.credentials.yaml) и не попадают в файлы конфигурации.',
-
-      'tab.general': 'Основные',
-      'tab.provider': 'Провайдер',
-      'tab.enhancer': 'Промпт и стили',
-      'tab.safety': 'Безопасность и бюджет',
-      'tab.cache': 'Кэш и хранение',
-
-      'stat.active_provider': 'Активный провайдер',
-      'stat.format_size': 'Параметры по умолчанию',
-      'stat.safety_status': 'Защита и Loop Guard',
-      'stat.budget_cache': 'Бюджет и кэширование',
-
-      'card.generating': 'Генерация изображения…',
-      'card.failed': 'Ошибка генерации',
-      'card.image': 'Результат Image Studio',
-      'card.unknownError': 'Неизвестная ошибка во время создания изображения.',
-      'card.sizePrefix': 'Размер',
-      'card.seedPrefix': 'Сид',
-      'card.actionReroll': 'Перегенерировать картинку',
-      'card.actionUpscale': 'Увеличить разрешение',
-      'card.actionRemoveBg': 'Удалить фон',
-      'card.reroll': 'Реролл',
-      'card.upscale': 'Апскейл 2x/4x',
-      'card.removeBg': 'Без фона',
-      'card.copyPrompt': 'Копировать промпт',
-      'card.origPrompt': 'Исходный промпт',
-
-      'f.enabled': 'Главный выключатель',
-      'f.enabledHint': 'Включение или отключение всех инструментов генерации картинок.',
-      'f.provider': 'Провайдер генерации',
-      'f.providerHint': 'Сервис, выполняющий непосредственное создание изображений.',
-      'f.inherit': 'По умолчанию / наследовать',
-      'f.needFal': 'Требуется ключ FAL API',
-      'f.needCustom': 'Требуется OpenAI-совместимый эндпоинт',
-      'f.needCodex': 'Встроенная подписка Codex',
-      'f.needGrok': 'Встроенная подписка Grok',
-      'f.needLocal': 'Локальный ComfyUI или Automatic1111',
-      'f.needSeedream': 'Требуется ключ SeaDream API',
-      'f.needGemini': 'Требуется ключ Google Gemini API',
-      'f.needReplicate': 'Требуется токен Replicate API',
-
-      'f.defaultSize': 'Соотношение сторон по умолчанию',
-      'f.defaultSizeHint': 'Разрешение и пропорции кадра, когда параметр image_size не передан.',
-      'f.defaultFormat': 'Формат файла',
-      'f.defaultFormatHint': 'Формат сохранения результатов (PNG, JPEG или WEBP).',
-      'f.deliverAs': 'Способ доставки',
-      'f.deliverAsHint': 'Способ передачи: "link" (безопасно для текстовых моделей) или "image" (для vision-моделей).',
-      'f.outputDir': 'Каталог сохранения',
-      'f.outputDirHint': 'Путь к папке сохранения сгенерированных файлов на диске.',
-      'p.outputDir': 'generated/images',
-      'f.historyLimit': 'Лимит истории',
-      'f.historyLimitHint': 'Максимальное число последних генераций, удерживаемых в памяти.',
-      'p.historyLimit': '50',
-
-      'f.model': 'Модель FAL',
-      'f.modelHint': 'Идентификатор модели на сервисе FAL (например, fal-ai/flux-2/klein/9b).',
-      'p.model': 'fal-ai/flux-2/klein/9b',
-      'f.apiKeyEnv': 'Ключ FAL (credential-ref)',
-      'f.apiKeyEnvHint': 'Ссылка на ключ доступа FAL в хранилище credentials.',
-      'p.apiKeyEnv': 'FAL_API_KEY',
-      'f.baseURL': 'Базовый URL FAL',
-      'f.baseURLHint': 'Адрес сервиса очередей FAL.',
-      'p.baseURL': 'https://queue.fal.run',
-      'f.pollIntervalMs': 'Интервал опроса (мс)',
-      'f.pollIntervalMsHint': 'Периодичность проверки статуса при асинхронной генерации.',
-      'p.pollIntervalMs': '2000',
-      'f.timeoutMs': 'Таймаут (мс)',
-      'f.timeoutMsHint': 'Предельное время ожидания генерации до возврата ошибки.',
-      'p.timeoutMs': '180000',
-
-      'f.customBaseURL': 'URL стороннего API',
-      'f.customBaseURLHint': 'Адрес OpenAI-совместимого эндпоинта (например, https://api.openai.com/v1).',
-      'p.customBaseURL': 'https://api.openai.com/v1',
-      'f.customModel': 'Модель стороннего API',
-      'f.customModelHint': 'Имя модели для отправки в сторонний API.',
-      'p.customModel': 'dall-e-3',
-      'f.customKeyEnv': 'Ключ стороннего API',
-      'f.customKeyEnvHint': 'Имя ссылки на ключ для стороннего API.',
-      'p.customKeyEnv': 'OPENAI_API_KEY',
-      'f.customSize': 'Фиксированный размер',
-      'f.customSizeHint': 'Точный размер кадра для стороннего API (например, 1024x1024).',
-      'p.customSize': '1024x1024',
-
-      'f.replicateModel': 'Модель Replicate',
-      'f.replicateModelHint': 'Идентификатор модели на Replicate.',
-      'p.replicateModel': 'black-forest-labs/flux-schnell',
-      'f.replicateKeyEnv': 'Ключ Replicate',
-      'f.replicateKeyEnvHint': 'Имя ссылки на API-токен Replicate.',
-      'p.replicateKeyEnv': 'REPLICATE_API_TOKEN',
-
-      'f.seedreamModel': 'Модель SeaDream',
-      'f.seedreamModelHint': 'Идентификатор модели ByteDance SeaDream.',
-      'p.seedreamModel': 'seedream-4.0',
-      'f.seedreamKeyEnv': 'Ключ SeaDream',
-      'f.seedreamKeyEnvHint': 'Имя ссылки на ключ API SeaDream.',
-      'p.seedreamKeyEnv': 'SEEDREAM_API_KEY',
-      'f.seedreamBaseURL': 'Базовый URL SeaDream',
-      'f.seedreamBaseURLHint': 'Адрес API SeaDream (ByteDance/Volcengine Ark).',
-      'p.seedreamBaseURL': 'https://api.bytedanceapi.com/v1',
-
-      'f.geminiModel': 'Модель Gemini',
-      'f.geminiModelHint': 'Идентификатор модели генерации Google Gemini.',
-      'p.geminiModel': 'gemini-2.0-flash-exp-image-generation',
-      'f.geminiKeyEnv': 'Ключ Gemini',
-      'f.geminiKeyEnvHint': 'Имя ссылки на ключ Google Gemini API.',
-      'p.geminiKeyEnv': 'GEMINI_API_KEY',
-
-      'f.localKind': 'Тип локального движка',
-      'f.localKindHint': 'Выбор между ComfyUI API и Automatic1111 WebUI.',
-      'f.localBaseURL': 'Адрес локального сервера',
-      'f.localBaseURLHint': 'Адрес локального сервера (ComfyUI: 8188, A1111: 7860).',
-      'p.localBaseURL': 'http://127.0.0.1:8188',
-      'f.localModel': 'Модель / Чекпоинт',
-      'f.localModelHint': 'Имя чекпоинта или воркфлоу ComfyUI.',
-      'p.localModel': 'v1-5-pruned-emaonly.safetensors',
-      'f.localSteps': 'Шаги сэмплирования',
-      'f.localStepsHint': 'Количество шагов генерации.',
-      'p.localSteps': '20',
-      'f.localCfg': 'Шкала CFG',
-      'f.localCfgHint': 'Сила следования промпту.',
-      'p.localCfg': '7',
-      'f.localComfyUrl': 'Локальный ComfyUI URL (Legacy)',
-      'f.localComfyUrlHint': 'Прямой адрес ComfyUI.',
-      'p.localComfyUrl': 'http://127.0.0.1:8188',
-      'f.localA1111Url': 'Локальный A1111 URL (Legacy)',
-      'f.localA1111UrlHint': 'Прямой адрес Automatic1111.',
-      'p.localA1111Url': 'http://127.0.0.1:7860',
-
-      'f.subscriptionQuality': 'Качество подписки',
-      'f.subscriptionQualityHint': 'Профиль качества для провайдеров Codex и Grok.',
-
-      'f.enhancePrompt': 'LLM-улучшение промпта',
-      'f.enhancePromptHint': 'Автоматическое обогащение коротких запросов художественными деталями.',
-      'f.enableLlmEnhancer': 'Включить LLM Enhancer (Legacy)',
-      'f.enableLlmEnhancerHint': 'Устаревший переключатель улучшения промптов.',
-      'f.enhanceModel': 'Модель улучшения',
-      'f.enhanceModelHint': 'Модель для расширения промптов (пусто = основная модель чата).',
-      'p.enhanceModel': 'Пусто для основной модели чата',
-      'f.enhanceBelowChars': 'Порог длины промпта',
-      'f.enhanceBelowCharsHint': 'Промпты длиннее этого количества символов не расширяются.',
-      'p.enhanceBelowChars': '200',
-      'f.stylePreset': 'Художественный стиль',
-      'f.stylePresetHint': 'Автоматический суффикс стиля для всех создаваемых изображений.',
-
-      'f.qualityGate': 'Контроль качества (Quality Gate)',
-      'f.qualityGateHint': 'Автоматическая проверка кадров и скрытый реролл при дефектах или пустом кадре.',
-      'f.dailyBudgetUsd': 'Дневной бюджет ($ USD)',
-      'f.dailyBudgetUsdHint': 'Предельный лимит затрат в сутки по всем графическим инструментам (0 = без лимита).',
-      'p.dailyBudgetUsd': '0.00',
-      'f.loopGuardLimit': 'Защита от циклов (Loop Guard)',
-      'f.loopGuardLimitHint': 'Максимум последовательных генераций подряд без участия пользователя (0 = выкл).',
-      'p.loopGuardLimit': '3',
-
-      'f.diskCache': 'Дисковый кэш по хэшу',
-      'f.diskCacheHint': 'Мгновенная выдача (<50 мс) и нулевая стоимость для повторных идентичных генераций.',
-      'f.cacheBySeed': 'Кэш по сиду и промпту',
-      'f.cacheBySeedHint': 'Возвращать кэш при полном совпадении сида и текста промпта.',
-      'f.cacheByPrompt': 'Кэш по тексту промпта',
-      'f.cacheByPromptHint': 'Возвращать кэш при повторении того же текста промпта.',
-      'f.pruneDays': 'Срок хранения файлов (дни)',
-      'f.pruneDaysHint': 'Автоматическое удаление файлов и записей старше указанного числа дней (0 = бессрочно).',
-      'p.pruneDays': '0',
-      'f.cacheTtlDays': 'Срок хранения кэша (Legacy)',
-      'f.cacheTtlDaysHint': 'Устаревшее имя параметра срока хранения.',
-      'p.cacheTtlDays': '0',
-    }
-
     // -------------------------------------------------------------- Registration & Apply
     const inject = ['slots', 'settingsScope', 'locale', 'sessions']
 
@@ -1902,7 +1888,6 @@ window.__ModuleLoader__.load({
       if (ctx.locale && typeof ctx.locale.define === 'function') {
         ctx.locale.define('en', NS, en)
         ctx.locale.define('zh', NS, zh)
-        ctx.locale.define('ru', NS, ru)
       }
 
       let card