dsh-imagegen
dickpy/dsh-imagegen加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
你是否曾幻想过:一边和 AI 对话编程,一边顺手生成配图?dsh-imagegen 正是为这个场景而生——它把 OpenAI 兼容的图像生成 API(gpt-image-2 / DALL-E 3 / gpt-image-1)直接嵌入 DeepSeek Harness 的 Web 界面,让你无需切换工具,在 AI 对话环境中就能完成从想法到配图的全流程。
2026年8月13日,DeepSeek 开源了 DeepSeek Harness(dsh),一个"一切皆插件"的 AI Agent 运行框架。短短两天斩获 95,000+ GitHub Stars,刷新了开源开发工具的增速记录。它将 Agent 运行时、工具注册、会话管理、沙盒、模型适配器全部设计为可插拔模块——模型是插件、工具是插件、记忆是插件,UI 扩展自然也是插件。
dsh-imagegen 就是在这个背景下诞生的第三方插件之一。作者 Dick 开发它是为了解决一个实际痛点:在 DSH 的 Web 界面里和 AI pair programming 时,想给代码注释或文档配一张图,得切到另一个窗口调用 API,等返回后再粘贴回来。体验割裂,效率低下。
dsh-imagegen 的生图功能围绕四个核心模块展开:
生图引擎(engine.ts) — 负责与上游 OpenAI 兼容图像生成 API 对接,支持文生图(/images/generations)和图生图(/images/edits)两种请求模式。响应格式兼容 OpenAI 标准 { data: [{ b64_json | url }] },URL 类型图片由宿主下载后转 base64 返回浏览器,规避了 CORS 问题。
历史记录(history-store.ts) — 持久化存储生成的提示词、参数和图片,最多保留 50 条,支持跨浏览器/跨设备查看(因为数据存在 DSH 宿主侧 ~/.dsh/dsh-imagegen/)。生成的图片独立落盘,index.json 保存索引,清理和管理都很方便。
模板库(templates-store.ts) — 内置 441 个 gpt-image-2 官方案例的展示图和完整提示词。用户可以搜索、分类筛选、复制提示词,或一键回填到生图输入框。展示图从 vibeui.top 按需加载并缓存到本地,支持离线浏览。
工作台 UI(ImageGenPanel.tsx) — 三栏布局:左侧参数区、中间结果区、右侧历史记录。结果区自适应 1-4 张图片的显示逻辑,单图铺满、双图横排、三图占上半部、四图 2×2 网格。支持下载、全屏预览、缩放滚动、前后切换、复制优化提示词,以及一键将当前图片加入图生图流程。


dsh-imagegen 不是一个独立应用,它是 DeepSeek Harness 的插件,这意味着必须先装好 DSH(npm i -g @deepseek-ai/dsh)才能使用它。安装方式有四种:
dsh plugin --profile web add @dickpy/dsh-imagegen,一行命令搞定。.tgz 包,用同样命令指定本地路径。git clone → pnpm install → pnpm run build → dsh plugin add link:配置只需填写 API 地址和密钥,界面仅显示是否已配置,密钥保存在宿主侧 ~/.dsh/settings.yaml,浏览器端不接触明文。
无需 GPU——图像生成由远程 API 处理,本地只负责展示和交互。
代码结构清晰,8 个核心模块各司其职:
| 文件 | 职责 |
|---|---|
src/index.ts | 插件入口、设置注册、路由挂载 |
src/routes.ts | /api/dsh-imagegen/* 宿主路由 |
src/engine.ts | 上游 API 代理与响应归一化 |
src/history-store.ts | 历史记录和图片持久化 |
src/templates-store.ts | 模板快照、在线刷新、展示图缓存 |
src/client/ImageGenPanel.tsx | 生图工作台 UI |
src/client/TemplateLibrary.tsx | 模板图库 UI |
src/client/SettingsCard.tsx | 插件配置卡片 |
技术栈为 TypeScript + React 18 + Schemastery(作者自创的 schema 验证库),构建工具用 tsdown,发布包名为 @dickpy/dsh-imagegen,遵循 Apache-2.0 许可证。TypeScript 配置开启 strict: true,代码质量有保障。
vibeui.top 按需拉取,该站点可用性不受项目控制。/images/generations 和 /images/edits 接口,不支持 Midjourney 的 Discord API 或 Stable Diffusion 的本地部署接口。dsh-imagegen 是 DeepSeek Harness 插件生态的一个缩影——它展示了如何将一个专注于"AI 编程 Agent"的工具,扩展成同时具备"AI 绘图"能力的一体化工作台。随着 DSH 插件市场(dsh-market)的成熟,预计会出现更多此类垂直能力插件,共同构建出一个功能丰富的 AI 工作站生态。
本报告基于 v1.0.9 版本生成,项目持续活跃维护中。