@adaline/gateway

中文文档
1.15.0发布于 2026/04/23MITTypeScriptESM + CJS近 30 天下载 13.7万

Adaline 网关

中文使用文档
文档目录10 节
  1. 特征
  2. 快速启动
  3. 安装软件包
  4. 创建网关对象
  5. 创建提供者对象
  6. 创建示范对象
  7. 创建配置对象
  8. 创建信件对象
  9. 使用网关流式聊天
  10. 使用 Gateway 完成聊天

Adaline 网关

npm bundle size npm type definitions ESLint NPM NPM version

唯一一个完全本地生产级的Super SDK为调用超过200+LLMS提供简单,统一和强大的接口.

  • 生产准备并被企业使用.
  • 完全当地和 没有 一个代理。 你可以部署在任何地方.
  • 配有分批,回试,缓存,回调,和OpenTeleometry支持.
  • 支持用于缓存,日志,HTTP客户端的自定义插件等. 你可以像LEGO一样使用它,并让它与你的基础设施相配合.
  • 支持插件和游戏提供者. 您可以运行完全自定义的提供者, 并仍然利用 Adaline Gateway 的所有好处 .

特征

  • QQ 在类型脚本中严格输入
  • Isomorphic - 到处工作
  • 100%的本地和私营 没有 代理服务器
  • QQ 工具调用所有兼容的 LLMS 支持
  • QQ 用自定义队列支持处理所有请求
  • QQ 自动重试, 有指数回放
  • QQ 有自定义缓存插件支持的缓存
  • QQ 完整定制仪器和钩子的回调
  • QQ OpenTeleometry 将追踪插入您的现有基础设施
  • 本地和自定义模型的插件和游戏自定义提供者

快速启动

安装软件包

npm install @adaline/gateway @adaline/types @adaline/openai @adaline/anthropic 

创建网关对象

网关对象维护队列,缓存,回调,执行OpenTeleometry等等. 你应该在任何地方使用同一个Gateway对象来获得所有特性的好处.

import { Gateway } from "@adaline/gateway";

const gateway = new Gateway();

创建提供者对象

提供方对象存储该提供者内部所有模型的种类/信息. 它暴露了所有聊天的列表 openai.chatModelLiterals() 并嵌入 openai.embeddingModelLiterals() 模特们.

import { Anthropic } from "@adaline/anthropic";
import { OpenAI } from "@adaline/openai";

const openai = new OpenAI();
const anthropic = new Anthropic();

创建示范对象

模型对象从角色,到配置,到该模型所支持的不同模式,都强制实施类型. 您也可以提供其他密钥,如 baseUrl, (中文(简体) ), organization等 (中文(简体) ).

模型对象也会暴露功能:

  • transformModelRequest 它需要为提供者格式化的请求并将其转换为Adaline超型.
  • getStreamChatData 然后用来制作其他提供者的电话。 例如,从贝德罗克调用Anthropic模型.
  • 以及更多可以进行深度堆肥 并提供运行时间验证.
const gpt4o = openai.chatModel({
  modelName: "gpt-4o",
  apiKey: "your-api-key",
});

const haiku = anthropic.chatModel({
  modelName: "claude-3-haiku-20240307",
  apiKey: "your-api-key",
});

创建配置对象

Cfig对象提供类型检查,并接受可用于每个模型添加最大值,分数等验证检查的通用.

import { Config } from "@adaline/types";

const config = Config().parse({
  maxTokens: 200,
  temperature: 0.9,
});

创建信件对象

Message对象是Adaline超型,支持200+LLMs的所有角色和模式.

import { MessageType } from "@adaline/types";

const messages: MessageType[] = [
  {
    role: "system",
    content: [{
      modality: "text",
      value: "You are a helpful assistant. You are extremely concise.
    }],
  },
  {
    role: "user",
    content: [{
      modality: "text",
      value: `What is ${Math.floor(Math.random() * 100) + 1} + ${Math.floor(Math.random() * 100) + 1}?`,
    }],
  },
];

使用网关流式聊天

await gateway.streamChat({
  model: gpt4o,
  config: config,
  messages: messages,
});

使用 Gateway 完成聊天

await gateway.completeChat({
  model: haiku,
  config: config,
  messages: messages,
});

版本与发布记录

@adaline/gateway 共发布 54 个版本,首次发布于 2024/09/03;过去 12 个月发布了 8 个版本。

版本发布日期距今
1.15.0latest2026/04/236 个月前
1.14.12026/04/106 个月前
1.14.02026/04/066 个月前
1.13.12026/03/038 个月前
1.13.02026/02/078 个月前
1.12.02026/01/159 个月前

关于 @adaline/gateway 的常见问题

@adaline/gateway 是什么?

Adaline 网关

如何安装 @adaline/gateway?

在项目目录运行 npm install @adaline/gateway,或使用 pnpm add / yarn add / bun add。

@adaline/gateway 支持 TypeScript 吗?

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

@adaline/gateway 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@adaline/gateway 需要什么版本的 Node.js?

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

@adaline/gateway 可以商用吗?

@adaline/gateway 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@adaline/gateway 的下载量有多少?

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

@adaline/gateway 还在维护吗?

最新版本 1.15.0 发布于 2026/04/23(6 个月前);至今共发布 54 个版本,其中过去 12 个月发布了 8 个;首次发布于 2024/09/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。