# @ai-agent-forge/plugin-image-generation 中文文档

规范地址：https://npmcn.com/package/%40ai-agent-forge/plugin-image-generation/

版本：0\.88\.28
npm 元数据更新时间：2026-11-02T01:06:14.286Z
中文译文更新时间：2026-11-06T05:47:03.656Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ai-agent-forge/plugin-image-generation
原文对照：https://npmcn.com/package/%40ai-agent-forge/plugin-image-generation/?lang=original
项目主页：https://github.com/agent-forge/agent-forge#readme
源码仓库：https://github.com/agent-forge/agent-forge

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：191 kB，29 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：3 个
- 首次发布：2026-09-29T17:59:12.814Z
- 最新版本发布：2026-11-02T01:06:14.144Z
- 近 30 天下载量：4684（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：52（近 12 个月 52 个）

## 中文简介

代理 Forge 的图像生成能力插件( 图像 生成 / 图像 编辑工具)

## 安装

```sh
npm install @ai-agent-forge/plugin-image-generation
```

也可以使用：`pnpm add @ai-agent-forge/plugin-image-generation`、`yarn add @ai-agent-forge/plugin-image-generation`、`bun add @ai-agent-forge/plugin-image-generation`

## README

# @ agent-forge/ 插件- 图像生成

代理 Forge 的第一当事方图像生成能力插件 。 登记 `image_generate` 财务报告和审定财务报表 `image_edit` 工具(全控制主机)与 主机配置提供者的图像端点( OpenAI 兼容请求形状) 默认情况下, 使用 Grok 想象编辑适配器 :

-   全权证书`apiKey` + 键 `baseUrl`)在运行时通过公众解决 `CredentialAPI` (单位:千美元)`api.credentials.resolve({ providerId })`); 插件保留 没有自己的证书.
-   `provider`编号 :`model`编号 :`baseUrl` 来自所选会话 `generate_image` 目标(`/model` ; 调用不能覆盖它们。 第一个 适配器是 `openai-images`。 。 。 .
-   `capabilityConfig.generate_image.options` 可能提供默认 `size`, (中文(简体) ), `quality` 财务报告和审定财务报表 `n`; 明确的工具参数胜出.
-   没有能力选择服务的主机又回到了遗产 能力槽链(设置插槽、掩体、提供者推论)。 使用新主机 仅选择会话.
-   生成和编辑的图像文件被写入工作空间 `generated-images/` 目录,按其实际格式命名和输入 (魔法字节嗅觉:png/jpg/webp/gif;未知倒回png);工具 结果只返回工作空间相对路径( 见“ 图像从不骑行 ” —— 模型读取一个返回的文件来查看.
-   取消级联通过 `api.sessionAbortSignal()` 和援引 信号; 180s后请求超时, 错误消息从不响应 API 键或请求头.
-   来自图像 API 的 401/403 报告为 `credentials_insufficient` (无) `image_request_failed`: 信件名称为被拒绝的密钥和点 特定供应商的 `auth.json` 输入。 单一的网关密钥往往有 文本能力但无图像能力, 因此注册专用图像密钥 用于图像提供者,而不是重用主提供者.
-   图像编辑使用提供者的 `/images/edits` 终点 插件选择 模式ID中的请求协议 : `grok-imagine-image` 财务报告和审定财务报表 `grok-imagine-image-*` 使用 Grok JSON 数据- URL 形状; 其他模型使用 OpenAI多块. 提供方证书和端点配置保持不变 提供主机 .

## 配置图像提供者

将模型注册到 `models.json`中选择 `/model` →(或设置) `settings.defaultCapabilities.generate_image`) (中文(简体) ). 这个 `settings.json` 下面是 仅由没有能力选择服务的主机使用 :

```json
{
  "capabilities": {
    "imageGeneration": { "provider": "myimg", "model": "gpt-image-1" }
  }
}
```

`models.json` 登记提供者及其图像模型(`capabilities` 标记图像能力模型; 适配器选择图像协议 :

```json
{
  "providers": {
    "myimg": {
      "baseUrl": "https://img.example.com/v1",
      "api": "openai-completions",
      "models": [
        {
          "id": "gpt-image-1",
          "capabilities": ["generate_image"],
          "capabilityConfig": { "generate_image": { "adapter": "openai-images" } }
        }
      ]
    }
  }
}
```

图像生成只消耗 `baseUrl`、供应商证书,以及 模式 `id`; 聊天模式字段, 如 `contextWindow`编号 :`maxTokens` 不影响 图像请求并可以省略(仅声明它们更改 `--list-models` 显示).

用 `/login` (存储于 `auth.json`(三); `models.json` 拒绝 `apiKey` 字段装入。 插件解决密钥和 `baseUrl` 通过主机的证书 API:存储的密钥生活在 `auth.json`,以及 `models.json` 不是一个关键来源 `--api-key`/运行时间注入和 供应商注册的密钥也解决了.

只有一个 `models.json` 登记(无) `capabilities` 设置) 插件自动使用单个已注册图像提供者(引用层 4/ 5). 正在注册图像模型 `models.json` 意味着供应商真的有 a 一个 `/images/generations` 结束点; 聊天模式从未参与 在推论中。 槽通过主机运行到插件 装配时间 `configOverride` 注射(`api.config.imageGeneration` + 键 `api.config.imageModelCatalog` 快照)——插件从未读取主机 设置文件本身.

## 代理支持

每个外出请求(API呼叫和提供者-CDN图像下载)都尊重 标准代理环境变量 - `HTTPS_PROXY`, (中文(简体) ), `HTTP_PROXY`, (中文(简体) ), `NO_PROXY` (这两种情况都有效,与卷轴/起伏/npm相同) `EnvHttpProxyAgent`,每个请求注入。 节点的 `fetch` 忽略这些 默认变量,所以如果您的机器只通过一个 VPN/代理客户端,在运行主机之前导出其本地的 HTTP 端口,例如:

```
export HTTPS_PROXY=http://127.0.0.1:7897
export NO_PROXY=api.shenwenai.com   # optional: keep the gateway direct
```

OS级代理设置( MacOS 网络设置, Windows 注册) 不是 读; 手动导出端口。 全球调度员从未被替换——只有 此插件的请求受到影响 .

注释:

-   `HTTP(S)_PROXY` 必须指向 **网页** 代理( 多数 VPN 客户端曝光 a) 混合 http/socks 端口;使用带有 `http://` URL) (中文(简体) ). `socks5://` URL以明显的错误被拒绝——undici只说出http代理.
-   `ALL_PROXY` 未读( 不可分割的限制); 设置 `HTTP_PROXY`编号 :`HTTPS_PROXY`。 。 。 .
-   主机本身已经为模型流量遵守这些变量 它自己的全球调度器( http- despatcher ) `EnvHttpProxyAgent`);这个 插件的包装器存在, 因此图像流量也会在不运行的主机中工作 安装全局调度器( 内嵌主机), 并拒绝袜子 URL 带一个可操作的信息.
-   重签名 TLS 所需的企业代理 `NODE_EXTRA_CA_CERTS` 与 代理的根证书 .

