v3.1.3

v3.1.3

和视频插件共用 Key。

• 复用 88API-Video-Studio 的 Key：本插件还没有自己的 Key 时，会直接使用视频插件 88API-Video-Studio 保存的 API Key（~/.88api/video-studio.json，视频插件 0.12.0 之前是 ~/.seedance-studio/config.json），不用再配一次。这个 Key 只读取、不复制，视频插件里换了 Key 这边也跟着用新的；--get-config 的「Key来源」会写明来自哪个文件。想给生图插件单独配 Key，照常发给 Agent 让它 --set-key 即可，之后优先用自己的。
• 视频插件 0.12.0 起也会复用本插件的 Key，所以两个插件装哪个先配都行。
• 功能没有其它变化。

升级后：Codex 新建任务，Claude Code / ZCode / Trae 新开对话，以重新加载技能。DeepSeek Harness 在插件设置里卸载后重新添加，再完全退出并重新打开 DSH。

v3.1.2

v3.1.2

适配 Trae。

• Trae 一条命令安装：终端运行 npx skills add blackdm666/88API-image-gen -g -a trae -y，技能装到 Trae 的全局技能目录 ~/.trae/skills/88api-image-gen（Windows 为 %USERPROFILE%\.trae\skills\），新开对话即可使用；升级运行 npx skills update -g -y。也可以手动把技能文件夹复制到这个目录，或者只放进某个项目的 .trae/skills/。
• 技能说明里的适用客户端加上 Trae，功能没有变化。

升级后：Codex 新建任务，Claude Code / ZCode / Trae 新开对话，以重新加载技能。DeepSeek Harness 在插件设置里卸载后重新添加，再完全退出并重新打开 DSH。

v3.1.1

v3.1.1

统一各客户端的插件名称、简介和图标。

• 简介统一为中文：Claude Code、Codex、ZCode、DeepSeek Harness 的插件列表和详情页都显示同一句简介「一个插件调用 88API 全部生图模型，支持 gpt-image、香蕉、Grok 等多种生图模型。适配 Claude、ZCode、DSH 等多种客户端！」
• DeepSeek Harness 显示 88API 图标和名称：插件卡片、详情页和组件行使用和 Codex 相同的 88API 图标，标题显示为「88API-Image-Gen」，不再是默认插画和英文简介。
• 功能没有变化。

DeepSeek Harness 暂不支持插件自动更新：在插件设置里卸载 88API-Image-Gen，再用「添加插件」填入 github:blackdm666/88API-image-gen 重新安装；重新添加后完全退出并重新打开 DSH（托盘里的也要退出），然后新开对话。其它客户端照常更新即可。

v3.1.0

v3.1.0

DeepSeek Harness 可以直接安装本插件了。

• DeepSeek Harness 一键安装：打开「添加插件」，填入 github:blackdm666/88API-image-gen，点「安装」，然后新开对话即可使用，不用再手动复制技能文件夹。装的是和 Claude Code、Codex、ZCode 同一份技能，功能完全一样。
• 原生插件 dsh-plugin-88api-image 停止更新：它只有四个旧模型（含已下线的 gpt-image-2-4k）。装过的请先在插件设置里卸载，再安装本插件。
• 已经把技能文件夹复制到 ~/.dsh/skills/ 的用户：可以继续这样用；如果又装了插件，DSH 用插件装的那份，建议删掉复制的文件夹，免得以后升级时两份版本不一致。
• Claude Code、Codex、ZCode 的安装和使用没有变化。

升级后：Codex 新建任务，Claude Code / ZCode 新开对话，以重新加载技能。DeepSeek Harness 暂不支持插件自动更新，以后升级要先卸载再重新添加。

88API-image-gen v3.0.4

v3.0.4

修正 v3.0.3 新规则和首次配置流程的冲突。

