# @copilotkit/license-verifier 中文文档

规范地址：https://npmcn.com/package/%40copilotkit/license-verifier/

版本：0\.5\.0
npm 元数据更新时间：2026-06-18T21:23:59.682Z
中文译文更新时间：2026-11-10T18:19:27.125Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40copilotkit/license-verifier
原文对照：https://npmcn.com/package/%40copilotkit/license-verifier/?lang=original
项目主页：https://copilotkit.ai/
源码仓库：https://github.com/CopilotKit/CopilotKit

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

- 包体积（解压后）：326 kB，7 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-03-26T22:56:08.443Z
- 最新版本发布：2026-06-18T21:23:59.580Z
- 近 30 天下载量：2359124（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

副驾驶 Kit 许可证核查

## 安装

```sh
npm install @copilotkit/license-verifier
```

也可以使用：`pnpm add @copilotkit/license-verifier`、`yarn add @copilotkit/license-verifier`、`bun add @copilotkit/license-verifier`

## README

# @ copilotkit/ 许可证审核器

用于离线的 CopilotKit 许可证验证的公开运行时间包.

## 公共 API

软件包输出一个根切入点 :

```ts
import {
  LICENSED_FEATURES,
  addRuntimeKeyAttestation,
  clearRuntimeKeys,
  createLicenseChecker,
  getFeatureDisplayName,
  getFeatureLimit,
  getMasterPublicKey,
  getPublicKey,
  isComponentFeature,
  isFeatureEnabled,
  isRuntimeFeature,
  organizationEntitlementSchema,
  parseOrganizationEntitlement,
  verifyKeyAttestation,
  verifyLicense,
  type EntitlementReader,
  type KeyAttestationData,
  type LicenseChecker,
  type LicenseFeatures,
  type LicenseOwner,
  type LicensePayload,
  type LicenseStatus,
  type LicenseTier,
  type OrganizationEntitlement,
} from "@copilotkit/license-verifier";
```

`verifyLicense(token)` 剖析所签名的有效载荷,核实Ed25519签名,检查过期,并返回 a `LicenseStatus`. 已签名的有效载荷可能包含额外的特性密钥,因此较老的核查者仍然可以从结构上解析出较新的符号;帮助者读取的默认情况下仍然否定这些未知密钥.

特征读取为目录化. `isFeatureEnabled(license, feature)` 返回时 `true` 仅在 `feature` 是一个已知的布尔特性 `LICENSED_FEATURES` 并且所签名的有效载荷值是准确的 `true`。 。 。 . `getFeatureLimit(license, feature)` 仅在 `feature` 是一个已知的数字特征,所签的有效载荷值是一个非负整数。 未知的特性密钥和数值类型的不匹配默认否认 .

`LICENSED_FEATURES` 从内部再出口 `@cpki/license-catalog` 构建时使用的投影。 核查者不应另行界定 特性目录.

`createLicenseChecker(token?)` 核实一次,缓存所签的有效载荷,并重新评估每个有效载荷过期 `getStatus()` 电话. `checkFeature(feature)` 使用与目录中的布尔特征行为相同的 `isFeatureEnabled`。 。 。 .

### 组织产权合并

`createLicenseChecker(token?)` 返回 a `LicenseChecker` 谁 `withOrganizationEntitlement(org)` 生成一个 **非模拟** `EntitlementReader` 合并解析 `OrganizationEntitlement` 与部署基地相重叠:

-   `reader.checkFeature(feature)` -布尔 **或**: 如果部署 ( grace- 尊重; 过期但 grace 毫无贡献 ) 或 活动 Org 给它。 非活动 org 或 活动 org 中空 `features` 地图, 贡献什么.
-   `reader.getFeatureLimit(feature)` 数字 **最热门的**数字 : `0` 表示 无限且胜过任何有限度的价值; 否则更大的现值 胜负; `null` 只有在双方都不在场时.

读取器是新鲜的每个呼叫, 从来没有变异 基础有效载荷 在检查器上覆盖状态,所以一个长寿的多租户进程可以称之为 每一份申请都有不同的类别,不泄露应享待遇。 读者 故意不暴露 `getStatus()` - 使用基座 `checker.getStatus()` 用于部署诊断。 种子 `withOrganizationEntitlement` a 一个 已经..`parseOrganizationEntitlement`'d' 值; 覆盖值为目录 和基数一样,所以未知的id和等值的不匹配被忽略了.

## 在线密钥验证

该软件包不导出网络客户端进行在线验证. 从在线端点取签名密钥的主机应该验证此包以外的响应, 然后调用 `addRuntimeKeyAttestation({ keyId, publicKey, attestationSig })`。证明书签名必须结束 `keyId:publicKey` 并由主密钥签署后被烤入包.

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40copilotkit/license-verifier/LICENSE)。 。 。 .

## 常见问题

### @copilotkit/license-verifier 是什么？

副驾驶 Kit 许可证核查

### 如何安装 @copilotkit/license-verifier？

在项目目录运行 npm install @copilotkit/license-verifier，或使用 pnpm add / yarn add / bun add。

### @copilotkit/license-verifier 支持 TypeScript 吗？

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

### @copilotkit/license-verifier 支持 ESM 还是 CommonJS？

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

### @copilotkit/license-verifier 可以商用吗？

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

### @copilotkit/license-verifier 的下载量有多少？

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

### @copilotkit/license-verifier 还在维护吗？

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