## 图像从不载客(按需阅读)

图像有效载荷是 **从未内含** 他们将会是 以后每转一次都重新接受模型. 工具结果包含结论 仅限: `{files, model, usage}` 加上一个说明 告诉模型阅读文件. 当模型实际需要考察其生产(如修改)时, 它读取文件——主机 `read` 工具将图像作为附件和 自动调整大小,比携带生的更便宜,更精确 历史上的载荷. 让你的谈话模型看到图像,宣布 `"capabilities": ["text", "visual_image"]` 在供货商那里 `models.json` 条目(主机将图像部分降为仅限文本的模型,并带有可读注释).

## 常见问题

### @ai-agent-forge/plugin-image-generation 是什么？

代理 Forge 的图像生成能力插件\( 图像 生成 / 图像 编辑工具\)

### 如何安装 @ai-agent-forge/plugin-image-generation？

在项目目录运行 npm install @ai-agent-forge/plugin-image-generation，或使用 pnpm add / yarn add / bun add。

### @ai-agent-forge/plugin-image-generation 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @ai-agent-forge/plugin-image-generation 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @ai-agent-forge/plugin-image-generation 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ai-agent-forge/plugin-image-generation 可以商用吗？

@ai-agent-forge/plugin-image-generation 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-agent-forge/plugin-image-generation 的下载量有多少？

根据 npm 官方下载统计，@ai-agent-forge/plugin-image-generation 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,684 次，日均约 156 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ai-agent-forge/plugin-image-generation 还在维护吗？

最新版本 0\.88\.28 发布于 2026/11/02（4 天前）；至今共发布 52 个版本，其中过去 12 个月发布了 52 个；首次发布于 2026/09/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。