• 首次配置恢复正常：v3.0.3 写了「不得自己把 Key 放进命令行或环境变量」，字面上和首次配置时 Agent 自己运行 --set-key "<KEY>" 冲突，Agent 可能因此不敢帮用户配置。现在写明唯一例外：用户在对话里发来的 Key，可以用 --set-key 保存一次；从文件、环境变量或其它来源拿到的 Key 仍然禁止这样用。读配置文件、为绕过沙箱把 Key 放进命令行或环境变量，仍然禁止。
• 沙箱里 --set-key 写不进时给出明确提示：DeepSeek Harness 等沙箱客户端不允许写 ~/.88api/ 时，不再抛出一长串报错，而是提示 Key 没有保存、需要客户端批准这一条命令写入，或者在客户端环境里设置 API88_KEY。Key 不会改存到工作目录等其它位置。技能说明同步写明：先请客户端批准这一条命令；无法批准时（例如无头运行）告诉用户，然后停止。

升级后：Codex 新建任务，Claude Code / ZCode 新开对话，以重新加载技能。

88API-image-gen v3.0.3

v3.0.3

来自 v3.0.2 的全模型实测和 DeepSeek Harness 实测，修三个问题。

• GPT Image 改图不再被裁成方形：不传 --aspect 时，GPT Image 模型按第一张本地参考图选最接近的支持比例（例如 1536×1024 的参考图出 3:2），并打印提示；Gemini、Grok 本来就跟随参考图，行为不变。显式传 --aspect 时以传入的为准。
• 沙箱客户端里默认目录不可写时自动改用工作目录：DeepSeek Harness 等只允许写工作目录的客户端里，~/Pictures/88api-image-gen 或 ~/.88api/image-gen-jobs 写不进去时，改存到当前工作目录下的 88api-images 和 .88api-image-gen-jobs，并打印实际位置；--job-status 两处都会查。显式传了 --output-dir 时不改动，照常报错。读取配置时顺带的迁移 / 规范化回写失败，也不再让这次运行丢掉已读到的 Key。
• 技能说明禁止直接读 Key 配置文件：Key 只能用 --get-config 检查，不得打开、解析、复制配置文件，也不得自己把 Key 放进命令行或环境变量去绕过沙箱。沙箱里写不进去时不要用 API88_CONFIG_DIR、API88_KEY 或申请完全访问来绕开。
• --self-test 新增 sandbox 用例：目录回退、其它错误照常报出、参考图比例推断。

升级后：Codex 新建任务，Claude Code / ZCode 新开对话，以重新加载技能。

88API-image-gen v3.0.2

v3.0.2

来自 v3.0.1 在 Claude Code 里的实测，补两个小缺口，并重写 README。

• 查看版本：新增 --version（-v），--get-config 也会显示「插件版本」。这两个命令都不联网、不收费。
• 技能说明：写明分辨率和质量档位不影响 gpt-image-*、Gemini、Grok 的价格（按张或按次计费），在这些模型上开 2K/4K 或更高质量档不用再向用户确认；Seedream 2K 比 1K 贵。免费检查命令的列表加入 --version。
• README 重写：按「能做什么 → 快速开始 → 选哪个模型 → 参数速查 → 费用与安全 → 常见问题 → 升级」组织；三个客户端的安装方式收进一张表；补充模型选择表、参数速查表、升级方法；Codex 外网审批、像素对照、命令行用法收进折叠区。

升级后：Codex 新建任务，Claude Code / ZCode 新开对话，以重新加载技能。

88API-image-gen v3.0.1

v3.0.1

修复两个显示问题，补全技能说明。来自 v3.0.0 装进 Claude Code 后的实测。

