# @kortix/llm-catalog 中文文档

规范地址：https://npmcn.com/package/%40kortix/llm-catalog/

版本：0\.14\.13
npm 元数据更新时间：2026-11-01T14:43:10.978Z
中文译文更新时间：2026-11-01T17:13:25.048Z
软件包许可：Elastic-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40kortix/llm-catalog
原文对照：https://npmcn.com/package/%40kortix/llm-catalog/?lang=original
项目主页：https://github.com/kortix-ai/suna/tree/dev/packages/llm-catalog
源码仓库：https://github.com/kortix-ai/suna

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

- 包体积（解压后）：10.4 MB，20 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-07T17:16:31.738Z
- 最新版本发布：2026-11-01T14:43:10.682Z
- 已发布版本数：106（近 12 个月 106 个）

## 中文简介

Kortix LLM模型目录—Kortix网关支持的模型以及管理模型集和默认值。生成自models.dev；通过Kortix平台和@kortix/sdk使用。

## 安装

```sh
npm install @kortix/llm-catalog
```

也可以使用：`pnpm add @kortix/llm-catalog`、`yarn add @kortix/llm-catalog`、`bun add @kortix/llm-catalog`

## README

# @kortix / llm-catalog

这个包提供捆绑的提供程序目录（models.dev快照）和共享的目录帮助程序。它不支持Kortix托管模型：API拥有运行时路由、实时服务目录和托管阵容。

## Kortix管理的模型：Platinum Inference

Kortix管理的模型是一个提供商，像任何其他的，白金推理，从Kortix积分支付。白金乐队的阵容是什么 `GET {PLATINUM_INFERENCE_URL}/models`： id，名称，限制，图像输入，推理努力和每1M代币的价格。API在启动时和每5分钟读取一次(`loadManagedLineup` 在 `apps/api/src/llm-gateway/models/managed-models.ts`， `replica/managed-lineup.ts`）. 一个模型白金添加或重新定价达到用户没有更改Kortix。

1.  每个管理模型都有一个上游，白金(`managedCandidates` 在 `apps/api/src/llm-gateway/resolution/descriptors.ts`)，达成协议 `PLATINUM_INFERENCE_API_KEY` （`pt_live_`、范围 `inference`）. 没有钥匙，还是有钥匙 `KORTIX_MANAGED_PROVIDER_ENABLED` 关闭时，未列出、提供或服务任何托管模型。
2.  Platinum拥有上游、订单、故障转移和零数据保留条款。
3.  网关发送 `x-platinum-session` （Kortix会话，否则API密钥，否则用户）。白金钥匙上游提示缓存由它。
4.  铂金公司报告其收费为 `usage.cost` (美元)。网关账单花费x `KORTIX_LLM_MARKUP` (默认 `1.055`）. 所列价格仅适用于没有 `usage.cost`.
5.  `usage_events.metadata.upstreamProvider` 是 `platinum`． 客户端只看到Kortix。
6.  平台默认值为 `LLM_GATEWAY_DEFAULT_MODEL` 当白金服务时，否则第一款白金列表。模型级回退(`LLM_GATEWAY_FALLBACK_POLICIES`， `policy-config.ts`)不变。
7.  每个客户端都在网关提供程序(`kortix/<id>`)。没有客户端持有托管id列表。

存储会话的退役id可能仍然携带(`LEGACY_MANAGED_IDS`， `RETIRED_MANAGED_MODEL_IDS`)留在API中，所以旧的会话移动到它的继任者。

网关将每个溢出响应为HTTP 400 `context_length_exceeded`，包括错误作为第一个 `data:` 流的框架(`packages/llm-gateway/src/http/call-upstream.ts`）. OpenCode将该代码读取为上下文溢出并进行压缩。

## 目录

`CATALOG` 是捆绑的models.dev快照。它生活在 `src/catalog-data.ts`，不是在 `index.ts`因此，打包器为从未读取的消费者丢弃了大约7.6 MB的JSON `CATALOG` 或者 `catalogModelForWireModel`． 运行时目录从配置的models.dev URL中刷新。

## 许可证

弹性- 2.0。

## 常见问题

### @kortix/llm-catalog 是什么？

Kortix LLM模型目录—Kortix网关支持的模型以及管理模型集和默认值。生成自models\.dev；通过Kortix平台和@kortix/sdk使用。

### 如何安装 @kortix/llm-catalog？

在项目目录运行 npm install @kortix/llm-catalog，或使用 pnpm add / yarn add / bun add。

### @kortix/llm-catalog 支持 TypeScript 吗？

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

### @kortix/llm-catalog 支持 ESM 还是 CommonJS？

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

### @kortix/llm-catalog 可以商用吗？

@kortix/llm-catalog 使用 Elastic-2\.0 许可。声明的许可为 Elastic-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @kortix/llm-catalog 还在维护吗？

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