前言¶

DeepSeek Harness（DSH）采用插件化架构。在开发智能体或日常使用中，往往需要直接在工具链里生成图片，而不是切换到外部应用。dsh-image-gen 插件在 DSH 左侧栏提供了一个全局画廊（布局参考 Cherry Studio），并为 Agent 提供了对话生图与编辑工具。

功能¶

该插件主要提供以下能力：

侧边栏绘画：左侧栏新增「绘画」入口。包含画廊项目、参数设置（服务商/模型/比例/清晰度等）、画板区域和历史记录。
侧边栏图库：浏览所有项目，支持搜索、筛选、收藏、批量操作（移动/下载/删除）以及导入本地图片。
收藏 Prompt：提供书签按钮和快捷键（如 / 或 Ctrl/⌘+K），可快速管理常用提示词。
对话工具：Agent 需要配图时会自动调用以下工具：
- paint_image：单图生成。
- paint_images：一次生成多张（最多 8 张）。
- edit_painting：图生图或改图，支持上传图片、对话附件或文件路径。
自定义端点：预置多家服务商，同时支持添加任意数量的自定义端点，并可自动拉取模型列表。
代理设置：支持全局代理（系统代理或自定义）以及单个服务商的独立代理配置，并提供测试连接功能。
后台生图：工具支持 background 参数。设置为 true 时，任务在后台执行，Agent 可继续输出文字，图片以 genimg:<任务 ID> 的形式在 Markdown 中内联显示。

安装命令：

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

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

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

运行环境：
* DSH 版本：0.1.7+
* Node.js 版本：^22.19.0 或 >=24

服务商配置：
安装后，左侧栏会出现「绘画」入口。打开后点击右上角设置，或进入 设置 → 插件 → 图像生成，配置至少一个服务商的 API Key。

自定义端点：
在设置中点击「服务商 +」新建。选择接口协议（预置支持 ModelScope、Gemini、OpenAI、硅基流动等），填写名称、API 地址、Key 和模型（支持「拉取模型」）。

Agent 调用与显示：
Agent 在判断需要配图时会调用 paint_image 等工具。后台任务未完成时，配合 Markdown 语法 ![说明](genimg:<任务 ID>) 可显示同比例的「生成中」占位符，完成后自动替换为图片。

数据存储：
画廊数据存放在 ~/.dsh/storages/copylee-image-gen/gallery.json，图片本体存储在 DSH 附件库。Prompt 和参考图会发送至配置的服务商。

共存性：该插件与原插件 dsh-image-gen 使用不同的包名、路由和数据目录，两者可以同时安装。
授权：自有代码按 MIT 授权，移植文件按 Apache-2.0 授权，详见 NOTICE。
隐私：API Key 存储在 DSH 凭据库中，浏览器端无法获取明文。Prompt 和参考图会发送给服务商。
目录配置：默认数据目录为 ~/.dsh/storages/copylee-image-gen/，可通过环境变量 COPYLEE_IMAGE_GEN_HOME 或插件配置项 dataDir 修改。