@goodandready/dsh-image-gen 0.10.18 → 0.10.19

package/README.md

@@ -27,10 +27,29 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>If you like this plugin, please star it on GitHub</strong> — it shows me that the plugin is useful to you and motivates me to keep developing it.
+      <br><br>
+      🐛 <strong>If you find a bug or would like to request a feature</strong>, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
 
+## 🚀 Updates v0.10.19: Sidebar Gallery, Diagnostics & Style Engine (#224)
+* **Native Sidebar Gallery & History Drawer**: Integrated directly into DSH's native right sidebar pane (`sidebarRightTabs` and `sidebar.right.pane.tab`), `betterSidebar`, and a quick-access utility chip in the conversation header (`conversation.session.header.utilities`). Browse past generations, inspect metadata, copy prompts, and export links without cluttering the chat.
+* **Interactive Provider Diagnostics**: Real-time "Test Connection" button in the Settings Card under the Providers tab. Ping Fal.ai, ComfyUI, Automatic1111, or Custom OpenAI-compatible endpoints with live roundtrip latency tracking and status badges (Ready, High Latency, Unreachable).
+* **Curated Style Presets & Smart Prompt Polisher**: Built-in artistic engine with 10 curated styles (`cinematic`, `photorealistic`, `anime`, `minimalist_vector`, `isometric_3d`, `analog_film`, `cyberpunk`, `pixel_art`, `oil_painting`, `claymation`), optional `autoEnhancePrompt` setting, and `style_preset` tool parameter.
+* **Collage & Comparison Grid Assembler (`assemble_image_grid`)**: Stitch 2 to 4 images into clean side-by-side, 2x2 grid, or vertical collage comparison graphics via pure Node.js SVG raster rendering, zero heavy external binaries (< 250 KiB package size).
+* **Color Palette-Constrained Generation**: Pass `palette_colors` (hex color array) into `generate_image` to mathematically bias the prompt and negative prompt toward your exact brand color palette with automated WCAG contrast validation.
+* **Inpainting & Mask Support in `edit_image`**: Added `mask_image` (alias for `mask`) and fine-grained `strength` (0.0 to 1.0) control for localized inpainting in Fal.ai and custom gateways.
+* **Full Chinese & English UI Dictionaries**: Complete `zh` and `en` localization coverage in Web UI, with Russian translation registered via `goodandready/dsh-russian-lang`.
+
 ## 🚀 Updates v0.10.18: Speed Acceleration & Quality Hardening (#222)
 * **Parallel Batch & Pack Generation**: Multi-variation requests (`count > 1`, `prompts` array) and `generate_image_pack` multi-ratio workflows now execute concurrently with a concurrency limit (`concurrency: 3`) via `asyncPool`, reducing generation wait times by up to **3x**.
 * **Zero-Delay Initial Polling**: Eliminated artificial initial delay in `pollStatus` and queue runners (Fal.ai, ComfyUI), inspecting generation status immediately on first attempt and shaving 1–1.5s off fast generative workflows.
