@cat-factory/binary-generators

中文文档
0.3.86发布于 2026/11/06TypeScriptES Module构建来源已验证近 30 天下载 4798

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

中文使用文档
文档目录4 节
  1. 为什么月台会装一个
  2. 用这个
  3. 证书
  4. 写你自己

@ cat- factory/ 二进制生成器

这个 基因二进制结合 平台舰只,加上缝合 部署写着它的 拥有。 这些是机器供应商APIs a 二进制输出步骤 呼吁 生产 它的文物, 相对于基础服务 存储 通过.

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

为什么月台会装一个

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

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

用这个

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

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

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

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工作室,作为 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 端点政策、合同设定规则、媒体类型分类器、吊带检查和 能力值与接受值对等,所以一个定义会失败一个靴子失败一个测试 相反:

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 共发布 92 个版本,首次发布于 2026/08/14;过去 12 个月发布了 92 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.3.86latest2026/11/062 天前
0.3.852026/11/045 天前
0.3.842026/11/045 天前
0.3.832026/11/045 天前
0.3.822026/11/045 天前
0.3.812026/11/045 天前

关于 @cat-factory/binary-generators 的常见问题

@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 和提交记录判断。