dsh-imagegen 使用指南

为 DSH Web GUI 增加 AI 生图侧边栏，代理 OpenAI 兼容接口，支持文生图、图生图、历史与提示词模板库。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add @dickpy/dsh-imagegen

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

文生图与图生图：输入提示词生成图片，或上传 PNG、JPG、WEBP 参考图进行编辑。
可调生成参数：尺寸、清晰度、生成数量和细节等级均可在界面中选择；未指定的参数保持自动。
结果操作：结果区固定为四分格：单图铺满，双图占上排，三图占三格，四图为 2×2；支持下载、全屏预览、可滚动缩放、前后切换、复制优化提示词，以及一键将当前图片添加到图生图。
持久化历史：保存提示词、参数和图片；支持查看、恢复、单条删除和清空，最多保留 50 条。
跨设备查看：历史保存在 DSH 宿主侧，连接同一 DSH 的浏览器或设备共享同一份记录。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装后在哪里打开生图功能？

重启 dsh web 后，左侧栏会出现「AI 生图」入口；首次使用需在「设置 → 插件 → 可配置」中填写 API 地址与密钥。

必须使用 OpenAI 官方接口吗？

不一定。插件对接 OpenAI 兼容的 /images/generations 和 /images/edits 端点，理论上任何提供这两个接口的服务都可以接入。

生成请求需要带图片上传还是仅文本？

两种都支持。文生图只需提示词；图生图需上传 PNG/JPG/WEBP/GIF 参考图，单张上限 10MB。

历史记录存放在哪里？

图片和索引保存在本机的 ~/.dsh/dsh-imagegen/ 目录（图片独立落盘，index.json 存元数据），最多保留 50 条，连接同一 DSH 实例的浏览器/设备共享。

提示词模板库需要联网吗？

模板案例列表随插件打包，开箱即用；每个案例的展示图按需从 vibeui.top 镜像拉取并缓存到本机 ~/.dsh/dsh-imagegen/template-images/，二次查看不需联网。

插件会自动更新吗？

不会自动更新。工作台启动时会检查 GitHub Releases，发现新版本会在面板顶部显示更新按钮，点击后由宿主执行安装，需重启 dsh web 加载新版本。

卸载后历史和缓存会一起清掉吗？

不会。卸载插件后，历史图片和模板图片仍留在 ~/.dsh/dsh-imagegen/ 目录，需要手动删除。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则