dsh-imggenerate
MultimodalBald0Wang/dsh-imggenerate
Image generation plugin for DeepSeek Harness: registers image_generate tool with qwen-image-3.0 (Aliyun MaaS) and doubao-seedream (Volcano Ark) providers.
- dsh-plugin
Verification and compatibility
This section shows evidence collected by the catalog. Undeclared information is labeled as unknown.
- Current-version compatibility
- Verified on the catalog Harness version
- Declared Harness range
- Not declared
- Declared platforms
- Not declared
- Profiles
- demo
- Build approval
- Unknown
- Permissions
- Not declared
- External services
- Not declared
- Telemetry
- Unknown
This is not a security endorsement. Review source, permissions, and configuration before installing.
View evidence and scope
Verification covers only the named source, version, and Harness environment. It does not guarantee future compatibility.
github:Bald0Wang/dsh-imggenerate#dcf79bcf591294e4d737095dc283529070439728- The manifest and static structure passed checks; a runtime load check has not completed.
README
dsh-image-gen
DeepSeek Harness 图片生成插件：给 agent 注册一个 image_generate 工具，让 dsh 里的大模型可以直接画图。
双通道支持：
| Provider | 模型 | 能力 |
|---|---|---|
volcano（火山方舟，默认） | doubao-seedream-5-0-pro-260628 | 文生图、图生图（referenceImage）、size 1K/2K/4K 或 WxH、水印开关 |
qwen（阿里 MaaS） | qwen-image-3.0-pro | 文生图、promptExtend 提示词扩写 |
纯 JavaScript、零构建步骤，安装时无需 pnpm 构建授权。
安装
方式一：装进 profile（推荐）
dsh plugin --profile demo add github:Bald0Wang/dsh-imggenerate
dsh --profile demo
或从本地目录 / npm / tarball 安装：
dsh plugin --profile demo add ./dsh-image-gen # 本地目录
dsh plugin --profile demo add dsh-image-gen # npm（如已发布）
dsh plugin --profile demo add ./dsh-image-gen-0.1.0.tgz
方式二：不安装，直接 overlay
git clone https://github.com/Bald0Wang/dsh-imggenerate.git
cd dsh-imggenerate && npm install
cp quick.example.cordis.yml quick.cordis.yml # 填入你的 key 与绝对路径
npx @deepseek-ai/dsh web --patch "$PWD/quick.cordis.yml"
配置 API Key（必做）
插件不携带任何密钥。二选一：
A. profile 用户层（推荐） — 编辑 $DSH_HOME/profiles/<name>/cordis.patch.yml（dsh web 对应 web profile），覆盖 image-gen 行（用户层在包层之后生效，需重述整个 config）：
- id: image-gen
config:
defaultProvider: volcano
qwenApiKey: 'sk-ws-...'
volcanoApiKey: 'your-ark-key'
B. 环境变量 — DASHSCOPE_API_KEY（qwen 通道）、ARK_API_KEY（volcano 通道）。显式 config 优先于环境变量。
配置项（cordis.yml 中 config 下覆盖）
| 键 | 默认值 | 说明 |
|---|---|---|
defaultProvider | volcano | 未指定 provider 参数时使用 |
timeoutMs | 180000 | 单次请求超时 |
qwenEndpoint / qwenModel / qwenApiKey | 见 index.js | 阿里 MaaS 通道 |
volcanoEndpoint / volcanoModel / volcanoApiKey | 见 index.js | 火山方舟通道 |
volcanoSize / volcanoWatermark | 2K / true | 火山默认尺寸与水印 |
工具参数（模型侧）
prompt（必填）、provider（qwen/volcano）、size、referenceImage（仅火山，图生图）、watermark（仅火山）、promptExtend（仅 qwen）、seed。
返回规范输出 {provider, model, images:[{url}], size?, watermark?}；工具结果以文本块携带 URL（供应商 URL 一般 24 小时过期，需及时下载）。
验证安装
启动日志应出现 [image-gen] registered image_generate tool；新开会话对模型说「用 image_generate 画一张……」。也可用 dsh --profile <name> --dump-config 查看是否包含 # == dsh-image-gen 层。
