@copylee/dsh-image-gen

v0.2.0

Published

5 days ago

DeepSeek Harness 生图插件：侧边栏全局画廊（Cherry Studio 式绘画页）、对话生图/编辑、可自定义 Provider 端点与代理。

dsh-image-gen

DeepSeek Harness（DSH）的 AI 生图插件。DSH 左侧栏会多出一个「绘画」入口，打开的是全局画廊，与工作区无关，布局参考 Cherry Studio 的绘画页。Agent 在普通对话里也能在需要时直接调用生图工具。

与原插件 dsh-image-gen 使用不同的包名、路由、数据目录和工具名，两者可以同时安装。
本插件参考并移植了 shanliuling/dsh-image-gen（Apache-2.0）的部分 Provider 适配代码，详见 NOTICE。

| 绘画页 | 服务商设置 | |---|---| | 左侧栏的「绘画」页：画廊项目、提示词输入区、历史 | 服务商设置：预置服务商列表、API 地址、模型列表、代理 |

功能

画廊不绑定项目

画廊数据存放在 ~/.dsh/storages/copylee-image-gen/gallery.json，图片本体存在 DSH 附件库里，不跟任何工作区或会话挂钩，切换工作区后画廊内容不会变。
画廊有自己的项目分组，可以新建、重命名、删除（删除时可选择把图片一起删掉或移到「默认画板」）。另有两个内置项目：「默认画板」和「对话」（Agent 在对话中生成的图会放在这里）。
如果需要，也可以把对话里生成的图再存一份到当前会话工作区（设置 → 存储）。

安装

DSH 桌面版：插件 → 添加插件，输入 @copylee/dsh-image-gen，安装后启用。

命令行（dsh web 等其他 profile）：

dsh plugin --profile web add @copylee/dsh-image-gen@latest

装好后重启 DSH，左侧栏会出现「绘画」。打开后点右上角的设置按钮，或者进入 设置 → 插件 → 图像生成，给至少一个服务商填好 API Key 就能用了。

需要 DSH 0.1.7 或更高版本（已在 0.2.0-rc.2 上验证），Node.js ^22.19.0 或 >=24。

预置服务商

预置服务商的名称、端点、模型、代理都能改，也可以停用，只是不能删除。

自定义端点

在设置里点「服务商 +」新建一条，选好接口协议（上表任意一种），再填名称、API 地址、Key 和模型（可以点「拉取模型」自动获取）。同一种协议可以添加多条，比如多个 OpenAI 兼容的中转站。中转站的「高级选项」里还能设置编辑请求格式和尺寸表。

代理

全局代理：「关闭 / 系统代理（自动检测）/ 自定义」三选一，只作用于本插件的生图请求。系统代理依次读取 HTTPS_PROXY 等环境变量、Windows「Internet 选项」代理（含例外列表）、macOS 网络代理、GNOME 代理设置；自定义支持 http://、https://、socks5://、socks5h://、socks4://，可带 user:pass@。
每个服务商单独设置：「跟随全局」「直连」「系统代理」或「自定义代理地址」四选一。
「测试代理」和「测试连接」走的是和正式请求相同的代理路径。

Agent 工具

每次请求时，插件会往系统上下文里注入一小段说明，列出已配置 Key 的服务商（id、模型、是否支持编辑），这样 Agent 就知道可以生图、也能按用户要求指定服务商。

后台生图与正文内联显示

三个工具都有 background 参数，由 Agent 自行决定是否阻塞：
- 阻塞（默认）：等图片生成完再继续，适合"图片就是要交付的东西"的场景（海报、Logo）。
- 后台（background: true）：立即返回，Agent 继续输出文字，适合讲解里的配图、示意图。回复可以比图片先结束。
每次生图都会分配一个任务 ID，工具结果里带有 genimg:<任务 ID> 引用。配合 @copylee/dsh-better-display，模型把它写成 ![说明](genimg:<任务 ID>)，图片就会以原始宽高比显示在回复正文里。后台任务未完成时显示同比例的"生成中"占位，完成后自动换成图片。
后台任务失败时，插件会通知 Agent：Agent 空闲时唤醒它说明原因或重试，正忙时并入它的下一步。成功只静默记录，不会额外打开新一轮对话。
任务状态接口：GET /plugins/copylee-image-gen/jobs/<id>（JSON），GET /plugins/copylee-image-gen/jobs/<id>/image（图片）。已完成的任务记在画廊里，重启后仍可显示。

关闭对话生图

设置 > 插件 > 图像生成 > 对话 >「允许 Agent 在对话中生图」。关闭后对话里不再提供 paint_image / paint_images / edit_painting，也不再注入服务商说明；绘画页不受影响，切换即时生效。

分辨率、收藏 Prompt 与本地文件

分辨率：ModelScope、硅基流动、OpenAI 系、DashScope、智谱、Seedream 可以在「标准 / 1K / 1.5K / 2K / 自定义宽×高」之间选择。自定义尺寸会按各服务商允许的范围和步长自动对齐；Gemini、xAI 仍然用清晰度档位。
收藏 Prompt：点输入框的书签按钮，或在空输入框里按 /、Ctrl/⌘+K，弹出收藏列表：点击替换、Shift+Enter 追加，还能收藏或取消收藏当前 Prompt。「收藏 Prompt」页签里可以直接编辑。
本地文件：每张图在「图片保存目录」（默认 ~/.dsh/storages/copylee-image-gen/images/，可在设置里修改）保存一份带可读文件名的副本，按月份分文件夹。画板工具栏和大图查看器里的「在文件夹中显示」会在资源管理器 / 访达中定位到该文件。

数据与隐私

API Key 存在 DSH 凭据库里（记录名为 copylee-image-gen/<服务商 id>），浏览器端永远拿不到明文。宿主不支持记录 API 时，会退回到权限为 0600 的 keys.json。
设置保存在 ~/.dsh/storages/copylee-image-gen/settings.json，画廊保存在 gallery.json。可以用 COPYLEE_IMAGE_GEN_HOME 或插件配置项 dataDir 换目录。
Prompt 和参考图会发送给你选择的服务商。

开发

pnpm install
pnpm typecheck
pnpm test        # vitest，包含本地 HTTP / SOCKS5 代理的端到端测试
pnpm build       # 输出 lib/index.js（Host）和 lib/client.js（浏览器）
pnpm pack:check

本地联调：DSH 桌面版“添加插件”里填本仓库目录路径（以 link 方式安装），pnpm build 后重启 DSH 生效。

路线图

后续计划：Prompt 灵感库、多模型横向对比、本地 ComfyUI、订阅账号登录（免 Key）、无限画布。

许可证

MIT（自有代码）。从上游移植的文件按 Apache-2.0 授权，详见 NOTICE。

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme