📦 @goodandready/dsh-image-gen
DeepSeek Harness 全能图像生成与视觉处理插件
🇬🇧 English •
🇷🇺 Русский •
🇨🇳 中文说明
⭐ 如果您喜欢这个插件，请在 GitHub 上为它点亮 Star — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
🐛 如果您发现 Bug 或希望增加功能，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
⚡ 核心功能与架构提升 (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收录至 npmfiles发布白名单。
🚀 更新 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-*, )绑定 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调用。
