dsh-generate-image：通过本地 Codex CLI 生成与编辑图片

DSH 生态强调“一切皆插件”。当智能体需要处理视觉内容时，传统的做法要么依赖昂贵的云端 API，要么需要复杂的本地部署。dsh-generate-image 插件解决了“让模型画图”这一具体痛点，它复用你本机已登录的 Codex 环境，把图像生成能力直接暴露给 DeepSeek 模型。

是什么¶

• 定位：DeepSeek Harness 插件。
• 维护者：zemul。
• 核心价值：通过本地 OpenAI Codex CLI 实现文生图与图生图，无需额外 API Key 或构建步骤。

核心功能¶

• 文生图与图生图：向 Harness 模型暴露 generate_image 工具。支持 generate_image(prompt) 生成全新图片，以及 generate_image(prompt, inputImage) 传入已有图片路径进行编辑。
• 零依赖与零构建：纯 JS 实现，不依赖任何 npm 包，安装后无需构建即可直接运行。
• 结果定位：通过目录快照 diff 定位新生成的图片，不依赖解析模型输出文本。
• 安全与认证：支持超时与信号保护，复用 Codex 登录（OAuth），无需提供 API Key。

安装与启用¶

使用 npx 命令安装（无需本机安装 dsh CLI，npx 会自动拉取官方 dsh）：

npx -y @deepseek-ai/dsh plugin --profile web add github:zemul/dsh-generate-image

本包没有任何生命周期脚本，pnpm 不会要求构建授权。若仍提示构建授权，需在 profile 的 pnpm-workspace.yaml 中加入：

allowBuilds:
  dsh-generate-image: true

重启 GUI 后生效。

典型用法¶

模型在对话中直接调用即可：

• 文生图：

    generate_image("生成一张赛博朋克风格的城市夜景图，霓虹灯紫蓝配色")

• 图生图：

    generate_image("把 ./assets/hero.png 的背景换成渐变星空，保留前景主体", "./assets/hero.png")

工具返回生成图片的绝对路径，模型与用户可直接引用。

适用场景与注意¶

• 前置条件：
  • 需要本地 Codex CLI 登录（OAuth），使用 Codex 内置 image_gen 工具。
  • 消耗 Codex/ChatGPT 账号额度（生图比文本贵）。
  • 需要 Node.js >= 18。
• 文件存储：
  • 图片默认存储在 $CODEX_HOME/generated_images/（默认 ~/.codex）。
  • 插件会拷贝一份到输出目录（默认工作目录）。
• 运行权限：插件以当前 dsh 进程权限运行。安装前请检查源码与许可证（MIT）。

短结尾¶

本插件为 DSH 插件生态引入了本地视觉能力。它通过 Codex CLI 桥接，解决了模型“画图”的需求。更多细节请参考 GitHub 仓库 或 DSH 目录页。