# @cat-factory/binary-generators 中文文档

规范地址：https://npmcn.com/package/%40cat-factory/binary-generators/

版本：0\.3\.86
npm 元数据更新时间：2026-11-06T14:01:38.701Z
中文译文更新时间：2026-11-09T06:28:57.634Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40cat-factory/binary-generators
原文对照：https://npmcn.com/package/%40cat-factory/binary-generators/?lang=original
源码仓库：https://github.com/kibertoad/cat-factory

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

- 包体积（解压后）：87.6 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-08-14T14:55:23.065Z
- 最新版本发布：2026-11-06T14:01:38.248Z
- 近 30 天下载量：4798（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：92（近 12 个月 92 个）

## 中文简介

内置基因二进制集成(Nano Banana, Google's Gemini 映像模型)加上作者的接合, 完全通过公用二进制 Generator Registry 接合来定义它自己: 只取决于@ cat-factory/ 内核 + @ cat

## 安装

```sh
npm install @cat-factory/binary-generators
```

也可以使用：`pnpm add @cat-factory/binary-generators`、`yarn add @cat-factory/binary-generators`、`bun add @cat-factory/binary-generators`

## README

# @ cat- factory/ 二进制生成器

这个 **基因二进制结合** 平台舰只,加上缝合 部署写着它的 拥有。 这些是机器供应商APIs a [二进制输出步骤](https://github.com/kibertoad/cat-factory/blob/main/docs/initiatives/binary-output-foundational-storage.md) 呼吁 _生产_ 它的文物, 相对于基础服务 _存储_ 通过.

| 编号 | 它会是什么 | 方式 |
| --- | --- | --- |
| `nano-banana` | 包含可读文本的图像, 以及对话编辑, 最多4K | `image` (单位:千美元)`image/png`, (中文(简体) ), `image/jpeg`(中文(简体) ) |

## 为什么月台会装一个

`defaultBinaryGeneratorRegistry()` 仍然是空的, 和保持它空的推理 持有:没有图像 API 是一个每个组织运行, 并且每个组织都是 made. 变了 是媒体任务类型。 它运载一种生成剂 一种预设和下面的存储器 它的一步没有选择任何东西,所以该平台最明显的能力只能通过一个 配置,它首先写了一个集成、一个OpenAPI文档和一个证书声明.

计量由证书而不是登记册回答。 没有密钥解决代理 并报告为丢失文物的原因 所以 部署时忽略了此软件包不付任何报酬,并在拾取器中看到一行额外.

## 用这个

每个外观都默认其注册到已发送的集,所以不需要什么 `nano-banana`数字 :

```ts
await start({/* … */}) // binaryGeneratorRegistry defaults to binaryGeneratorRegistryWithBuiltins()
```

一个 **已注射** 登记册 REPLACES 默认,而不是与它合并,所以添加一个部署 它本身的整合始于内置:

```ts
import { binaryGeneratorRegistryWithBuiltins } from '@cat-factory/node-server'

const binaryGeneratorRegistry = binaryGeneratorRegistryWithBuiltins()
binaryGeneratorRegistry.registerAll(myIntegrations)
await start({ binaryGeneratorRegistry })
```

这比大门或即时碎裂登记册更重要,因为所运货物 `pl_media` 预设SELECTs `nano-banana` 由 id 表示: 注册人没有拒绝管道运行 入学时`binary_output_generator_invalid`而不是悄悄地贬低自己 丢弃 已运出集成是合法选择; 编辑预设步骤是其中的另一半 .

登记册 **每次部署一次**,在拥有登记册的程序中。 在母舰模式下 母舰:一个节点解决融合问题 `/internal/binary-generators` 咨询否 所以管道建造商的报价和录取决定是一 不管节点建得有多远 都漂了.

打开 **工人** 登记册也在全过程进行 (单位:千美元)`infrastructure/binaryGenerators.ts`就像部署的二进制文物商店一样 并且出于同样的原因:运行时间为每个入站点建造一个容器和二进制输出 步骤的调度简报由持久路径组成,完全没有选择. `createWorker({ overrides: { binaryGeneratorRegistry } })` 代表你登记,所以 使用有文件证明的接缝进行部署不需要知道这些。 是什么让这个容易错过的 即无上体的建筑解决了SHIPPED的设定而不是一无所有,所以一个未注册的 融合没有出现在一个看起来人多的简要说明中.

## 证书

`nano-banana` 认证 `GEMINI_API_KEY`,从 [谷歌AI工作室](https://aistudio.google.com/apikey),作为 `x-goog-api-key` 头曰. 这个 名字是卖家的 所以有代理商想 `google-genai` 查找库中的值 看着.

设为工作空间 **能力证书** (主题 `binary-generator`编号 `nano-banana`键 `GEMINI_API_KEY`)或者在环境中,部署调度从。 这个 价值仅在工作机构上行并注入代理该工作的程序 从未写到退出、 提示或日志 .

执行 **没有** 加上来 `docs/environment-variables.md`: 所记录的每个变量都保留 以 `check-reserved-env-keys.mjs`,这将使这个密钥无法解决.

谷歌项目必须启用计费. 这些模型中没有一个是免费的,所以 未计费密钥获得 `FAILED_PRECONDITION` 第一次通话,代理报称原因 没有产生任何东西.

## 写你自己

`defineBinaryGenerator` 然后从每个外表再出口 这样一个 部署从它已经依赖的软件包中到达它。 运行平台的OWN 进口时的登记规则(定义方案,加 `binaryGeneratorDetailIssues`页:1 端点政策、合同设定规则、媒体类型分类器、吊带检查和 能力值与接受值对等,所以一个定义会失败一个靴子失败一个测试 相反:

```ts
import { defineBinaryGenerator, openApiContract } from '@cat-factory/binary-generators'

export const acmeImages = defineBinaryGenerator({
  id: 'acme-images',
  name: 'Acme Images',
  summary: 'One line the picker and the agent brief show.',
  description: 'What it is good at, what it is NOT for, and its cost profile.',
  modalities: ['image'],
  mediaTypes: ['image/png'],
  capabilities: ['seed', 'exact-size'],
  endpoint: 'https://api.acme.example',
  credentials: [{ key: 'ACME_IMAGE_API_KEY', usage: 'Authorization: Bearer <value>' }],
  contracts: [
    openApiContract({ contractId: 'acme-api', title: 'Acme API', document: ACME_OPENAPI }),
  ],
  guidance: 'Operating notes folded into the agent’s brief verbatim.',
})
```

两条规则连接不能检查您, 两者都固定在这里的测试:

-   **能力是对终点要求的声称.** 仅在登记的情况下宣布一个 合同带有参数,或允许一个步骤,而代理人则持有一个选项 无法发送 . `nano-banana.test.ts` 在文档中列出每个能力的证据.
-   **一个 `accepts` 设定为REFUSAL.** 只有在最后点真正列举其 价值,并把它从合同中读出而不是重述,所以两者不能漂移.

任何不打开选项( “ 善于像素艺术 ” 、 “ 2K 以下便宜” 、 “ 速率限制 ” 5个一秒") 继续传道 `description` 财务报告和审定财务报表 `guidance`,其中一句可以说它的意思.

## 常见问题

### @cat-factory/binary-generators 是什么？

内置基因二进制集成\(Nano Banana, Google's Gemini 映像模型\)加上作者的接合, 完全通过公用二进制 Generator Registry 接合来定义它自己: 只取决于@ cat-factory/ 内核 \+ @ cat

### 如何安装 @cat-factory/binary-generators？

在项目目录运行 npm install @cat-factory/binary-generators，或使用 pnpm add / yarn add / bun add。

### @cat-factory/binary-generators 支持 TypeScript 吗？

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

### @cat-factory/binary-generators 支持 ESM 还是 CommonJS？

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

### @cat-factory/binary-generators 可以商用吗？

@cat-factory/binary-generators 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @cat-factory/binary-generators 的下载量有多少？

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

### @cat-factory/binary-generators 还在维护吗？

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