GooDAnDReaDY/dsh-image-gen

---

⚡ 核心功能与架构提升 (v0.10.0)

@goodandready/dsh-image-gen 为 DeepSeek Harness 提供工业级高可用的图像生成与视觉处理工具链：

• ComfyUI 本地后端工作流形状修复 (#322, GitHub #7)：修复 lib/providers/backends/local.js 中多包一层 { prompt: workflow } 导致 ComfyUI 报 missing_node_type: Node 'ID #prompt' has no class_type 的缺陷；增加节点结构自检。
• 8大后端全面支持: FAL.ai、Replicate、OpenAI/SiliconFlow、ChatGPT Plus (OAuth)、Grok Imagine (OAuth)、ComfyUI/A1111 本地生成、ByteDance SeaDream 与 Google Imagen 3。
• 指数退避与 Jitter 队列防爆: 针对 FAL 与 Replicate 异步队列引入智能 Backoff 轮询，彻底杜绝 429 报错。
• 确定性哈希缓存 (Deterministic Cache): 相同 Prompt 与 Seed 的重复请求直接从本地秒级返回，零 API 消耗。
• ComfyUI / Automatic1111 拖拽直通: PNG 元数据原生内嵌标准 Parameters 块，生成图片可直接拖入 WebUI/ComfyUI 还原参数。
• 尺寸 64 倍数自动对齐: 自动对齐 VAE 运算尺寸，避免图像失真。
• 多风格预设增强: 内置 cinematic、anime 等风格的独立 Negative Prompt 与 Guidance Scale 优化。

---

🚀 更新 v0.10.26: 架构模块化拆分与仓库源码净化 (#235, #238, #239)

• 架构模块化拆分 (#239)：所有服务端模块均严格符合 <= 600 行规范：提取 lib/tools/generation-pack.js (74行，generation.js 降至 547行)、lib/history.js (93行) 与 lib/attachment-helper.js (82行，index.js 降至 557行)。客户端源码解耦为 src/client/* 15 个子模块（均 <= 337 行）。
• 仓库源码净化 (#235)：内部智能体指令文件 (AGENTS.md, index.md) 已从 Git 索引彻底移除并加入 .gitignore 与 .gitattributes。
• 主题规范对齐 (#238)：全面完成所有 Web UI 界面的零硬编码颜色验证与关闭，深度适配 --dsw-alias-* 与 color-mix(...)。
• 包分发完整性：正式将 README.ru.md 与 README.zh.md 收录至 npm files 发布白名单。

🚀 更新 v0.10.25: DSH 主题颜色适配、响应式多端原型、无缝纹理与精灵图导出 (#173, #177, #178, #238)

• 100% 主题变量原生适配 (#238): 彻底移除客户端代码中的所有写死 rgba(...) 和 Hex 颜色（src/client/10-css.js、src/client/80-gallery.js），徽章、提示栏和画廊遮罩全部通过 color-mix(...) 配合 --dsw-alias-* 主题变量动态生成，完美兼容深色与浅色主题。
• 多端响应式原型生成器 (generate_responsive_mockups, #173): 输入单个产品提示词，并发生成风格统一的移动端 (9:16)、平板端 (3:4) 与桌面端 (16:9) UI 原型，支持聊天卡片中的分栏切换预览。
• 无缝平铺纹理生成器 (generate_seamless_pattern, #178): 自动生成四方连续平铺背景图，内置接缝平滑度校验与 CSS 平铺预览参数。
• 2D 逐帧精灵图生成器 (generate_spritesheet, #177): 自动化横向动画序列帧渲染，内置 CSS @keyframes 动画代码与 SVG 多帧预览条。
• 客户端源码模块化重构 (#244): 将原本庞大的单文件拆分为 src/client/* 目录下 15 个独立职责模块，配套 scripts/build-client.mjs 构建机制。Preflight 检查 FAIL=0，179/179 项自动化测试全绿。

🚀 更新 v0.10.24: 质量加固 — 发布边界、设置状态、主题颜色与模块拆分 (#235–#242)

• 发布边界: 新增 .gitattributes，对 AGENTS.md、index.md、docs/、.gitea/ 设置 export-ignore，GitHub source 归档与 git archive 不再包含内部工作流文件。
• 设置状态回退: 修正设置卡片中的提供方/配置状态处理，部分或未知状态不再误显示为 “unavailable”。
• 对齐设计系统: 将残留的 fal- CSS 类前缀改为 ig-，并以 var(--dsw-alias-*, <fallback>) 绑定 DSH 主题变量。
• 敏感文件加固: 历史记录、缓存 meta/data 与花费计量写入后强制 0600 权限。
• 死代码清理与模块拆分: 删除未使用的 listCuratedStyles；拆分过大的服务端模块 — providers.js 工具函数抽到 provider-utils.js，processing.js 拆为 processing-basic.js + processing-advanced.js。客户端拆分见 #244。

🚀 更新 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)。
• 品牌资源套件导出器 (export_asset_pack): 一键生成生产级网站与 PWA 资源套件：SVG Favicon、PWA 推荐图标套件 (icon-192.svg, icon-512.svg)、manifest.webmanifest、1200×630 社交分享预览卡片 (og-card.svg) 与索引 catalog.json。
• 覆盖 12 大视觉工具的交互 Toolview: 在对话中直接提供重混、放大、裁切与栅格拼图的可视化操作。
• 响应式多端 Mockup 套件 (generate_responsive_mockups, #173): 同一产品提示词并行生成 Mobile 9:16、Tablet 3:4、Desktop 16:9 三端 UI mockup，统一风格与品牌色，保存为 mockup-mobile.png / mockup-tablet.png / mockup-desktop.png，对话内以三标签页预览。
• 严谨的中英双语界面: 完整的 zh 和 en 词典覆盖。

🚀 更新 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 中，以便在热重载时正常释放。
• 设置界面完整性 (#137)：添加了 Replicate、SeaDream、Gemini、本地 ComfyUI/A1111、风格预设和 LLM 增强器的配置字段。
• 包清单依赖 (#138)：在 peerDependencies 中补齐了内核服务依赖。
• React 组件优化 (#139)：从 FalImageCard 中移除了未使用的无用状态。
• 全面国际化 (#140)：消除了硬编码文本，为中、英、俄语提供完整翻译。

📦 安装

dsh plugin --profile web add @goodandready/dsh-image-gen

---

📄 许可证

MIT © 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、超时或额度耗尽时自动无缝切换备选渠道。

🛡️ 安全性

• 配置请求大小限制 (#313)：PUT /dsh-image-gen/config 限制请求体最大 64 KB，超出返回 HTTP 413，防止内存耗尽 DoS。
• 客户端构建校验 (#316)：scripts/build-client.mjs 支持 --check 模式，确保构建一致性。
• 架构解耦优化 (#317)：lib/index.js 精简为轻量级门面（<400 行），拆分 config-schema.js 与 resolve-source.js。
• 启动与运行时清理 (#318, #319)：优化历史记录权限修复，移除废弃的 loc.get 调用。