dsh-imagegen

给 DSH 用的图片生成插件：直接调 New API 中转站（guaihub 等）的 OpenAI 风格接口出图，图片会显示在对话的工具卡片里，同时可以落盘到工作区。

为什么不是"选个图片模型当聊天模型"

DSH 里 guaihub provider 走的是 api: anthropic-messages（聊天协议），gpt-image-2、gemini-3-pro-image-preview、grok-imagine-image 这些被声明成聊天模型是出不来的，永远只回文字。 中转站本身有 POST /v1/images/generations，这个插件直接打那个接口，跟网页版 Studio 用的是同一套后端。

注册的工具

工具	作用
generate_image	文字生成图片（prompt / model / size / n / quality / background / save_path）
list_image_models	从 GET /v1/models 里过滤出可用的图片模型名

默认模型 gpt-image-2，默认尺寸 1024x1024。

配置

宿主侧 Config（可在 DSH 的插件配置界面里改，或写进 profile 的 cordis.patch.yml）：

键	默认值	说明
baseURL	https://guaihub.com	中转站地址
apiKeyEnv	GUAIHUB_API_KEY	密钥名；通过 DSH 的 credentials 服务解析（进程 env → provider 托管存储 → .env），失败再退回 ~/.dsh/.credentials.yaml
defaultModel	gpt-image-2	默认图片模型
defaultSize	1024x1024	默认尺寸
outputDir	images	落盘目录（相对会话工作目录）
saveFiles	true	是否把图片写到磁盘
timeoutMs	300000	请求超时

cordis.patch.yml 覆盖示例：

- id: dsh-imagegen
  config:
    defaultModel: gpt-image-2.5-flare
    outputDir: images/gen

备选：命令行脚本 cli/gen.mjs

不想开 DSH 会话、或者要跑插件的图生图 / 视频功能，可以直接用仓库里的 cli/gen.mjs（只依赖 Node，无第三方包）：

$cli = "~/dsh/dsh-imagegen/cli/gen.mjs"   # 换成你本地的 clone 路径

node $cli -p "一只赛博朋克猫，霓虹雨夜" -o images/cat.png   # 文生图
node $cli --list                                          # 列模型
node $cli --edit in.png -p "把背景换成海边"                 # 图生图
node $cli --video -m video-ds-2.0 -p "..." -o out.mp4      # 视频

参数与端点细节见 cli/README.md。

安装（desktop profile —— 当前 DSH 实际在跑的 profile）

插件源码放在 ~/dsh/dsh-imagegen，已用 DSH 自带的插件管理器装进 desktop profile：

plugin_manager(action="install_bundle", target="file:<你本地的 clone 路径>/dsh-imagegen")

它会做三件事：写 ~/.dsh/profiles/desktop/package.json 的依赖、把 dsh-imagegen 追加进 dsh.profile.bundles、把包实体放进 ~/.dsh/profiles/desktop/node_modules/dsh-imagegen，并且热加载（无需重启，装完当次会话里 generate_image 就能用）。

注意 pnpm 对 file: 依赖是复制而不是软链，所以：

• 改完源码要同步：把 ~/dsh/dsh-imagegen 重新 install_bundle 一次，或手动复制 lib/index.js 到 ~/.dsh/profiles/desktop/node_modules/dsh-imagegen/lib/index.js；
• 工作区那份是源码，profile 里那份是运行副本，两边内容目前一致（已核对哈希）。

已验证 / 未做

• 已验证：插件热加载成功，generate_image、list_image_models 出现在宿主工具列表里；Config schema 已注册（include:dsh-imagegen，status schema，可在插件配置界面里改）。
• 已验证：真机出图两次 —— gpt-image-2，产物 ~/dsh/images/plugin-test-cat.png（2081 KB）与 ~/dsh/images/imagegen-gpt-image-2-2026-10-01T06-33-00.png（787 KB）；返回宽高是模型自定的 1254×1254。
• 未做：图生图（/v1/images/edits）与视频（/v1/video/generations + 轮询）尚未包装成工具；gen.mjs 里已经有可用实现。

注意

• 写盘用的是宿主进程里的 node:fs，不经过 DSH 的 fs 沙箱与文件版本观测。
• 密钥不要提交到仓库；本插件只按名字去 credentials 里取。

仓库 / 后续更新

• 公开仓库：https://github.com/dong2007-png/dsh-imagegen。
• 更新流程：改 lib/index.js → 重新 plugin_manager install_bundle（或把文件复制到 ~/.dsh/profiles/desktop/node_modules/dsh-imagegen/lib/）→ git commit → 推送。
• 网络提示：github.com 的 releases/raw 在某些网络下直连不通，可改用第三方镜像（api.github.com 通常直连正常）。
• 推送：先用 gh auth login 登录（或自备 PAT），再带 token 推：

$tok = (gh auth token).Trim()
git push "https://x-access-token:$tok@github.com/dong2007-png/dsh-imagegen.git" main:main

许可证

本项目基于 MIT 许可证 发布，完整条文见仓库根目录的 LICENSE 文件。

MIT License

Copyright (c) 2026 dong2007-png

可自由使用、修改、分发（含商用），需保留版权与许可声明；软件按「原样」提供，不附带任何担保。