• 修复：单张文生图结束时打印 Prompt: "undefined"（v2.3.0 起就有）。现在显示实际提示词。
• 修复：进度行原来固定打印 Transport: images，Gemini 走的其实是 Chat Completions，容易误以为走错了接口。现在改为 Route: 行，显示这次实际调用的协议和端点，例如 Route: Chat Completions https://88api.ai/v1/chat/completions 或 Route: Images API https://88api.ai/v1/images/edits (json)。
• 技能说明补全：
  • 写明图片默认保存到 ~/Pictures/88api-image-gen，可用 --output-dir 改。
  • 写明不传 --resolution 时的取值顺序（快速 / 批量模式保存的分辨率，否则清单默认值，目前都是 1K），以及同档位同比例在不同模型上像素不同（1K 16:9：GPT Image、Grok 是 1280×720，Gemini 是 1376×768），付费前可用 --dry-run / --resolve-size 查看。
  • Grok 选模型：生成和编辑默认都用 grok-imagine-image；要更高画质用 grok-imagine-image-quality，要最讲究的排版用 grok-imagine-image-2.0；grok-imagine-edit 和 quality 版是同一个模型，不需要专门选。编辑示例改成 grok-imagine-image。
  • 「更贵的模型先问」改成明确的清单：清单里只有计费方式没有单价，哪些选择要先问用户（Gemini Pro、az 高质量档或 2K/4K、Midjourney）；价格让用户看 https://88api.ai/pricing，不凭记忆报价。
  • 完成汇报去掉了输出里并不存在的「请求槽位」。

升级后：Codex 新建任务，Claude Code / ZCode 新开对话，以重新加载技能。

88API-image-gen v3.0.0

v3.0.0

一个插件调用 88API 全部生图模型，模型能力不再写死在插件里。

• 按模型清单出图：插件读取 88API 文档站发布的模型清单 https://88api.ai/helper/image-models.json（由各生图规范页生成），本机缓存在 ~/.88api/image-models.json，每天更新一次，并内置一份快照 scripts/image-models.snapshot.json 作为离线兜底。清单决定每个模型：
  • 走哪个接口：GPT Image、Grok、Seedream、Midjourney 用 Images API，Gemini 用 Chat Completions；
  • 尺寸怎么传：GPT Image 填像素，Grok 填 aspect_ratio + resolution，Gemini 填 extra_body.google.image_config，Seedream 填档位，Midjourney 在提示词里加 --ar；
  • 参考图怎么传、最多几张：multipart、JSON 的 data URI / 公网 URL，或 Chat Completions 的图片内容；
  • 允许的比例、分辨率、质量档位、背景和输出格式。
    所有参数在付费请求前按清单校验，不支持时报错并列出可用取值。
• 新增模型：az-gpt-image-2、az-gpt-image-2.5-flare、az-gpt-image-2.5-sunburst，Gemini 三个（gemini-3.1-flash-image、gemini-nano-banana-2.1、gemini-3-pro-image），Grok Imagine 四个，doubao-seedream-5-0-pro，Midjourney V8.2 三个。88API 以后上新模型或调整参数，只要文档站更新，插件不用升级。
• 88API-Nano-Banana 停止更新：Gemini 生图并入本插件，解析逻辑来自 Nano（直连 HTTPS、不压缩、128 MB 响应上限、不开流式）。只配过 Nano 的用户，Key 和默认模型会从 ~/.88api/nano-banana.json 自动迁移。
• 新参数：
  • --resolution 1K|2K|4K：替代原来的「4K 模型」。gpt-image-2-4k 已下线，旧命令和旧配置里的 gpt-image-2-4k 自动转成 gpt-image-2 + 4K；旧的 --quality 2K/4K 也按分辨率处理。
  • --quality：现在是模型的质量档位（如 low|medium|high，az-gpt-image-2.5-* 另有 xhigh|max）。
  • --background transparent|opaque|auto、--output-format png|webp|jpeg：只在清单列出的模型上可用（目前是 az-gpt-image-*）。
  • --refresh-models：立即重新拉取模型清单。
  • --image 也可以填公网图片 URL，用于支持 URL 参考图的模型（Grok、Seedream、Gemini、az）。
