dsh-image-gen 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +158 -158
- package/README.zh-CN.md +158 -158
- package/lib/client.js +146 -37
- package/lib/client.js.map +1 -1
- package/lib/types/client/index.d.ts +7 -0
- package/package.json +124 -122
- package/README.en.md +0 -158
package/README.md
CHANGED
|
@@ -1,158 +1,158 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# 🎨 dsh-image-gen
|
|
4
|
-
|
|
5
|
-
### DeepSeek Harness (DSH) 原生生图插件
|
|
6
|
-
|
|
7
|
-
**让 DeepSeek Harness 像 ChatGPT 一样，在对话里直接生成图片。**
|
|
8
|
-
|
|
9
|
-
支持 Google Gemini、OpenAI Images、OpenAI Compatible API、字节 Seedream / 火山方舟。
|
|
10
|
-
|
|
11
|
-
[](https://www.npmjs.com/package/dsh-image-gen)
|
|
12
|
-
[](https://github.com/deepseek-ai)
|
|
13
|
-
[](https://www.npmjs.com/package/dsh-image-gen)
|
|
14
|
-
[](LICENSE)
|
|
15
|
-
|
|
16
|
-
[English](README.en.md) | **简体中文**
|
|
17
|
-
|
|
18
|
-
<br />
|
|
19
|
-
|
|
20
|
-
<p align="center">💬 <b>直接对你的 DeepSeek Harness Agent 发送以下提示词：</b></p>
|
|
21
|
-
|
|
22
|
-
```text
|
|
23
|
-
帮我安装生图插件，执行命令：pnpm dsh plugin --profile web add dsh-image-gen
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
<p align="center"><sub>（也可以手动在终端执行：<code>pnpm dsh plugin --profile web add dsh-image-gen</code>）</sub></p>
|
|
27
|
-
|
|
28
|
-
<br />
|
|
29
|
-
|
|
30
|
-
<p align="center">安装完成后，在 DSH 设置中填入自己的 API Key，就可以直接对 Agent 说：</p>
|
|
31
|
-
|
|
32
|
-
```text
|
|
33
|
-
帮我画一张雨夜霓虹街头的赛博朋克猫咪。
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
<p align="center">Agent 会自动调用 <code>generate_image</code>，生成图片并直接显示在当前对话中。</p>
|
|
37
|
-
|
|
38
|
-
<br />
|
|
39
|
-
|
|
40
|
-
<img src="docs/assets/chat-preview.png" alt="对话生图效果预览" width="820" />
|
|
41
|
-
|
|
42
|
-
</div>
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
## 💡 它解决什么问题？
|
|
47
|
-
|
|
48
|
-
**`dsh-image-gen` 是专为 DeepSeek Harness (DSH) 打造的开源图像生成插件。**
|
|
49
|
-
|
|
50
|
-
DeepSeek Harness 已经可以让 Agent 调用不同工具完成任务，本项目为它补上了原生的**多模态生图能力**：
|
|
51
|
-
|
|
52
|
-
```mermaid
|
|
53
|
-
graph LR
|
|
54
|
-
A[用户 Prompt] --> B[DeepSeek Harness Agent]
|
|
55
|
-
B --> C[generate_image 工具]
|
|
56
|
-
C --> D[Gemini / OpenAI / Seedream]
|
|
57
|
-
D --> E[图片数据]
|
|
58
|
-
E --> F[当前 Conversation 对话流]
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
63
|
-
## 🚀 快速安装与使用
|
|
64
|
-
|
|
65
|
-
### 1. 安装插件
|
|
66
|
-
|
|
67
|
-
在你的 DeepSeek Harness 项目根目录下运行：
|
|
68
|
-
|
|
69
|
-
```bash
|
|
70
|
-
# 推荐方式：通过 pnpm 一键安装并注册插件
|
|
71
|
-
pnpm dsh plugin --profile web add dsh-image-gen
|
|
72
|
-
|
|
73
|
-
# 若已将 dsh 安装为系统全局命令：
|
|
74
|
-
dsh plugin --profile web add dsh-image-gen
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
<details>
|
|
78
|
-
<summary><b>🛠️ 其他安装方式（Git 仓库直装 / 本地调试）</b></summary>
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
# 方式 B：从 GitHub 仓库直接安装最新代码
|
|
82
|
-
pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git
|
|
83
|
-
|
|
84
|
-
# 方式 C：本地克隆源码开发安装
|
|
85
|
-
git clone https://github.com/shanliuling/dsh-image-gen.git
|
|
86
|
-
pnpm dsh plugin --profile web add ./dsh-image-gen
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
</details>
|
|
90
|
-
|
|
91
|
-
### 2. 配置 API Key
|
|
92
|
-
|
|
93
|
-
打开 DSH Web 页面（默认 `http://localhost:3080`）：
|
|
94
|
-
|
|
95
|
-
1. 进入 **Settings → Plugins → Image generation**。
|
|
96
|
-
2. 选择 Provider，填写 API Key，点击 **保存** 即可。
|
|
97
|
-
|
|
98
|
-
<div align="center">
|
|
99
|
-
<img src="docs/assets/settings-preview.png" alt="设置面板预览" width="720" />
|
|
100
|
-
</div>
|
|
101
|
-
|
|
102
|
-
### 3. 开始对话生图
|
|
103
|
-
|
|
104
|
-
现在直接在聊天框输入：
|
|
105
|
-
|
|
106
|
-
```text
|
|
107
|
-
生成一张极简主义的现代建筑客厅插画。
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
当前 Agent 就会自动调用 `generate_image` 工具并在对话流中返回图片。
|
|
111
|
-
|
|
112
|
-
---
|
|
113
|
-
|
|
114
|
-
## ✨ 主要能力
|
|
115
|
-
|
|
116
|
-
- 💬 **对话中直接生图**：不需要切换到其他网站，也不需要手动复制 Prompt，直接告诉 Agent 你想画什么即可。
|
|
117
|
-
- 🎨 **多 Provider 支持**：目前支持 Google Gemini、OpenAI Images、OpenAI Compatible API 以及 ByteDance Seedream / Volcengine Ark。Provider、模型和 Endpoint 都可以在设置界面中自由修改。
|
|
118
|
-
- 🔑 **BYOK (自带 Key)**：插件使用你自己的 API Key。API Key 通过 DeepSeek Harness 的 `credentials` 服务管理，采用写保护隔离，不需要写进项目源码或配置文件，前端不存明文。
|
|
119
|
-
- 🖼️ **图片跟随会话保存**：生成结果会接入 DeepSeek Harness 的 Attachment / Conversation 体系，重新打开历史会话后，仍然可以看到之前生成的图片。
|
|
120
|
-
- ⚙️ **原生设置界面**：Provider、API Key、模型和 Endpoint 都可以直接在 DSH Web 设置中修改，不需要手动编辑配置文件。
|
|
121
|
-
|
|
122
|
-
---
|
|
123
|
-
|
|
124
|
-
## 📦 支持的 Provider
|
|
125
|
-
|
|
126
|
-
| Provider | 默认模型 | 默认 Endpoint / Base URL |
|
|
127
|
-
| :--- | :--- | :--- |
|
|
128
|
-
| **Google Gemini** | `gemini-3.1-flash-image` | `https://generativelanguage.googleapis.com/v1beta/interactions` |
|
|
129
|
-
| **OpenAI Images** | `gpt-image-2` | `https://api.openai.com/v1` |
|
|
130
|
-
| **OpenAI Compatible** | 自定义 | 自定义 Base URL |
|
|
131
|
-
| **ByteDance Seedream / 火山方舟** | `doubao-seedream-5-0-260128` | `https://ark.cn-beijing.volces.com/api/v3` |
|
|
132
|
-
|
|
133
|
-
---
|
|
134
|
-
|
|
135
|
-
## 🛠️ 本地开发 (Development)
|
|
136
|
-
|
|
137
|
-
```bash
|
|
138
|
-
# 克隆仓库
|
|
139
|
-
git clone https://github.com/shanliuling/dsh-image-gen.git
|
|
140
|
-
cd dsh-image-gen
|
|
141
|
-
|
|
142
|
-
# 安装依赖与构建
|
|
143
|
-
pnpm install
|
|
144
|
-
pnpm run typecheck
|
|
145
|
-
pnpm run test
|
|
146
|
-
pnpm run build
|
|
147
|
-
|
|
148
|
-
# 检查 npm 打包内容
|
|
149
|
-
pnpm run pack:check
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
---
|
|
153
|
-
|
|
154
|
-
## 📄 开源协议 (License)
|
|
155
|
-
|
|
156
|
-
本项目基于 [MIT License](LICENSE) 开源。
|
|
157
|
-
|
|
158
|
-
如果这个插件对你有用，欢迎点一个 ⭐️ **Star** 支持！
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# 🎨 dsh-image-gen
|
|
4
|
+
|
|
5
|
+
### DeepSeek Harness (DSH) 原生生图插件
|
|
6
|
+
|
|
7
|
+
**让 DeepSeek Harness 像 ChatGPT 一样，在对话里直接生成图片。**
|
|
8
|
+
|
|
9
|
+
支持 Google Gemini、OpenAI Images、OpenAI Compatible API、字节 Seedream / 火山方舟。
|
|
10
|
+
|
|
11
|
+
[](https://www.npmjs.com/package/dsh-image-gen)
|
|
12
|
+
[](https://github.com/deepseek-ai)
|
|
13
|
+
[](https://www.npmjs.com/package/dsh-image-gen)
|
|
14
|
+
[](LICENSE)
|
|
15
|
+
|
|
16
|
+
[English](README.en.md) | **简体中文**
|
|
17
|
+
|
|
18
|
+
<br />
|
|
19
|
+
|
|
20
|
+
<p align="center">💬 <b>直接对你的 DeepSeek Harness Agent 发送以下提示词：</b></p>
|
|
21
|
+
|
|
22
|
+
```text
|
|
23
|
+
帮我安装生图插件，执行命令：pnpm dsh plugin --profile web add dsh-image-gen
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
<p align="center"><sub>（也可以手动在终端执行：<code>pnpm dsh plugin --profile web add dsh-image-gen</code>）</sub></p>
|
|
27
|
+
|
|
28
|
+
<br />
|
|
29
|
+
|
|
30
|
+
<p align="center">安装完成后，在 DSH 设置中填入自己的 API Key，就可以直接对 Agent 说：</p>
|
|
31
|
+
|
|
32
|
+
```text
|
|
33
|
+
帮我画一张雨夜霓虹街头的赛博朋克猫咪。
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
<p align="center">Agent 会自动调用 <code>generate_image</code>，生成图片并直接显示在当前对话中。</p>
|
|
37
|
+
|
|
38
|
+
<br />
|
|
39
|
+
|
|
40
|
+
<img src="docs/assets/chat-preview.png" alt="对话生图效果预览" width="820" />
|
|
41
|
+
|
|
42
|
+
</div>
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## 💡 它解决什么问题？
|
|
47
|
+
|
|
48
|
+
**`dsh-image-gen` 是专为 DeepSeek Harness (DSH) 打造的开源图像生成插件。**
|
|
49
|
+
|
|
50
|
+
DeepSeek Harness 已经可以让 Agent 调用不同工具完成任务，本项目为它补上了原生的**多模态生图能力**：
|
|
51
|
+
|
|
52
|
+
```mermaid
|
|
53
|
+
graph LR
|
|
54
|
+
A[用户 Prompt] --> B[DeepSeek Harness Agent]
|
|
55
|
+
B --> C[generate_image 工具]
|
|
56
|
+
C --> D[Gemini / OpenAI / Seedream]
|
|
57
|
+
D --> E[图片数据]
|
|
58
|
+
E --> F[当前 Conversation 对话流]
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 🚀 快速安装与使用
|
|
64
|
+
|
|
65
|
+
### 1. 安装插件
|
|
66
|
+
|
|
67
|
+
在你的 DeepSeek Harness 项目根目录下运行：
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# 推荐方式：通过 pnpm 一键安装并注册插件
|
|
71
|
+
pnpm dsh plugin --profile web add dsh-image-gen
|
|
72
|
+
|
|
73
|
+
# 若已将 dsh 安装为系统全局命令：
|
|
74
|
+
dsh plugin --profile web add dsh-image-gen
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
<details>
|
|
78
|
+
<summary><b>🛠️ 其他安装方式（Git 仓库直装 / 本地调试）</b></summary>
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
# 方式 B：从 GitHub 仓库直接安装最新代码
|
|
82
|
+
pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git
|
|
83
|
+
|
|
84
|
+
# 方式 C：本地克隆源码开发安装
|
|
85
|
+
git clone https://github.com/shanliuling/dsh-image-gen.git
|
|
86
|
+
pnpm dsh plugin --profile web add ./dsh-image-gen
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
</details>
|
|
90
|
+
|
|
91
|
+
### 2. 配置 API Key
|
|
92
|
+
|
|
93
|
+
打开 DSH Web 页面（默认 `http://localhost:3080`）：
|
|
94
|
+
|
|
95
|
+
1. 进入 **Settings → Plugins → Image generation**。
|
|
96
|
+
2. 选择 Provider，填写 API Key，点击 **保存** 即可。
|
|
97
|
+
|
|
98
|
+
<div align="center">
|
|
99
|
+
<img src="docs/assets/settings-preview.png" alt="设置面板预览" width="720" />
|
|
100
|
+
</div>
|
|
101
|
+
|
|
102
|
+
### 3. 开始对话生图
|
|
103
|
+
|
|
104
|
+
现在直接在聊天框输入：
|
|
105
|
+
|
|
106
|
+
```text
|
|
107
|
+
生成一张极简主义的现代建筑客厅插画。
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
当前 Agent 就会自动调用 `generate_image` 工具并在对话流中返回图片。
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## ✨ 主要能力
|
|
115
|
+
|
|
116
|
+
- 💬 **对话中直接生图**：不需要切换到其他网站，也不需要手动复制 Prompt，直接告诉 Agent 你想画什么即可。
|
|
117
|
+
- 🎨 **多 Provider 支持**：目前支持 Google Gemini、OpenAI Images、OpenAI Compatible API 以及 ByteDance Seedream / Volcengine Ark。Provider、模型和 Endpoint 都可以在设置界面中自由修改。
|
|
118
|
+
- 🔑 **BYOK (自带 Key)**：插件使用你自己的 API Key。API Key 通过 DeepSeek Harness 的 `credentials` 服务管理，采用写保护隔离，不需要写进项目源码或配置文件，前端不存明文。
|
|
119
|
+
- 🖼️ **图片跟随会话保存**：生成结果会接入 DeepSeek Harness 的 Attachment / Conversation 体系，重新打开历史会话后，仍然可以看到之前生成的图片。
|
|
120
|
+
- ⚙️ **原生设置界面**：Provider、API Key、模型和 Endpoint 都可以直接在 DSH Web 设置中修改，不需要手动编辑配置文件。
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 📦 支持的 Provider
|
|
125
|
+
|
|
126
|
+
| Provider | 默认模型 | 默认 Endpoint / Base URL |
|
|
127
|
+
| :--- | :--- | :--- |
|
|
128
|
+
| **Google Gemini** | `gemini-3.1-flash-image` | `https://generativelanguage.googleapis.com/v1beta/interactions` |
|
|
129
|
+
| **OpenAI Images** | `gpt-image-2` | `https://api.openai.com/v1` |
|
|
130
|
+
| **OpenAI Compatible** | 自定义 | 自定义 Base URL |
|
|
131
|
+
| **ByteDance Seedream / 火山方舟** | `doubao-seedream-5-0-260128` | `https://ark.cn-beijing.volces.com/api/v3` |
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## 🛠️ 本地开发 (Development)
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
# 克隆仓库
|
|
139
|
+
git clone https://github.com/shanliuling/dsh-image-gen.git
|
|
140
|
+
cd dsh-image-gen
|
|
141
|
+
|
|
142
|
+
# 安装依赖与构建
|
|
143
|
+
pnpm install
|
|
144
|
+
pnpm run typecheck
|
|
145
|
+
pnpm run test
|
|
146
|
+
pnpm run build
|
|
147
|
+
|
|
148
|
+
# 检查 npm 打包内容
|
|
149
|
+
pnpm run pack:check
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## 📄 开源协议 (License)
|
|
155
|
+
|
|
156
|
+
本项目基于 [MIT License](LICENSE) 开源。
|
|
157
|
+
|
|
158
|
+
如果这个插件对你有用，欢迎点一个 ⭐️ **Star** 支持！
|
package/README.zh-CN.md
CHANGED
|
@@ -1,158 +1,158 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# 🎨 dsh-image-gen
|
|
4
|
-
|
|
5
|
-
### DeepSeek Harness (DSH) 原生生图插件
|
|
6
|
-
|
|
7
|
-
**让 DeepSeek Harness 像 ChatGPT 一样，在对话里直接生成图片。**
|
|
8
|
-
|
|
9
|
-
支持 Google Gemini、OpenAI Images、OpenAI Compatible API、字节 Seedream / 火山方舟。
|
|
10
|
-
|
|
11
|
-
[](https://www.npmjs.com/package/dsh-image-gen)
|
|
12
|
-
[](https://github.com/deepseek-ai)
|
|
13
|
-
[](https://www.npmjs.com/package/dsh-image-gen)
|
|
14
|
-
[](LICENSE)
|
|
15
|
-
|
|
16
|
-
[English](README.en.md) | **简体中文**
|
|
17
|
-
|
|
18
|
-
<br />
|
|
19
|
-
|
|
20
|
-
<p align="center">💬 <b>直接对你的 DeepSeek Harness Agent 发送以下提示词：</b></p>
|
|
21
|
-
|
|
22
|
-
```text
|
|
23
|
-
帮我安装生图插件，执行命令：pnpm dsh plugin --profile web add dsh-image-gen
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
<p align="center"><sub>（也可以手动在终端执行：<code>pnpm dsh plugin --profile web add dsh-image-gen</code>）</sub></p>
|
|
27
|
-
|
|
28
|
-
<br />
|
|
29
|
-
|
|
30
|
-
<p align="center">安装完成后，在 DSH 设置中填入自己的 API Key，就可以直接对 Agent 说：</p>
|
|
31
|
-
|
|
32
|
-
```text
|
|
33
|
-
帮我画一张雨夜霓虹街头的赛博朋克猫咪。
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
<p align="center">Agent 会自动调用 <code>generate_image</code>，生成图片并直接显示在当前对话中。</p>
|
|
37
|
-
|
|
38
|
-
<br />
|
|
39
|
-
|
|
40
|
-
<img src="docs/assets/chat-preview.png" alt="对话生图效果预览" width="820" />
|
|
41
|
-
|
|
42
|
-
</div>
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
## 💡 它解决什么问题？
|
|
47
|
-
|
|
48
|
-
**`dsh-image-gen` 是专为 DeepSeek Harness (DSH) 打造的开源图像生成插件。**
|
|
49
|
-
|
|
50
|
-
DeepSeek Harness 已经可以让 Agent 调用不同工具完成任务，本项目为它补上了原生的**多模态生图能力**：
|
|
51
|
-
|
|
52
|
-
```mermaid
|
|
53
|
-
graph LR
|
|
54
|
-
A[用户 Prompt] --> B[DeepSeek Harness Agent]
|
|
55
|
-
B --> C[generate_image 工具]
|
|
56
|
-
C --> D[Gemini / OpenAI / Seedream]
|
|
57
|
-
D --> E[图片数据]
|
|
58
|
-
E --> F[当前 Conversation 对话流]
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
63
|
-
## 🚀 快速安装与使用
|
|
64
|
-
|
|
65
|
-
### 1. 安装插件
|
|
66
|
-
|
|
67
|
-
在你的 DeepSeek Harness 项目根目录下运行：
|
|
68
|
-
|
|
69
|
-
```bash
|
|
70
|
-
# 推荐方式：通过 pnpm 一键安装并注册插件
|
|
71
|
-
pnpm dsh plugin --profile web add dsh-image-gen
|
|
72
|
-
|
|
73
|
-
# 若已将 dsh 安装为系统全局命令：
|
|
74
|
-
dsh plugin --profile web add dsh-image-gen
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
<details>
|
|
78
|
-
<summary><b>🛠️ 其他安装方式（Git 仓库直装 / 本地调试）</b></summary>
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
# 方式 B：从 GitHub 仓库直接安装最新代码
|
|
82
|
-
pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git
|
|
83
|
-
|
|
84
|
-
# 方式 C：本地克隆源码开发安装
|
|
85
|
-
git clone https://github.com/shanliuling/dsh-image-gen.git
|
|
86
|
-
pnpm dsh plugin --profile web add ./dsh-image-gen
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
</details>
|
|
90
|
-
|
|
91
|
-
### 2. 配置 API Key
|
|
92
|
-
|
|
93
|
-
打开 DSH Web 页面（默认 `http://localhost:3080`）：
|
|
94
|
-
|
|
95
|
-
1. 进入 **Settings → Plugins → Image generation**。
|
|
96
|
-
2. 选择 Provider，填写 API Key，点击 **保存** 即可。
|
|
97
|
-
|
|
98
|
-
<div align="center">
|
|
99
|
-
<img src="docs/assets/settings-preview.png" alt="设置面板预览" width="720" />
|
|
100
|
-
</div>
|
|
101
|
-
|
|
102
|
-
### 3. 开始对话生图
|
|
103
|
-
|
|
104
|
-
现在直接在聊天框输入：
|
|
105
|
-
|
|
106
|
-
```text
|
|
107
|
-
生成一张极简主义的现代建筑客厅插画。
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
当前 Agent 就会自动调用 `generate_image` 工具并在对话流中返回图片。
|
|
111
|
-
|
|
112
|
-
---
|
|
113
|
-
|
|
114
|
-
## ✨ 主要能力
|
|
115
|
-
|
|
116
|
-
- 💬 **对话中直接生图**：不需要切换到其他网站，也不需要手动复制 Prompt，直接告诉 Agent 你想画什么即可。
|
|
117
|
-
- 🎨 **多 Provider 支持**：目前支持 Google Gemini、OpenAI Images、OpenAI Compatible API 以及 ByteDance Seedream / Volcengine Ark。Provider、模型和 Endpoint 都可以在设置界面中自由修改。
|
|
118
|
-
- 🔑 **BYOK (自带 Key)**：插件使用你自己的 API Key。API Key 通过 DeepSeek Harness 的 `credentials` 服务管理，采用写保护隔离，不需要写进项目源码或配置文件，前端不存明文。
|
|
119
|
-
- 🖼️ **图片跟随会话保存**：生成结果会接入 DeepSeek Harness 的 Attachment / Conversation 体系，重新打开历史会话后，仍然可以看到之前生成的图片。
|
|
120
|
-
- ⚙️ **原生设置界面**：Provider、API Key、模型和 Endpoint 都可以直接在 DSH Web 设置中修改，不需要手动编辑配置文件。
|
|
121
|
-
|
|
122
|
-
---
|
|
123
|
-
|
|
124
|
-
## 📦 支持的 Provider
|
|
125
|
-
|
|
126
|
-
| Provider | 默认模型 | 默认 Endpoint / Base URL |
|
|
127
|
-
| :--- | :--- | :--- |
|
|
128
|
-
| **Google Gemini** | `gemini-3.1-flash-image` | `https://generativelanguage.googleapis.com/v1beta/interactions` |
|
|
129
|
-
| **OpenAI Images** | `gpt-image-2` | `https://api.openai.com/v1` |
|
|
130
|
-
| **OpenAI Compatible** | 自定义 | 自定义 Base URL |
|
|
131
|
-
| **ByteDance Seedream / 火山方舟** | `doubao-seedream-5-0-260128` | `https://ark.cn-beijing.volces.com/api/v3` |
|
|
132
|
-
|
|
133
|
-
---
|
|
134
|
-
|
|
135
|
-
## 🛠️ 本地开发 (Development)
|
|
136
|
-
|
|
137
|
-
```bash
|
|
138
|
-
# 克隆仓库
|
|
139
|
-
git clone https://github.com/shanliuling/dsh-image-gen.git
|
|
140
|
-
cd dsh-image-gen
|
|
141
|
-
|
|
142
|
-
# 安装依赖与构建
|
|
143
|
-
pnpm install
|
|
144
|
-
pnpm run typecheck
|
|
145
|
-
pnpm run test
|
|
146
|
-
pnpm run build
|
|
147
|
-
|
|
148
|
-
# 检查 npm 打包内容
|
|
149
|
-
pnpm run pack:check
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
---
|
|
153
|
-
|
|
154
|
-
## 📄 开源协议 (License)
|
|
155
|
-
|
|
156
|
-
本项目基于 [MIT License](LICENSE) 开源。
|
|
157
|
-
|
|
158
|
-
如果这个插件对你有用，欢迎点一个 ⭐️ **Star** 支持！
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# 🎨 dsh-image-gen
|
|
4
|
+
|
|
5
|
+
### DeepSeek Harness (DSH) 原生生图插件
|
|
6
|
+
|
|
7
|
+
**让 DeepSeek Harness 像 ChatGPT 一样，在对话里直接生成图片。**
|
|
8
|
+
|
|
9
|
+
支持 Google Gemini、OpenAI Images、OpenAI Compatible API、字节 Seedream / 火山方舟。
|
|
10
|
+
|
|
11
|
+
[](https://www.npmjs.com/package/dsh-image-gen)
|
|
12
|
+
[](https://github.com/deepseek-ai)
|
|
13
|
+
[](https://www.npmjs.com/package/dsh-image-gen)
|
|
14
|
+
[](LICENSE)
|
|
15
|
+
|
|
16
|
+
[English](README.en.md) | **简体中文**
|
|
17
|
+
|
|
18
|
+
<br />
|
|
19
|
+
|
|
20
|
+
<p align="center">💬 <b>直接对你的 DeepSeek Harness Agent 发送以下提示词：</b></p>
|
|
21
|
+
|
|
22
|
+
```text
|
|
23
|
+
帮我安装生图插件，执行命令：pnpm dsh plugin --profile web add dsh-image-gen
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
<p align="center"><sub>（也可以手动在终端执行：<code>pnpm dsh plugin --profile web add dsh-image-gen</code>）</sub></p>
|
|
27
|
+
|
|
28
|
+
<br />
|
|
29
|
+
|
|
30
|
+
<p align="center">安装完成后，在 DSH 设置中填入自己的 API Key，就可以直接对 Agent 说：</p>
|
|
31
|
+
|
|
32
|
+
```text
|
|
33
|
+
帮我画一张雨夜霓虹街头的赛博朋克猫咪。
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
<p align="center">Agent 会自动调用 <code>generate_image</code>，生成图片并直接显示在当前对话中。</p>
|
|
37
|
+
|
|
38
|
+
<br />
|
|
39
|
+
|
|
40
|
+
<img src="docs/assets/chat-preview.png" alt="对话生图效果预览" width="820" />
|
|
41
|
+
|
|
42
|
+
</div>
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## 💡 它解决什么问题？
|
|
47
|
+
|
|
48
|
+
**`dsh-image-gen` 是专为 DeepSeek Harness (DSH) 打造的开源图像生成插件。**
|
|
49
|
+
|
|
50
|
+
DeepSeek Harness 已经可以让 Agent 调用不同工具完成任务，本项目为它补上了原生的**多模态生图能力**：
|
|
51
|
+
|
|
52
|
+
```mermaid
|
|
53
|
+
graph LR
|
|
54
|
+
A[用户 Prompt] --> B[DeepSeek Harness Agent]
|
|
55
|
+
B --> C[generate_image 工具]
|
|
56
|
+
C --> D[Gemini / OpenAI / Seedream]
|
|
57
|
+
D --> E[图片数据]
|
|
58
|
+
E --> F[当前 Conversation 对话流]
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 🚀 快速安装与使用
|
|
64
|
+
|
|
65
|
+
### 1. 安装插件
|
|
66
|
+
|
|
67
|
+
在你的 DeepSeek Harness 项目根目录下运行：
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# 推荐方式：通过 pnpm 一键安装并注册插件
|
|
71
|
+
pnpm dsh plugin --profile web add dsh-image-gen
|
|
72
|
+
|
|
73
|
+
# 若已将 dsh 安装为系统全局命令：
|
|
74
|
+
dsh plugin --profile web add dsh-image-gen
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
<details>
|
|
78
|
+
<summary><b>🛠️ 其他安装方式（Git 仓库直装 / 本地调试）</b></summary>
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
# 方式 B：从 GitHub 仓库直接安装最新代码
|
|
82
|
+
pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git
|
|
83
|
+
|
|
84
|
+
# 方式 C：本地克隆源码开发安装
|
|
85
|
+
git clone https://github.com/shanliuling/dsh-image-gen.git
|
|
86
|
+
pnpm dsh plugin --profile web add ./dsh-image-gen
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
</details>
|
|
90
|
+
|
|
91
|
+
### 2. 配置 API Key
|
|
92
|
+
|
|
93
|
+
打开 DSH Web 页面（默认 `http://localhost:3080`）：
|
|
94
|
+
|
|
95
|
+
1. 进入 **Settings → Plugins → Image generation**。
|
|
96
|
+
2. 选择 Provider，填写 API Key，点击 **保存** 即可。
|
|
97
|
+
|
|
98
|
+
<div align="center">
|
|
99
|
+
<img src="docs/assets/settings-preview.png" alt="设置面板预览" width="720" />
|
|
100
|
+
</div>
|
|
101
|
+
|
|
102
|
+
### 3. 开始对话生图
|
|
103
|
+
|
|
104
|
+
现在直接在聊天框输入：
|
|
105
|
+
|
|
106
|
+
```text
|
|
107
|
+
生成一张极简主义的现代建筑客厅插画。
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
当前 Agent 就会自动调用 `generate_image` 工具并在对话流中返回图片。
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## ✨ 主要能力
|
|
115
|
+
|
|
116
|
+
- 💬 **对话中直接生图**：不需要切换到其他网站，也不需要手动复制 Prompt，直接告诉 Agent 你想画什么即可。
|
|
117
|
+
- 🎨 **多 Provider 支持**：目前支持 Google Gemini、OpenAI Images、OpenAI Compatible API 以及 ByteDance Seedream / Volcengine Ark。Provider、模型和 Endpoint 都可以在设置界面中自由修改。
|
|
118
|
+
- 🔑 **BYOK (自带 Key)**：插件使用你自己的 API Key。API Key 通过 DeepSeek Harness 的 `credentials` 服务管理，采用写保护隔离，不需要写进项目源码或配置文件，前端不存明文。
|
|
119
|
+
- 🖼️ **图片跟随会话保存**：生成结果会接入 DeepSeek Harness 的 Attachment / Conversation 体系，重新打开历史会话后，仍然可以看到之前生成的图片。
|
|
120
|
+
- ⚙️ **原生设置界面**：Provider、API Key、模型和 Endpoint 都可以直接在 DSH Web 设置中修改，不需要手动编辑配置文件。
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 📦 支持的 Provider
|
|
125
|
+
|
|
126
|
+
| Provider | 默认模型 | 默认 Endpoint / Base URL |
|
|
127
|
+
| :--- | :--- | :--- |
|
|
128
|
+
| **Google Gemini** | `gemini-3.1-flash-image` | `https://generativelanguage.googleapis.com/v1beta/interactions` |
|
|
129
|
+
| **OpenAI Images** | `gpt-image-2` | `https://api.openai.com/v1` |
|
|
130
|
+
| **OpenAI Compatible** | 自定义 | 自定义 Base URL |
|
|
131
|
+
| **ByteDance Seedream / 火山方舟** | `doubao-seedream-5-0-260128` | `https://ark.cn-beijing.volces.com/api/v3` |
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## 🛠️ 本地开发 (Development)
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
# 克隆仓库
|
|
139
|
+
git clone https://github.com/shanliuling/dsh-image-gen.git
|
|
140
|
+
cd dsh-image-gen
|
|
141
|
+
|
|
142
|
+
# 安装依赖与构建
|
|
143
|
+
pnpm install
|
|
144
|
+
pnpm run typecheck
|
|
145
|
+
pnpm run test
|
|
146
|
+
pnpm run build
|
|
147
|
+
|
|
148
|
+
# 检查 npm 打包内容
|
|
149
|
+
pnpm run pack:check
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## 📄 开源协议 (License)
|
|
155
|
+
|
|
156
|
+
本项目基于 [MIT License](LICENSE) 开源。
|
|
157
|
+
|
|
158
|
+
如果这个插件对你有用，欢迎点一个 ⭐️ **Star** 支持！
|