@dsh-external/dsh-image-gen
DSH 通用图像生成插件：接入任意 OpenAI 兼容生图网关（自定义 baseUrl + 模型 + API Key），设置页可视化配置。工具 dsh_image_gen / dsh_image_gen_config + 命令 /dsh-image-gen + skill。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:hoyyang/dsh-image-gen#304fb01d41d7e37bc0b013787dc652e6bf38846fImage Gen 以 @dsh-external/dsh-image-gen 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness 的通用 AI 生图插件
接入任意 OpenAI 兼容生图网关 · 设置页可视化配置 · 一句话出图
🌐 Language / 语言：简体中文 · English
dsh-image-gen 让 DeepSeek Harness 的智能体直接生成图片： 任意生图网关、任意生图模型，三个字段配好即可用，无需改任何代码。
/dsh-image-gen 一只趴在窗台上的橘猫，即调即出前提：已安装 DeepSeek Harness（
dsh命令可用）。
① 安装
dsh plugin --profile web add github:hoyyang/dsh-image-gen
锁版本可加标签：dsh plugin --profile web add github:hoyyang/dsh-image-gen#v0.2.2
② 配置（30 秒）
重启 dsh web 后，打开 设置 → 插件 → dsh-image-gen，填三样保存：
| 字段 | 填什么 | 示例 |
|---|---|---|
| 网关 base URL | 生图网关的根地址（https） | https://你的网关.example.com/v1 |
| 模型 | 网关接受的生图模型名 | gpt-image-2 |
| API Key | 网关密钥 | sk-xxx（仅存本机） |
③ 出图
在输入框输入：
/dsh-image-gen 一只趴在窗台上的橘猫，午后阳光，油画风格
也可以直接对话：「帮我生成一张 xx 的图」，智能体会自动调用工具。
| 方式 | 示例 | 适用场景 |
|---|---|---|
| 命令 | /dsh-image-gen <描述> [--size=1024x1536] [--quality=high] | 确定性触发，不经模型回合 |
| 对话 | 「生成一张赛博朋克城市海报」 | 让模型自己决定何时出图 |
| 工具 | dsh_image_gen | 脚本化 / 手动调用 |
| 配置检查 | dsh_image_gen_config | 免费：只查配置，不产生账单 |
参数：--size=1024x1024｜1024x1536｜1536x1024｜auto，--quality=low｜medium｜high（--low/--medium/--high 可简写）。
四种方式任选其一，优先级从高到低：环境变量 > 设置页 > profile 配置 > 本地文件。
方式一：设置页（推荐） —— 见「快速开始 ②」，可视化、即时生效。
方式二：环境变量
export DSH_IMAGE_BASE_URL="https://你的网关.example.com/v1"
export DSH_IMAGE_MODEL="gpt-image-2"
export DSH_IMAGE_API_KEY="sk-xxx"
方式三：profile 配置 —— 在 profile 的 cordis.patch.yml 中给插件行加 config: 块（见仓库内 cordis.patch.yml 的注释示例）。
方式四：本地文件 —— 适合无 UI 的 profile（文件权限须 0600）：
cat > ~/.dsh/dsh-image-gen.json <<'EOF'
{
"baseUrl": "https://你的网关.example.com/v1",
"model": "gpt-image-2",
"apiKey": "sk-xxx"
}
EOF
chmod 600 ~/.dsh/dsh-image-gen.json
其余可选项：
| 项 | 默认值 | 说明 |
|---|---|---|
| imagesPath | /images/generations | 生图接口路径（个别网关路径不同时改它） |
| outputDirectory | ~/.dsh/generated_images/dsh-image-gen/ | 出图目录（0700） |
| timeoutMs | 300000 | 上游超时（毫秒） |
只要你的网关支持 OpenAI Images API 形状即可接入：
POST {baseUrl}/images/generations
Authorization: Bearer <API Key>
{ "model": "...", "prompt": "...", "n": 1, "size": "1024x1024", "quality": "high" }
响应: { "data": [ { "b64_json": "..." } ] }
返回 URL 而非 b64_json 的网关暂不支持（欢迎 PR）。
Q：报「No gateway base URL configured」？ A：四种配置方式都没生效，先跑 dsh_image_gen_config 看具体缺什么。
Q：改了设置页没生效？ A：设置页保存即时生效；环境变量改完需重启 dsh。
Q：网关模型名带前缀（如 azure_openai/...）？ A：把网关要求的完整模型名填进「模型」字段即可，插件原样透传。
Q：图存到哪了？ A：默认 ~/.dsh/generated_images/dsh-image-gen/，生成后命令/工具会返回完整路径。
pnpm install
bash scripts/build.sh # tsc 编译 host + tsdown 打包 client（lib/client.js）
MIT © 2026 Hoy Yang