dsh-imagegen

DSH（DeepSeek Harness）文生图 / 图生图插件：接入任意 OpenAI 兼容的生图接口，在对话里一句话出图；可选腾讯云 COS 托管本地参考图，插件详情页自带配置表单，并内嵌 imagegen 技能让 Agent 开箱即用。

功能特性

双模式生图

• 文生图：自然语言描述 → 图片链接
• 图生图：参考图可以是 URL（直接透传）或本地文件（先自动压缩，再托管到腾讯云 COS 供生图站读取）
• 成品图直接返回生图站链接

任意 OpenAI 兼容接口

• Base URL / API Key / 模型 ID 全部可配——换中转站只需改这三项，代码不用动
• 协议自动适配：提交后根据响应自动判断站点类型——
  • 标准 OpenAI 系：同步请求，直接返回图片
  • 异步任务系（如多米）：提交拿任务 ID，再轮询取结果
  • 也可手动钉死 openai-sync / duomi-async（个别"半标准"站点用）
• 兼容多种返回字段（url / b64_json / images[0].url 等）；返回 base64 时自动解码落地到本地

提示词后缀

• 可配置一段文本（默认为印刷级中文守卫："所有中文内容必须印刷级清晰，笔画完整无残缺……"），每次提交自动追加，中文出图不再乱码
• 设置里可一键关闭；单次生成时 Agent 也可传 enhance: false 临时跳过

尺寸

• 表单里的默认分辨率作为兜底（默认 4K，多米系分辨率不分档收费）；单次生成可临时指定任意分辨率

配置与安全

• 配置表单就在插件详情页，修改即时保存、即时生效
• API Key / SecretId / SecretKey 均为只写输入：界面只显示"已设置 / 未设置"，密钥永不回传前端、不在对话中回显

安装

方式一：DSH 界面安装（推荐）

1. 打开 DSH 左侧栏 插件 → 右上角 添加插件

2. 输入本仓库地址：

   https://github.com/say007go/dsh-imagegen
   

3. 安装源可按网络情况选择（如"中国大陆镜像源"）

4. 点击 安装，完成后启用 dsh-imagegen，重启 DSH 生效

方式二：命令行

dsh plugin --profile <你的profile名> add github:say007go/dsh-imagegen

安装完成后重启 DSH。

配置

重启后进入 插件 → dsh-imagegen 详情页，直接填写：

分组	字段	说明
生图接口	Base URL	默认多米API，可自行更换API平台
	API Key	没有 Key？点击注册多米API
	Model	输入模型 ID，如 gpt-image-2.5-sunburst
	默认分辨率	默认 4K，可自行设置
腾讯云 COS	启用 / Region / Bucket / SecretId / SecretKey	仅"本地参考图"场景需要
提示词后缀	启用 / 后缀文本	启用后每次提交自动追加

高级项（协议、图生图模式、轮询参数）有代码默认值，开箱即用；需要调整时编辑安装包中的 cordis.patch.yml / 配置层即可。

使用

重启后直接在对话里说：

• "生成一张雨后的上海外滩夜景" —— 文生图
• "参考这张图的风格，画一张同系列的……"（附上图片）—— 图生图
• "生成 1024x1024 的方形图标" —— 临时指定尺寸

插件内嵌 imagegen 技能，Agent 自动掌握工具用法、成本规则与防降级护栏（工具不可用时会提示重启，而不是手写脚本）。

工作原理

协议自动适配

POST {baseUrl}/images/generations?async=true
├─ 响应含任务 ID        → 异步协议：轮询 {baseUrl}/tasks/{id} 直到完成
├─ 响应直接含图片       → 同步协议：立即返回
└─ 接口拒绝 async 参数  → 自动降级为纯同步请求重试

探测结果按站点缓存，同一站只探测一次。

图生图的两种传参

模式	机制	适用
image-array（默认）	参考图以 URL 形式随请求提交	多米及多数兼容站
edits-multipart	参考图以文件字节直传，完全不经过 COS	严格走 OpenAI /images/edits 的站

提交前处理链

本地参考图 → sharp 压缩（JPEG / 2048px）→ 上传 COS → 签名 URL
          → 拼接提示词后缀 → 提交生图 → 返回链接

目录结构

dsh-imagegen/
├── package.json          # 声明 dsh.bundle + dsh.client
├── cordis.patch.yml      # bundle 补丁（插入 imagegen 插件）
├── lib/
│   ├── index.js          # 主插件：注册 image_generate 工具 + 内嵌技能
│   ├── client.js         # 插件详情页配置表单（浏览器端）
│   ├── config.js         # 配置 schema
│   ├── protocol.js       # 生图协议适配（同步/异步自动判定、图生图双模式）
│   ├── cos.js            # 腾讯云 COS：压缩上传与签名
│   ├── compress.js       # sharp 参考图压缩
│   ├── prompt.js         # 提示词后缀
│   └── size.js           # 尺寸解析
├── skills/imagegen/SKILL.md   # 内嵌 Agent 技能
└── references/api_reference.md

安全与费用

• 密钥安全：COS 建议使用腾讯云子账号最小权限密钥（只授 COS 读写），不用主账号密钥；插件界面与对话中永不回显密钥值
• 费用提示：对象存储（COS）与数据万象（CI）为腾讯云付费服务，使用前请知悉——COS 计费 ｜ CI 计费

License

MIT