@@ -45,7 +64,6 @@
 * **Design contract**: `docs/design/DESIGN.md` no longer advertises the removed HistoryGallery UI (#203).
 * **Regression lock**: `test/lifecycle-structure.test.mjs` asserts modular layout, labeled effects, and meta files. Suite: **132 unit tests**.
 
-
 ## ⚡ Overview
 
 **`@goodandready/dsh-image-gen`** is a premier graphic generation and visual processing suite for DeepSeek Harness. It equips autonomous agents with an extensible set of tools for image generation, transformation, background removal, upscaling, vectorization, multi-reference blending, and quality inspection across 8 generative backends.
@@ -83,7 +101,6 @@
 
 ---
 
-
 ## 🚀 Updates in v0.10.4: Cordis Lifecycle, Full Settings GUI, and i18n
 - **Cordis Lifecycle (#136)**: wrapped all 7 tool registrations in `ctx.effect` for proper disposal on reload.
 - **Settings GUI Completeness (#137)**: exposed fields for Replicate, SeaDream, Gemini, Local ComfyUI/A1111, style presets, and LLM enhancer.
@@ -91,14 +108,12 @@
 - **React Cleanup (#139)**: removed dead state hooks from `FalImageCard`.
 - **Complete Localization (#140)**: eliminated hardcoded strings, wiring comprehensive dictionaries for en, ru, and zh.
 
-
 ### 🚀 What's New in v0.10.7 (#197)
 * **Robust Error Formatting**: completely prevents `[object Object]` from appearing in provider refusal chains, extracting deep `.message`, `.detail`, and `.error` objects cleanly.
 * **Deduplicated Provider Prefixes**: eliminates redundant `codex: codex: ...` prefixes.
 * **FAL Credential Aliasing**: seamless fallback between `FAL_API_KEY` and `FAL_KEY` in credentials and environment.
 * **Subscription Aspect Ratio Mapping**: maps aspect ratios (`16:9`, `3:2`, `9:16`, `2:3`) to appropriate subscription dimensions (`1536x1024` / `1024x1536`) instead of falling back to default square `1024x1024`.
 
-
 ### 🚀 What's New in v0.10.16
 * **Safe Attachment Service Fallback (#214)**: Added graceful fallback handling in `saveAttachmentSafe` across all 8 visual tools (`generate_image`, variations, `remove_background`, `upscale_image`, `blend_images`, etc.). When running in headless CLI mode or when the attachment store is unavailable, outputs are safely written to disk with full file paths and data references rather than crashing tool execution.
 * **HTTP Image Endpoint Strict Validation**: Hardened `/dsh-image-gen/image` route against malformed or NaN parameters (`b`, `w`, `h`), cleanly responding with HTTP 400 or 404 without leaking internal system traces.

package/README.ru.md

@@ -21,9 +21,28 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
+## 🚀 Обновления v0.10.19: Встроенная галерея в сайдбаре, диагностика и движок стилей (#224)
+* **Нативная галерея генераций в сайдбаре**: Прямая интеграция в правый сайдбар DSH (`sidebarRightTabs`, слот `sidebar.right.pane.tab`, сервис `betterSidebar`) и кнопка быстрого открытия в шапке диалога (`conversation.session.header.utilities`). Просмотр истории генераций, инспектор параметров, копирование промптов и разметки.
+* **Интерактивная диагностика провайдеров**: Кнопка «Проверить связь» в карточке настроек плагина во вкладке «Провайдеры». Измерение задержки сети и проверка доступности Fal.ai, ComfyUI, Automatic1111 и Custom API со статусными бейджами.
+* **Движок стилей и улучшайзер промптов**: Встроенный каталог из 10 стилей (`cinematic`, `photorealistic`, `anime`, `minimalist_vector`, `isometric_3d`, `analog_film`, `cyberpunk`, `pixel_art`, `oil_painting`, `claymation`), настройка `autoEnhancePrompt` и аргумент `style_preset` в `generate_image`.
+* **Сборка коллажей и сеток сравнения (`assemble_image_grid`)**: Объединение 2–4 изображений в компактный коллаж (side-by-side, 2x2, vertical) на чистом SVG без внешних тяжелых библиотек (размер пакета строго < 250 КБ).
+* **Генерация под цветовую палитру бренда**: Параметр `palette_colors` (массив hex-цветов) в `generate_image` для точного выдерживания цветовой гаммы в промпте с проверкой контраста WCAG.
+* **Inpainting и редактирование по маске в `edit_image`**: Поддержка `mask_image` и параметра `strength` (0.0–1.0) для точечной замены объектов и фона.
+* **Полная поддержка английской и китайской локализаций**: Словари `zh` и `en` в Web UI; регистрация строк для русского интерфейса через `goodandready/dsh-russian-lang`.
+
 ## 🚀 Обновления v0.10.18: Ускорение генерации и отказоустойчивость (#222)
 * **Параллельная генерация вариаций и паков**: Запросы с `count > 1`, пакетные промпты `prompts` и инструмент `generate_image_pack` теперь выполняются параллельно с пулом задач (`concurrency: 3`), сокращая время ожидания пользователя до **3 раз**.
 * **Мгновенный первый опрос очереди (Zero-Delay Initial Poll)**: Устранена искусственная задержка перед первым запросом статуса в `pollStatus` (Fal.ai, ComfyUI), экономя 1–1.5 с на быстрых генерациях.
@@ -38,8 +57,6 @@
 * **DESIGN.md** больше не упоминает удалённую HistoryGallery (#203).
 * **Тесты**: `lifecycle-structure` + полный suite — **132 unit tests**.
 
-
-
 ## ⚡ Обзор возможностей
 
 **`@goodandready/dsh-image-gen`** — флагманский графический плагин для экосистемы DeepSeek Harness, превращающий агента в полноценную творческую студию. Плагин предоставляет богатый набор инструментов для генерации, трансформации, апскейла, векторизации и анализа изображений с поддержкой 8 провайдеров генерации, интеллектуальным кэшированием и интерактивной карточкой в чате.
@@ -130,8 +147,6 @@ graph LR
 
 ---
 
-
-
 ## 🚀 Обновления v0.10.8: унификация Lossless JSON, Dual-Output и строгая валидация (#199)
 - **Унификация Lossless JSON и Dual-Output**: Инструменты `upscale_image`, `remove_background`, `blend_images`, `vectorize_image` теперь гарантированно возвращают валидный `toLosslessJson` и генерируют структурированный `summary` с превью для текстовых LLM.
 - **Строгая валидация входных изображений**: В инструментах `extract_design_tokens`, `image_to_css_gradient` и `check_image_contrast` добавлена явная проверка существования файла с информативной ошибкой (`Image not found or unreadable: <path>`).
@@ -144,7 +159,6 @@ graph LR
 - **Оптимизация компонентов (#139)**: из `FalImageCard` удалён неиспользуемый мёртвый стейт.
 - **100% интернационализация (#140)**: устранены захардкоженные русские строки, добавлены переводы на русский, английский и китайский языки.
 
-
 ### 🚀 Что нового в v0.10.16
 * **Безопасный Fallback сервиса вложений (#214)**: Реализована функция `saveAttachmentSafe` во всех 8 визуальных инструментах (`generate_image`, вариации, `remove_background`, `upscale_image`, `blend_images` и др.). При запуске в автономном режиме без сервиса вложений или при сбое хранилища инструмент гарантированно сохраняет файл на диск и отдает пути без падения.
 * **Строгая валидация HTTP-эндпоинта картинок**: В обработчике `/dsh-image-gen/image` усилена проверка query-параметров (`b`, `w`, `h`), защищающая от `NaN` и отрицательных чисел, а также исключающая утечку внутренних трассировок при 404/500 ошибках.

package/README.zh.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
+      <br><br>
+      🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -37,6 +47,14 @@
 
 ---
 
+## 🚀 更新 v0.10.19: 侧边栏内置图库、连接诊断与风格引擎 (#224)
+* **原生侧边栏图库与历史抽屉**: 直接集成至 DSH 原生右侧面板 (`sidebarRightTabs` 与 `sidebar.right.pane.tab`)、`betterSidebar`，并在对话会话顶部标题栏中新增快捷入口按钮 (`conversation.session.header.utilities`)。支持浏览历史生成、参数详情查看、一键复制提示词与 Markdown 链接。
+* **交互式提供商连接诊断**: 在设置卡片的“提供商”标签页新增“测试连接”按钮。实时检测 Fal.ai、ComfyUI、Automatic1111 或自定义 OpenAI 兼容接口的网络连通性与往返延迟。
+* **精选风格预设与提示词增强引擎**: 内置 10 款精心调校的艺术与摄影预设风格 (`cinematic`, `photorealistic`, `anime`, `minimalist_vector`, `isometric_3d`, `analog_film`, `cyberpunk`, `pixel_art`, `oil_painting`, `claymation`)，支持 `autoEnhancePrompt` 自动强化与 `style_preset` 工具参数。
+* **拼图与多图对比拼接工具 (`assemble_image_grid`)**: 将 2 至 4 张图像拼接为整齐紧凑的并排对比、2x2 网格或垂直长图，采用纯 Node.js SVG 矢量容器渲染，无需笨重外部二进制依赖（包体积严格保持在 250 KiB 以下）。
+* **品牌色板约束生成**: 在 `generate_image` 中传入 `palette_colors` (十六进制色值数组)，算法级引导正向与反向提示词紧密贴合特定色系，并提供 WCAG 对比度校验。
+* **局部重绘与遮罩编辑 (`edit_image`)**: 新增 `mask_image` 遮罩支持与精细 `strength` (0.0 至 1.0) 去噪强度调节。
+* **完整中英文界面语言包**: Web 界面全面支持 `zh` 和 `en` 语言。
 
 ## 🚀 v0.10.4 更新：Cordis 生命周期、完整设置界面与国际化
 - **Cordis 生命周期 (#136)**：将所有 7 个工具注册包装在 `ctx.effect` 中，以便在热重载时正常释放。