dsh-imagegen-zhenzhen

为 DeepSeek Harness（dsh）准备的 AI 生图插件， 原生适配 zhenzhen-image 这类「异步任务式」生图网关（apib 系聚合网关，如 api.seedance.nz）。

它是 @dickpy/dsh-imagegen 的 fork： 生图工作台、画廊、多模型对比、无限画布、提示词模板库全部保留，只把 host 端的协议层 换成了对这类网关的原生实现。

为什么需要 fork：上游把端点路径、task_id 位置、轮询地址、结果字段都硬编码成 OpenAI 的 标准形状（/images/generations、data[0].task_id、/tasks/{id}、result.images）， 而这类网关实际是 POST /image/generations → 顶层 task_id → GET /image/generations/{id} → data.data.content.image_url。差异集中在一个文件里，本 fork 把它们改了过来。

特性

能力	说明
文生图	POST {base}/image/generations 提交，轮询到 SUCCESS 取图
图生图	本地参考图先上传到网关自带的 POST {base}/files/upload 换取公网 URL，再作为 image 提交
多参考图	网关的 image 字段是单值，插件会把多张图本地拼成一张网格再上传（2 张横排 / 3–4 张两列）
参数映射	面板比例直接作为 size 透传；清晰度档位映射为 resolution（1k/2k/4k）
无需桥接	协议适配在插件内部完成，不需要常驻代理进程，也不需要外部图床
完整界面	生图工作台、画廊、多模型对比、无限画布、提示词模板库（继承自上游）

安装

# 从 GitHub
dsh plugin --profile web add github:netori/dsh-imagegen-zhenzhen

# 或从本地目录
dsh plugin --profile web add /path/to/dsh-imagegen-zhenzhen

装完重启 DSH（host 端插件不会热重载）。

⚠️ 依赖提示：本插件多图拼接用到 jimp。PNPM 不会为 link: / 本地目录安装子依赖， 所以本地安装时要补一句：

cd ~/.dsh/profiles/web && pnpm add jimp@1.6.1

若多图拼接报 Cannot find package 'jimp'，就是漏了这步。

配置

在「设置 → 插件 → AI 生图」里添加渠道，或直接写 ~/.dsh/settings.yaml：

dsh-imagegen:
  enabled: true
  allowAgentImageGeneration: true
  defaultChannelId: my-gateway
  channels:
    - id: my-gateway
      name: 我的网关
      apiUrl: https://api.example.com/v1
      models:
        - { alias: zhenzhen-image-g-v2.5-flare, id: zhenzhen-image-g-v2.5-flare }
  channelSecrets:
    my-gateway: "<你的 API key>"

• apiUrl 填基地址（含 /v1），插件会自动追加 /image/generations 与 /files/upload。
• 模型 id 需匹配 /^zhenzhen-image/i 才会走本 fork 的原生协议分支； 其它模型仍按上游的各族协议（Seedream / Qwen / MiniMax / Grok / Nano Banana / 智谱）处理。

用法

• 对话：说「画一张…」，Agent 调用 generate_image
• 改图：把图交给 Agent 说「改成…」，或输入 /edit_image 把背景换成夜景
• 面板：侧边栏「生图」Tab —— 文生图 / 图生图、多模型对比、画廊、模板库、无限画布

已知限制

1. 多图是「拼接」而非原生多图。上游端点只接受单张参考图（实测 images / image_urls / reference_images 等 8 个候选字段名在平台结构体里都不存在）。拼接适合「融合多个元素」， 但对需要逐张独立理解的精细任务（如严格人脸一致性）不如原生多图。拼图总边长上限 4096px。
2. 图生图多一次上传，比文生图慢约 1–2 秒。
3. 面板 9 档比例未逐一验证：1:1、2:3 已验证通过；若某档被上游拒绝， 在 src/engine.ts 的 effectiveParams() zhenzhen 分支加一张比例映射表即可。
4. API key 明文存放于本机 settings.yaml（上游插件的既有行为，未改动）。
5. 不要与 dsh-image-gen 同时启用：两者都注册 generate_image / edit_image， DSH 的工具表对重名会直接抛错。

开发

host 端必须构建（源码用了 TS parameter property，Node 的 strip-only 模式不支持）。

# 一次性准备工具链
mkdir -p ../.build && cd ../.build
npm install tsdown lightningcss lucide-react

# 构建两端（或直接双击 rebuild.cmd，它会自动软链依赖并清理）
cd /path/to/dsh-imagegen-zhenzhen
../.build/node_modules/.bin/tsdown --config tsdown.config.ts        # host + client
../.build/node_modules/.bin/tsdown --config tsdown.node.config.ts   # 仅 host（改后端时更快）

产物：lib/index.js（host）与 lib/client.js（浏览器端，含 __ModuleLoader__ 注册）。 改完必须重启 DSH 才会加载新的 host 代码。

目录

src/
  engine.ts           协议适配核心（提交 / 轮询 / 取图 / 上传 / 多图拼接）
  model-catalog.ts    模型家族识别（含 zhenzhen）
  index.ts            插件入口（name / inject / Config / apply）
  routes.ts, task-queue.ts, agent-image-tools.ts, ...   上游原有实现
  client/             浏览器端源码（构建产物为 lib/client.js）
lib/                  构建产物（已提交，便于直接安装）
FORK-NOTES.md         维护者笔记：改了什么、为什么、如何验证
NOTICE                Apache-2.0 要求的修改声明

License

Apache-2.0（继承自上游）。修改声明见 NOTICE。 本项目为 community fork，与 DeepSeek、From Software 及上游作者均无隶属关系。