DeepSeek-Harness 图像生成插件
dsh-yali-image-generator 是一个可独立安装的 DeepSeek Harness Bundle，为 Agent 提供 generate_image 图像生成工具，并通过 Yali AI 异步图像网关调用模型。
包名和 Harness 模块名使用官方示例一致的 dsh- 前缀；面向用户的插件名称和工具说明统一为“DeepSeek-Harness 图像生成插件”。
官方规范符合性
本插件遵循 DeepSeek Harness 的 docs/user/develop/basic 与 docs/cookbook/adding-a-tool.md：
- 这是 Bundle，不是 Profile；
package.json 通过 dsh.bundle.patch 声明安装补丁。
- 插件导出
name、inject = ['tools', 'credentials']、Schemastery Config 和 apply(ctx, config)。
- 工具通过
ctx.tools.register(defineTool(...)) 注册；执行结果是由 output.schema 定义的规范 JSON，模型可见文本由 output.render 单独渲染。
- 接口地址、密钥环境变量、模型默认值、输出位置、超时和轮询参数均为可配置项；配置或凭据错误会明确失败。
完整逐条审计见 COMPLIANCE.md。
支持的模型与接口
| 模型 | 接口 | 规格 | 说明 |
|---|
gemini-3.1-flash-image-preview | POST /v1beta/models/{model}:generateContent | 1K、2K、4K | 支持完整 Gemini 宽高比；使用 contents、responseModalities: ["IMAGE"] 与 imageConfig。 |
gemini-3-pro-image-preview | 同 Gemini 原生接口 | 1K、2K、4K | 默认的第二阶段超分模型。 |
gpt-image-2 | POST /v1/images/generations 或 /v1/images/edits | 1K、2K、4K | 根据宽高比映射为像素 size，发送 quality、n: 1、output_format 和 async: true。 |
grok-imagine-image-quality | OpenAI 兼容 generations/edits 接口 | 1K、2K | 使用 resolution 与 aspect_ratio，不会发送 quality 或 size。 |
agnes-image-2.1-flash | POST /v1/images/generations | 1K、2K、3K、4K | 使用 size、ratio；参考图写入 extra_body.image，不会发送 quality。 |
Gemini 的本地参考图使用 inlineData，URL 参考图使用 fileData。GPT 的本地参考图采用 multipart image，URL 参考图采用 JSON image。所有模型均使用异步任务：提交请求、校验 202 和 task_id、轮询 query_path，再下载或解码首个图像结果。
安装
npm 安装
发布到 npm 后，用户可直接安装：
dsh plugin --profile web add dsh-yali-image-generator
dsh web --dump-config
dsh web
GitHub 安装
公开 GitHub 仓库发布后，也可以直接从 Git 安装：
dsh plugin --profile web add github:pptt121212/dsh-yali-image-generator
dsh web
GitHub 仓库与 npm 包均使用 dsh-yali-image-generator。
自定义或无界面 Profile 使用相同方式：
dsh plugin --profile my-profile add dsh-yali-image-generator
dsh --profile my-profile --dump-config
dsh --profile my-profile
本包直接发布 ESM 运行时文件，不需要构建步骤或 prepare 脚本。
配置密钥
请先在 Yali AI 申请 API Key。
在 Harness 的凭据设置中保存所选模型系列对应的密钥，凭据引用名称如下：
$env:YALI_GEMINI_API_KEY = "..."
$env:YALI_GPT_API_KEY = "..."
$env:YALI_GROK_API_KEY = "..."
$env:YALI_AGNES_API_KEY = "..."
也可以在启动 Harness 的环境中设置同名变量。插件会在每次生成时通过 Harness 凭据服务解析密钥，因此在设置页保存或更新密钥后无需重装插件。默认接口地址为 https://api.yaliai.com。密钥引用名称、接口地址、默认模型、规格、质量、超分参数、输出目录和异步超时均可通过安装后的 Profile 配置修改。
使用方式
在 DeepSeek Harness 中直接让 Agent 调用 generate_image，例如：
请使用 generate_image 生成一张 16:9、4K 的电影感夜间图书馆，暖色台灯照亮书桌。
常用参数：prompt（必填）、model、aspect_ratio、image_size、quality、reference_image_paths、reference_image_urls、output_name。generation_mode: "upscale" 会先生成基础图像，再由 upscale_model 完成第二阶段超分。默认输出目录为 ./generated/yali-images。
