dsh-sai-image

DSH 图片生成插件：在 Harness Web UI 内用中文 / 英文提示词生成图片。内置 Agnes AI，其它 OpenAI 兼容服务（SenseNova 等）按「名称 + API 地址 + 密钥」自行接入；模型清单从 /models 拉取后勾选，档位与宽高比自动换算成精确像素。带参考图编辑、历史记录、提示词模板、任务队列、图库选图与内置服装参考图库（1407 件，可一键补全下载），全部数据保存在本机。

安装 / Install

在 DSH 的会话里对助手说（或通过 Plugin Manager 界面操作）：

用 plugin_manager 的 install_bundle 安装 https://github.com/saithink/dsh-sai-image.git

克隆：

git clone https://github.com/saithink/dsh-sai-image.git

无需构建步骤——安装即用。@deepseek-ai/schemastery 依赖随安装自动解析。

使用 / Usage

1. 侧边栏面板图标进入整页面板；七个页签：生成 · 图片编辑 · 服装管理 · 提示词模板 · 任务列表 · 历史 · 配置。
2. 生成：写提示词 → 选模型 / 分辨率档位（1K–4K）/ 宽高比（或自定义 W×H）→ 生成（Ctrl/⌘+Enter 亦可）。
3. 图片编辑：选 1–8 张参考图（本机文件 / 插件图库 / 服装库）→ 写修改指令 → 基于参考图编辑。浏览器侧自动缩图到长边 ≤ 1024px 再上传。
4. 服装库：按分类（春/夏/秋/冬/内衣/性感/泳装/派对）与标签筛选，点卡片选中 →「选择此服装」加入参考图。
5. 首次安装后服装库没有图片——点工具栏的「⬇ 一键下载缺失图片」：宿主进程读取 costume-gallery/manifest.json，只下载缺失的 thumbs/ 与 img/（12 并发、4 次重试、原子落盘），完成后自动续用。也可用 python costume-gallery/scripts/download.py 手动拉取。
6. 配置：服务商 / 密钥 / 模型勾选 / 默认尺寸 / 超时 / 历史保留，保存在 <DSH_HOME>/sai-image/config.json，重启生效。

数据与安全

• API 密钥只保存在宿主进程的本机数据目录，页面通过已鉴权的 /api/sai-image/* 路由访问，密钥永不进入浏览器。
• GET /config 只返回脱敏提示（sk-u…6789 形式）。
• 自定义服务商地址受 SSRF 防护：回环 / 私网 / 链路本地地址默认拒绝。

服装库素材版权

costume-gallery/ 里的代码与中文数据按 LICENSE（MIT）与 CC BY 4.0 提供；服装图片不在仓库内、不随插件分发——素材版权归 ギア (@giaaibusi) 所有，原站条款禁止再分发。一键下载功能只从原始站点把素材拉取到本机供个人参考，详见 costume-gallery/NOTICE.md。

开发

pnpm install        # 安装 schemastery 依赖
pnpm test           # node smoke-test.mjs + node render-test.mjs

• smoke-test.mjs — 宿主半区：挂载插件、走真实路由分发器覆盖每个接口（上游 fetch 打桩）。
• render-test.mjs — 客户端半区：微型 hooks 运行时驱动面板渲染与交互断言，无需浏览器。
• costume-gallery/scripts/ — 服装库数据管线的 Python 工具（manifest / 构建 / 下载 / 校验）。

License

代码 MIT（见 LICENSE）；服装图片素材版权与使用条款见 NOTICE.md。