@goodandready/dsh-image-gen 0.10.31 → 0.10.33

package/README.md

@@ -123,6 +123,11 @@
 ## 🛠️ Complete Tools Reference
 
 * **`generate_image`**: Generate images with pluggable providers, seeds, aspect ratios, and style presets.
+* **`set_style_anchor` (#283)**: Lock session visual identity (subject, outfit, medium, color palette, lighting) for consistent multi-turn generation.
+* **`generate_ui_asset` (#284)**: Layout-aware UI asset generator for icons, stickers, badges, spot graphics, and heroes with negative space constraints (`isolated`, `centered`, `left_empty`, `right_empty`, `top_empty`, `bottom_empty`) and auto-transparency.
+* **`generate_style_matrix` (#286)**: 2x2 visual benchmarking matrix exploring 4 aesthetic presets simultaneously with blind compare mode and 1-click style preset adoption.
+* **`In-Chat Inpainting Canvas` (#285)**: Interactive brush overlay and mask drawer mounted directly over image message cards in chat.
+* **`Smart Provider Fallback Chain` (#282)**: Intelligent cascading failover across providers on 429, 5xx, timeouts, or depleted balance.
 * **`edit_image`**: Targeted inpainting and modification with automatic session reference resolution (#142, #144, #145).
 * **`vary_image`**: Controlled variation generation preserving composition (#143, #144).
 * **`remove_background`**: Extract subject with transparent PNG output (FAL BiRefNet / Rembg).

package/README.ru.md

@@ -163,6 +163,9 @@ graph LR
 | Инструмент | Назначение | Ключевые параметры |
 |---|---|---|
 | **`generate_image`** | Генерация изображения по тексту | `prompt`, `image_size`, `seed`, `style`, `negative_prompt`, `count` |
+| **`set_style_anchor`** | Фиксация визуального стиля и персонажа сессии (объект, костюм, палитра, свет) (#283) | `mode` (`character`/`style`), `image`, `description`, `strength`, `clear` |
+| **`generate_ui_asset`** | Генерация интерфейсных ассетов с контролем свободного пространства и авто-прозрачностью (#284) | `prompt`, `asset_type`, `layout_composition`, `transparent`, `output_format` |
+| **`generate_style_matrix`** | Сетка 2x2 для одновременного бенчмаркинга концепта в 4 стилях со слепым сравнением (#286) | `prompt`, `styles`, `blind_mode`, `output_format` |
 | **`edit_image`** | Направленное редактирование / inpainting с авто-поиском оригинала (#142, #144, #145) | `prompt`, `image` (по умолч. `latest`), `mask`, `strength` |
 | **`vary_image`** | Генерация вариаций существующей картинки (#143, #144) | `image` (по умолч. `latest`), `prompt`, `variation_strength` (0.1–0.9), `count` |
 | **`remove_background`** | Удаление фона с сохранением прозрачного PNG | `image`, `model`, `output_name` |

package/README.zh.md

@@ -113,4 +113,12 @@ dsh plugin --profile web add @goodandready/dsh-image-gen
 
 ## 📄 许可证
 
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+## 🛠️ 新增核心功能 (v0.10.32)
+
+* **`set_style_anchor` (#283)**: 会话级角色与风格参考锚点，在连续对话中锁定主体、配色、光照与渲染媒介。
+* **`generate_ui_asset` (#284)**: 布局感知与留白控制 UI 资产生成器，支持精准留白（`isolated`、`centered`、`left_empty`、`right_empty`、`top_empty`、`bottom_empty`）与自动透明通道。
+* **`generate_style_matrix` (#286)**: 2x2 风格矩阵探索与双盲对比，并发生成 4 种美学预设切片并支持一键应用。
+* **`对话内局部重绘画布` (#285)**: 在消息卡片上直接唤起交互式笔刷画布，支持选区涂抹与即时 Inpainting 局部重绘。
+* **`智能服务商自动故障转移链` (#282)**: 主服务商 429、5xx、超时或额度耗尽时自动无缝切换备选渠道。

package/lib/anchor-helpers.js

@@ -0,0 +1,103 @@
+// anchor-helpers.js — Character & Style Reference Anchor manager (#283).
+// Maintains active visual identity and style reference across multi-turn sessions.
+
+/**
+ * In-memory registry of active visual anchors keyed by scopeId (e.g. session id).
+ * Structure: Map<string, { image: string, label: string, mode: 'character'|'style', strength: number, updatedAt: string }>
+ */
+const sessionAnchors = new Map()
+
+/**
+ * Normalizes anchor strength between 0.1 and 1.0.
+ *
+ * @param {number|undefined} val
+ * @returns {number}
+ */
+export function normalizeAnchorStrength(val) {
+  if (typeof val !== 'number' || Number.isNaN(val)) return 0.65
+  return Math.min(1.0, Math.max(0.1, Number(val.toFixed(2))))
+}
+
+/**
+ * Sets or updates the active visual anchor for a given session or scope.
+ *
+ * @param {string} scopeId Session or workspace identifier
+ * @param {object} data
+ * @param {string} data.image Image URL, attachment ID (sha256:...), or local path
+ * @param {string} [data.label] Human-readable description of character/style
+ * @param {'character'|'style'} [data.mode='style']
+ * @param {number} [data.strength=0.65]
+ * @returns {object} The stored anchor record
+ */
+export function setSessionAnchor(scopeId, data = {}) {
+  const key = String(scopeId || 'default')
+  if (!data.image) {
+    throw new Error('An anchor image (URL, path, or attachment ID) is required.')
+  }
+
+  const mode = data.mode === 'character' ? 'character' : 'style'
+  const strength = normalizeAnchorStrength(data.strength)
+  const label = String(data.label || (mode === 'character' ? 'Character Anchor' : 'Style Anchor')).trim()
+
+  const anchor = {
+    image: String(data.image).trim(),
+    label,
+    mode,
+    strength,
+    updatedAt: new Date().toISOString(),
+  }
+
+  sessionAnchors.set(key, anchor)
+  return anchor
+}
+
+/**
+ * Retrieves the currently active visual anchor for a session scope.
+ *
+ * @param {string} scopeId
+ * @returns {object|null}
+ */
+export function getSessionAnchor(scopeId) {
+  const key = String(scopeId || 'default')
+  return sessionAnchors.get(key) || null
+}
+
+/**
+ * Clears the active visual anchor for a session scope.
+ *
+ * @param {string} scopeId
+ * @returns {boolean} True if an anchor was present and removed
+ */
+export function clearSessionAnchor(scopeId) {
+  const key = String(scopeId || 'default')
+  return sessionAnchors.delete(key)
+}
+
+/**
+ * Clears all active anchors (for testing/cleanup).
+ */
+export function clearAllAnchors() {
+  sessionAnchors.clear()
+}
+
+/**
+ * Injects anchor reference hints into the prompt if an anchor is active and not already included.
+ *
+ * @param {object|null} anchor
+ * @param {string} prompt
+ * @returns {string}
+ */
+export function applyAnchorPromptHints(anchor, prompt) {
+  if (!anchor || !anchor.label) return prompt
+  const lower = prompt.toLowerCase()
+  const labelLower = anchor.label.toLowerCase()
+
+  // Avoid duplicate injection if user already mentioned the anchor label
+  if (lower.includes(labelLower)) return prompt
+
+  if (anchor.mode === 'character') {
+    return `${prompt}, visual character anchor: ${anchor.label}, maintaining consistent facial features, costume, and physical identity`
+  }
+
+  return `${prompt}, visual style anchor: ${anchor.label}, maintaining consistent aesthetic palette, rendering technique, and lighting`
+}