前言¶
在 DeepSeek Harness 的生态中，开发者常需要将图像生成能力集成到对话流或工作流中。传统的做法通常涉及跳转至外部工具或手动拼接 API 请求。为了在 DSH 环境内直接完成图像的生成、编辑与导出，需要一种能与对话上下文紧密耦合的解决方案。dsh-image-gen 插件提供了这一能力，它将图像生成工具集成进 DeepSeek Harness，让模型在对话中直接输出图片，同时提供了一套完整的图像处理与设计工具链。
插件介绍¶
该插件由 GooDAnDReaDY 维护，属于「联网工具」类别。它是一个基于 FAL 队列 API 的 generate_image 工具，核心价值在于将图像生成能力下沉到 DSH 的对话界面中。图片会直接在对话内联显示，模型既可以接收图片链接（适配任意聊天模型），也可以直接接收图片内容（需配合 dsh-vision-bridge 或视觉模型）。插件支持多种可插拔提供者，包括 FAL 队列、OpenAI 兼容 API 以及 ChatGPT/Grok 订阅。
核心功能¶
插件内置了图像处理与生成的一站式工具箱：
-
图像编辑与处理
- 支持图像放大与背景移除。
- 支持图像混合与矢量化。
- 提供图像对比度检查，并支持将图片转换为 CSS 渐变。
- 支持提取设计令牌。
-
生成与变体控制
- 变体工作台：提供连续的创造力/去噪强度调节滑块（范围 0.05 至 0.95），以及预设快捷按钮，用于微调生成结果。
- 智能纵横比裁剪：支持 1:1、16:9 等多种社交与响应式画面的无损比例裁剪。
- 风格预设：内置精选风格预设，简化提示词设置。
-
导出与资产管理
- 项目资源包导出：可自动生成 SVG Favicon、PWA 图标套件、Manifest 文件以及 OpenGraph 社交卡片预览。
- 原生侧边栏画廊：在 DSH 右侧原生侧边栏中展示历史生成记录，支持查看元数据、复制提示词及导出链接。
- 交互式诊断：提供实时连接测试，支持对 FAL.ai、ComfyUI、Automatic1111 等提供者进行 Ping 测试与状态监控。
安装与启用¶
在安装前，请确保你的环境满足依赖要求。插件以当前 DSH 进程权限运行，建议在安装前检查源码与许可证。
前置条件
* Node.js >= 20
安装命令
dsh plugin add @goodandready/dsh-image-gen@latest
插件依赖以下 DSH 核心组件作为 Peer Dependencies：
* @deepseek-ai/cordis
* @deepseek-ai/dsh-tools
* @deepseek-ai/dsh-attachment
* @deepseek-ai/dsh-credentials
* @deepseek-ai/dsh-settings
* @deepseek-ai/dsh-llm
* @deepseek-ai/schemastery
典型用法¶
安装完成后，该插件会自动注入 generate_image 工具及相关操作。以下是几种典型的工作流：
1. 微调图像变体
在对话中，可以使用变体工作台对生成的图像进行细微调整。通过拖动创造力/去噪强度滑块（例如在 0.25 或 0.65 的预设位置），或在对话框内直接调用工具，对原图进行风格化重绘或细节修正。
2. 准备响应式素材
需要为 Web 项目生成适配不同屏幕的图片时，使用 smart_crop_image 工具，选择 auto_focus 或 rule_of_thirds 策略，即可快速获得 16:9、9:16 等无损比例的裁剪图，无需手动调整画布。
3. 生成应用资源
在开发 PWA 或网页时，可以直接要求插件导出资源包。工具会自动生成 icon-192.svg、icon-512.svg、manifest.webmanifest 等文件，减少手动切图与配置的时间。
适用场景与注意¶
- 适用人群：前端开发者、AI 应用创作者、UI/UX 设计师。
- 运行权限：插件运行在当前 DSH 进程上下文中，涉及文件读写与网络请求，请确保安装来源可信，并遵守系统权限设置。
- 技术栈：需要 Node.js 20 及以上环境，且需正确配置上述核心依赖。
总结¶
goodandready/dsh-image-gen 将图像生成与处理能力深度整合进 DeepSeek Harness，通过 FAL 队列 API 等多种提供者，实现了从生成、编辑到资产导出的全流程自动化。它不仅提供了丰富的设计工具，还通过原生侧边栏画廊和交互式诊断优化了使用体验。
