dsh-image2-tool

使用示例

下面两张图来自一次真实会话：让 Agent「生成一张 GPT 化龙指导器的形象」，它自己挑参考图、比对版本、迭代出成品。

对话里长这样 —— 生成过程、参考图、版本对比都在回复里，图片由内联预览直接渲染，不用点开任何卡片（长图，可点开看全）：

最终结果 —— 该会话产出的成品（864 × 1152）：

复现方式：装好插件后直接对 Agent 说「生成一张 XXX 的图」即可。autoGenerateAssets 保持默认 false 时，只有你明确要求才会生图。

配置

两种方式等价、可互换，二选一即可。

① 图形界面：侧边栏 → Plugins → dsh-image2-tool → image2 行，逐项填写（含遮蔽的 apiKey 密钥字段），保存即写回当前 profile 的 Cordis patch。

② 配置文件：$DSH_HOME/profiles/ /cordis.patch.yml（未设置 DSH_HOME 时为 ~/.dsh/profiles/ /cordis.patch.yml）：

- id: image2
  name: dsh-image2-tool
  config:
    baseUrl: https://your-image-relay.example.com/v1
    model: grok-imagine-image-2.0
    apiKeyEnv: IMAGE2_API_KEY
    autoGenerateAssets: false
    outputDir: imagegen-output
    timeoutMs: 180000
    responseFormat: b64_json

字段	说明
baseUrl	中转站地址（OpenAI 兼容，含 /v1）
model	模型名，必须是该中转站 /v1/models 里真实存在的名字，否则调用返回 404
apiKeyEnv	API key 的环境变量名（不是 key 本身）
apiKey	设置页里的遮蔽字段；非空时优先于 apiKeyEnv，后者作为兜底
autoGenerateAssets	是否允许在软件开发任务中自动补齐缺失位图素材，默认 false
outputDir	输出目录，相对会话目录解析并强制不越界
timeoutMs	单次请求超时
responseFormat	向中转站索要的返回格式，默认 b64_json（图片字节内联回传）。设 url 则让插件去下载中转站给的链接；设为空字符串则完全不发这个字段，给不接受它的中转站用

API key 交给启动 DSH 的那个进程：

$env:IMAGE2_API_KEY = 'your-image-relay-api-key'
dsh --profile web

已经开着的桌面端不会继承新设的环境变量，需要从带该变量的终端重新启动。别把 key 写进 Git。