[English](README.md) | [简体中文](README.zh.md)
# dsh-imagegen —— DSH 生图插件

给 DeepSeek Harness 的 agent 注册 `generate_image` 工具：doubao Seedream 5.0 Pro/ qwen-image-3.0-pro。

## 安装

```powershell
# npm
dsh plugin --profile <名字> add @little-traincar/dsh-imagegen

# GitHub 
dsh plugin --profile <名字> add github:little-traincar/dsh-imagegen#v0.1.1

# tarball
dsh plugin --profile <名字> add ./dsh-imagegen-0.1.0.tgz
```

GitHub 安装首次会被 pnpm 拦截构建授权：按 `dsh` 提示把包键加进该 profile 的 `pnpm-workspace.yaml`：

```yaml
allowBuilds:
  '@little-traincar/dsh-imagegen': true
```

（源码 checkout 用户也可以：`pnpm dsh web --patch <仓库>/imagegen/cordis.yml`）

## 删除
```
# pnpm
dsh plugin --profile <名字> remove @little-traincar/dsh-imagegen
```

## 使用

1. 重启 dsh → 设置 → imagegen → 填豆包/qwen key → 保存（即时生效；也可用环境变量 `ARK_API_KEY` / `DASHSCOPE_API_KEY`）。
2. 会话里说需求：

> 画一张夏日咖啡店促销海报：复古杂志拼贴风，奶油黄+咖啡棕，竖版；文字：主标题「夏日冰咖节」副标「全场第二杯半价」；

图片内嵌显示在对话里，并存档到 `outDir`（默认 `<启动目录>/generated-images`，可在设置或 patch 里改）。

**图生图**：把图贴进会话（或给本地绝对路径/URL），说“把这张图改成国潮风 / 换个背景”——agent 会通过 `image` 参数基于参考图重绘。

## 配置（优先级：GUI 设置 > cordis.patch.yml > 环境变量）

| 项 | 默认 | 说明 |
|---|---|---|
| `apiKeys.*` | 空 | 豆包 / qwen key；环境变量 `ARK_API_KEY` / `DASHSCOPE_API_KEY` |
| `baseUrls.*` | 官方 | 可指向任意 OpenAI 风格 `/images/generations` 兼容网关 |
| `models.*` | 快照 ID | 豆包别名会 404，勿改回 `doubao-seedream-5-0-pro` |
| `outDir` | 启动目录下 `generated-images` | 落盘目录（绝对路径） |
| `count` / `aspect` / `attachToConversation` / `requestTimeoutMs` | 2 / 2:3 / true / 300000 | 出图习惯 |


## 其他
依赖版本与目标 dsh 版本配套；若安装报“版本不存在”，把 `package.json` 依赖版本对齐到你的 dsh 版本。
如果遇到无法输入api，请检查你的dsh版本，本插件基于0.1.3-alpha.2开发。
本项目由 AI 辅助开发（vibe coding）完成，已通过本地冒烟测试与真实 API 调用验证（豆包真机出图、水印关闭、附件入库、会话内嵌均实测通过）；发现异常欢迎提 issue 或 PR。