• --list-models 联网按 Key 标出可用模型：调用免费的 /v1/models，每个清单模型带 available；Key 能用但清单还没收录的生图模型列在 undocumented。点名清单没有、但 Key 能用的模型时，插件只发提示词和参考图试用（不发尺寸、质量等参数）。
• 尺寸预设更新：GPT Image 的像素表改用文档站实测的 1K/2K/4K 预设（例如 2K 16:9 由 2048×1152 改为 2560×1440），比例改为 1:1、3:2、2:3、4:3、3:4、16:9、9:16、21:9、2:1、1:2（去掉 7:4、4:7）。没保存过快速模式的用户，GPT Image 默认分辨率是 1K；要 2K 请传 --resolution 2K 或用 --set-quick-mode --resolution 2K 保存。
• 结果保存：按图片真实格式命名（Grok 1K 和多数 Gemini 结果是 JPEG），能读出 JPEG / WebP 的尺寸；Midjourney 一次返回的 4 张都会保存并列出。本地裁切 / 缩放只对按像素出图的 GPT Image 模型生效。
• 安全：清单只能指向 88api.ai 上固定的几个接口路径，格式不对或被篡改时插件拒用并改用缓存或内置快照；--dry-run 不联网，只用缓存或快照。
• --self-test 更新：覆盖清单里每个模型的请求构造、像素预设校验、恶意清单拦截、参考图上限、Gemini 响应解析和旧配置迁移。

升级后：Codex 新建任务，Claude Code / ZCode 新开对话，以重新加载技能。

88API-image-gen v2.3.0

v2.3.0

不再只限 Codex：同一个插件可以在 Claude Code、ZCode、DeepSeek Harness 以及能运行本机 Node.js 命令的其它 Agent 客户端中使用。

• Claude Code / ZCode 插件：新增 plugins/88api-image-gen/.claude-plugin/plugin.json 和仓库根目录 .claude-plugin/marketplace.json。Claude Code 用 /plugin marketplace add blackdm666/88API-image-gen 安装；ZCode 兼容同一格式，在 设置 → Plugins → Add marketplace 中添加本仓库。
• 技能文件夹自带脚本：generate.mjs 从 plugins/88api-image-gen/scripts/ 移到 plugins/88api-image-gen/skills/88api-image-gen/scripts/。整个技能文件夹可以直接复制到其它客户端的技能目录（如 ~/.agents/skills/、~/.dsh/skills/、~/.cline/skills/）。
• Key 改存客户端通用位置：~/.88api/image-gen.json。旧版保存在 ~/.codex/88api-image-gen-config.json 的 Key 第一次使用时自动复制过来，旧文件保留，并在保存时同步更新，未升级的旧版插件仍可使用。
  • 新增环境变量 API88_KEY：优先于配置文件，不写盘，适合不想把 Key 发进对话的用户。
  • 新增环境变量 API88_CONFIG_DIR：改配置目录（设置后不再读取、同步旧路径）。
  • --get-config 新增「Key来源」「旧版配置同步」两项。
• 提交记录与 --job-status：每次付费运行在 ~/.88api/image-gen-jobs/ 写一份记录，每个请求发出前就先记下。客户端因超时把命令结束后，运行 --job-status <任务号>（不带参数列出最近几次）即可查清每个请求是已保存、未发出、被 88API 拒绝、仍在运行，还是 [NO-AUTO-RETRY] 状态未知 / 被中断（可能已扣费）。该命令不发请求、不收费。
• --json：付费运行结束时多输出一行机器可读结果，结构与 --job-status 相同。
• 技能说明：去掉 Codex 专属表述；新增「长任务与客户端命令超时」一节，要求 Claude Code 把付费命令放到后台运行，任何客户端中断后先查 --job-status、不得盲目重发。Codex Auto 模式审批的说明保持不变。
• 修复：Windows + Node 24 下，付费运行结束时进程会因 libuv 断言（UV_HANDLE_CLOSING）崩溃，退出码变成 127，Agent 可能把成功误判为失败。现在改为设置退出码后自然退出。
• --self-test 新增 config-job 用例：旧配置迁移与同步、环境变量 Key、提交记录各状态、进程被中断的识别。

升级后：Codex 新建任务，Claude Code / ZCode 新开对话，以重新加载技能。

升级

更新插件后新建任务，以重新加载技能清单。Claude Code / ZCode 用户见 README 的安装说明。