dsh-image-studio

dsh-image-studio · 生图工作室

给 DeepSeek Harness 加一个会「看场合发图」的生图能力：本地四个参考库（人物 / 服饰 / 场景 / 道具），

模型判断该出图时，插件按画面描述把对应的参考图组合起来，一起交给生图 API，保证角色和设定一致。

> v0.5.1 起，走 65535 时图片数据直接从你选的线路返回，国内用「大陆优化线路」不用开代理也能拿到图。

它做了什么

| 部分 | 说明 |

| --- | --- |

| image_generate 工具 | 模型调用：prompt（画面）+ 关键词（situation / expression / pose / shot / light）+ 库条目（characters / outfits / scene / props）→ 组合参考图 → 生图 → 存本地，聊天里显示成图片卡片 |

| image_library 工具 | 模型调用：库很大、系统提示里的目录没列全时，按关键词或 id 查条目（含人设、神态特点、情境穿搭） |

| 系统提示注入 | 「什么时候发图」三档策略 + 自定义规则 + 主动发图冷却 + 关键词清单 + 参考库目录 |

| 设置 → 生图工作室 | 素材库（含「从图片导入」）、关键词、试生成、生成记录、设置 |

安装

需要：DeepSeek Harness 桌面版，以及一个生图接口（[65535](https://my.65535.space/) 的异步任务接口，或任何 OpenAI 兼容的 /v1/images 接口）。

方式一：在 DSH 里装（推荐）

1. 打开 DSH 侧栏的 插件 → 添加插件（或点箭头选「安装第三方插件」）。

2. 把本仓库地址粘进输入框，点 安装：

   https://github.com/aa1355721445-lgtm/dsh-image-studio

3. 装好后点 立即启用。设置里没出现「生图工作室」的话，完全退出 DSH 再打开一次。

方式二：命令行

先完全退出 DSH（托盘里也退出），然后在 PowerShell 里：

dsh plugin --profile desktop add https://github.com/aa1355721445-lgtm/dsh-image-studio

dsh 不在 PATH 上时，用 DSH 安装目录里的完整路径：& "\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add https://github.com/aa1355721445-lgtm/dsh-image-studio。

升级：DSH 里第三方插件通过「卸载 → 重新安装」升级；素材库、关键词和配置都存在 \image-studio\，卸载不会删掉。

本地开发：git clone 下来后用 dsh plugin --profile desktop add link:<克隆目录> 安装，改代码直接生效（宿主端改动需重启 DSH，只改 lib/client.js 刷新页面即可）。

第一次用

1. 打开 设置 → 生图工作室 → 设置，选接口类型、填 Base URL 和 API Key，点「测试连接」。

2. 「识图」默认用 DSH 自带的看图模型（如 deepseek-flash），不用另填 Key；没有的话可以换成 OpenAI 兼容接口。

3. 到 素材库，顶部的「添加」区写一句描述（用文字生成）或者丢几张图（从图片生成三视图），建几个人物、服饰、场景，就可以在对话里让模型出图了。

4. 「关键词」里自带一套默认情境，其中的场景 / 服饰名（卧室、居家针织服等）只是例子，改成你库里实际有的名字即可；库里没有时会只按文字描述。

添加素材（v0.5）

素材库每个分类顶部都有「添加人物 / 服饰 / 场景 / 道具」区，AI 生成放在最前面：

| 方式 | 怎么用 | 结果 |

| --- | --- | --- |

| 用文字生成（推荐） | 在框里写几句描述，点「生成」或 Ctrl + Enter | 扩写成完整设定（名字、标签、外观描述），再画一张三视图 / 设定图 |

| 从图片生成三视图 | 把 1–4 张图拖进来或点击选择 | 识别外观写好描述，再画一张标准三视图 |

| 手动新建 | 「想自己填？手动新建」或网格里的「手动新建」卡片 | 自己填名字、描述，上传参考图 |

• 把图片拖到素材库页面的任何地方，也会直接开始「从图片生成」；
• 生成完都会停在「确认」这一步，名字、描述可以先改，不满意可以写要求重画，确认后才存进库；
• 进了手动新建也不用退回去：页面顶部可以把已经填的描述、加的图直接交给 AI 生成；
• 不常用的话点「收起」，会缩成一行三个按钮（记在本机浏览器里）。

参考库

默认目录在 \image-studio\library\{characters,outfits,scenes,props}，每个库都能在设置页单独改到别处

（比如你已有的素材文件夹）。目录约定对手工整理也友好：

人物库目录\
  小鱼\                ← 一个子文件夹 = 一个条目
    entry.json         ← 名字、别名、标签、外观描述、人设、默认服饰、封面（设置页会自动写）
    front.png  side.png ...
  阿星.png             ← 散图也算一条（名字 = 文件名），在设置页编辑时会自动收进同名文件夹

• 外观描述会写进生图提示词；人设只给对话模型看，不会发给生图 API。
• 第一张（封面）会被优先当作参考图。人物可以设一套默认服饰。
• 设置页里的「删除」是挪进 image-studio\.trash，不做硬删除。

关键词（v0.2）

为了不让每张图都照抄参考图的姿势和表情，神态、动作、取景交给文字决定。模型先判断角色此刻的状态，再填关键词名字，插件把它展开成具体描写：

| 分组 | 例子 | 说明 |

| --- | --- | --- |

| 情境 situation | 在家休息、睡前、刚睡醒、工作学习、外出 | 一组搭配：自带场景、默认服饰、光线和氛围描写 |

| 神态 expression | 开心、害羞、困倦、委屈、得意 | 按对话里的心情选 |

| 动作 pose | 抱膝坐、趴着、托腮、伸懒腰 | |

| 镜头 shot | 自拍、近景、全身、俯视、第一人称 | |