# @hanzo/plans 中文文档

规范地址：https://npmcn.com/package/%40hanzo/plans/

版本：1\.10\.3
npm 元数据更新时间：2026-11-15T02:32:34.814Z
中文译文更新时间：2026-11-17T08:28:17.412Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40hanzo/plans
原文对照：https://npmcn.com/package/%40hanzo/plans/?lang=original
项目主页：https://github.com/hanzoai/plans#readme
源码仓库：https://github.com/hanzoai/plans

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

- 包体积（解压后）：152 kB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react \>=19
- 首次发布：2026-06-07T22:21:54.973Z
- 最新版本发布：2026-11-15T02:32:34.600Z
- 近 30 天下载量：7756（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：47（近 12 个月 47 个）

## 中文简介

Canonical Hanzo计划和定价定义——单一的真相来源

## 安装

```sh
npm install @hanzo/plans
```

也可以使用：`pnpm add @hanzo/plans`、`yarn add @hanzo/plans`、`bun add @hanzo/plans`

## README

![plans](https://npmcn.com/package/%40hanzo/plans/.github/hero.svg)

# @hanzo/计划

Canonical Plan + 为汉藏平台定价定义. 单一的真相来源,被每个产品表面所消耗,使价格标签或大门成为特征.

## 安装

```sh
npm install @hanzo/plans
```

## 使用量

```js
import {
  subscriptionPlans, // free / go / pro-3x / dev-5x / max-15x / ultra / ultimate / unlimited / team / enterprise
  dnsPlans,          // dns-free / dns-pro / dns-enterprise
  cloudPlans,        // starter / builder / dev / pro / turbo / ...
  blockchainPlans,
  gpuTiers,
  regions,
  seats,
  storage,
  tools,
  pricingPolicy,
} from '@hanzo/plans'

console.log(subscriptionPlans.find((p) => p.id === 'max-15x'))
// → { id: 'max-15x', replaces: ['max-10x'], name: 'Max', priceMonthly: 95, priceAnnual: null, ... }
```

或导入一个 JSON 文件 :

```js
import subscription from '@hanzo/plans/subscription.json'
import dns from '@hanzo/plans/dns.json'
```

## 应享权利——教条词汇(关键词)

曾三次界定的权利:计划 `features` 显示字符串, 计划 `limits` 是临时的机器钥匙,商业复制,和许可证 引擎需要自己的机器钥匙 此软件包现在定义了 **一个** 机器可读的权利词汇,在这里,一次.

-   **`entitlements.schema.json`** ——JSON-Schema(2020-12草案)名称空格 词汇。 每把钥匙都是 `namespace.key` 具有固定类型+ `x-unit`横跨 9个命名空间 : `ai.*`, (中文(简体) ), `cloud.*`, (中文(简体) ), `licensing.*`, (中文(简体) ), `world.*`, (中文(简体) ), `dns.*`, (中文(简体) ), `rpc.*`, (中文(简体) ), `data.*`, (中文(简体) ), `tools.*`, (中文(简体) ), `commerce.*`。标题键 : `ai.models`, (中文(简体) ), `ai.agents`, (中文(简体) ), `cloud.max_vms`, (中文(简体) ), `cloud.gpu_class`, (中文(简体) ), `licensing.app_ids`, (中文(简体) ), `licensing.seats`数字 `-1` 表示 **无限制**· ; `null` 表示未设置/继承.
-   **`plan.schema.json`** 计划信封 添加数 **`tenant_id`** (因此,每个 reseller/org 有自己的目录,类型为 **`entitlements`** 块和 **`price_ref`** 块。 显示 `features` 遗产 `limits` 仍然是可选的.
-   **`entitlements.mjs`** ——运行时间助手(`ENTITLEMENT_KEYS`, (中文(简体) ), `fromLegacy`, (中文(简体) ), `toPriceRefStub`, (中文(简体) ), `toLicenseFeatures`, (中文(简体) ), `resolvePlan`) (中文(简体) ).

### `tenant_id` ——多租户目录

计划编号是 **不再具有全球独特性**组合键 `(tenant_id, id)`。 。 。 . `tenant_id` 默认为 `"hanzo"` (第一党目录) 在省略时,所以所有现有的记录都仍然有效。 一个转卖船 自己的计划 其下行数 `tenant_id` 不相冲突 `hanzo`是因为 `pro`编号 :`max`(原始内容存档于2012-10-12). etc.

### 数据合同: `entitlements` → `price_ref` 许可证 `features`

```
plan.entitlements          (machine keys; the source of truth)
   │  fromLegacy(plan)      ← derives entitlements from legacy limits/addons/payouts
   ▼
price_ref                  (pricing.hanzo.ai)
   ├─ recurring             flat subscription line (monthly/annual, per_seat)
   └─ metered[]             usage meters: { entitlement, unit, source, included }
                            resolved live vs OpenRouter / HF / Zen gateway / DO
   │  toLicenseFeatures(entitlements)
   ▼
license token `features`   (hanzoai/licensing → the proprietary engine)
                            flat []string the engine's release gate matches
                            (releases.go hasFeatures): "inference", "training",
                            "ai.premium", "licensing.app:hanzo",
                            "licensing.product:engine", "deploy.on_prem", …
```

-   **商业** 读取 `entitlements` 以显示其 `Entitlement` (成员:特别安全组织、, 产品代号,座位),而不是从显示字符串中重新找到.
-   **许可证发放** 副本 `licensing.engine_features` 加上衍生能力 符号输入已签名的符号 `features`;引擎验证它们离线.
-   数量配额(座椅/座椅、VMs)按结构排列 限制,而不是作为特性字符串,使引擎的字符串集检查具有意义.

```js
import { resolvePlan, ENTITLEMENT_KEYS, fromLegacy, toLicenseFeatures } from '@hanzo/plans'

const max = subscriptionPlans.find((p) => p.id === 'max-5x')
resolvePlan(max)
// → { tenant_id: 'hanzo', id: 'max-5x', entitlements: {...}, price_ref: {...},
//     license_features: ['ai.premium','training','licensing.app:hanzo', ...] }
```

## 司马

### 订阅计划`subscription.json`(中文(简体) )

```ts
type Plan = {
  tenant_id?: string          // owning reseller/org; defaults to 'hanzo'.
                              // unique key is (tenant_id, id)
  id: string                  // 'pro', 'world-pro', 'team-max', ... (unique per tenant)
  name: string
  description: string
  priceMonthly: number | null // legacy convenience price; authoritative is price_ref
  priceAnnual: number | null  // USD per month billed annually
  category: 'personal' | 'team' | 'enterprise' | 'world'
  group?: string              // the team a per-seat plan is a seat type of ('team');
                              // one subscription holds seats of every plan in it, and
                              // minSeats / maxMembers count them together
  popular?: boolean
  contactSales?: boolean
  features: string[]          // DISPLAY strings — do not gate on these
  usage?:                     // DISPLAY usage tier, on every listed personal paid rung only
    | { multiple: number; session: number; day: number; premiumCents: number; oursCents: number }
    | { multiple: null; unlimited: true }
  limits?: {                  // DEPRECATED: back-compat source for `entitlements`
    agents?: number
    bots?: number
    teamGuests?: number
    minSeats?: number
    freeCredit?: number
    maxMembers?: number
    maxAlerts?: number
    apiRateLimit?: number
    mcpRateLimit?: number
  }
  entitlements?: Entitlements // CANONICAL machine truth (see entitlements.schema.json)
  price_ref?: PriceRef        // billing binding: { currency, recurring, metered[] }
  bundles?: string[]    // slugs of plans this plan also grants free
  includedIn?: string[] // slugs of parent plans that bundle this one
  payouts?: { idleResalePercent: number; description: string }
}
```

### 梯子

| 编号 | 名称 | 月份 | 年份 | 包括大赦国际 |
| --- | --- | --- | --- | --- |
| `free` | 免费 | 0美元 (单位:美元) | —— 说 | Enso 自动, 每天50个免费请求 |
| `go` | 走开 | 8块 | —— 说 | 每个模型的用法 |
| `pro-3x` | 赞成 | 15块 | —— 说 | 3x Go's (英语) |
| `dev-5x` | 德维 | 45美元 | —— 说 | 5个 |
| `max-15x` | 马克斯 | 95美元 (单位:千美元) | —— 说 | 15个 |
| `ultra` | 超强 | 195美元 (中文(简体) ) | —— 说 | 25辆GO |
| `ultimate` | 终极 | 495美元 (中文(简体) ) | —— 说 | 50块 |
| `unlimited` | 无限制 | 995美元 (单位:千美元) | —— 说 | 无盖 |
| `team` | 团队(标准席位) | 25美元/成员 | 240美元/成员 | 专业习惯,每个成员 |
| `team-premium` | 团队保有量(保有量座位) | 100美元/成员 | 960美元/成员 | 5x一个标准席位,每个成员 |
| `advisory` | 咨询(机构) | 4 999美元 (4 999美元) | —— 说 | 10个专业 |
| `dedicated` | 专门小组(机构) | 9 999美元 (9 999美元) | —— 说 | 10个专业 |
| `enterprise` | 企业 | 引用 | 引用 | 合同 |

### 使用等级(`usage`(中文(简体) )

计划使用背后的数字——每个示范班级,每个课会和一天,每个班会 模式——是云的用法政策`hanzo-inc/cloud` `apps/flags` 计划种子和 `apps/allowance`),由超级Admin设定于admin.hanzo.ai,由客户阅读于: `/v1/ai/limits`在那里执行。 上面的每个个人付费笔会重复 在顶层显示 `usage` 块,因此一个UI可以使分级顺序: Go's base (50个请求为5小时会话,每天150个,每个模范班500分) 倍数为多。 无限制状态没有数字.

| 编号 | `usage` |
| --- | --- |
| `go` | `{"multiple": 1, "session": 50, "day": 150, "premiumCents": 500, "oursCents": 500}` |
| `pro-3x` | `{"multiple": 3, "session": 150, "day": 450, "premiumCents": 1500, "oursCents": 1500}` |
| `dev-5x` | `{"multiple": 5, "session": 250, "day": 750, "premiumCents": 2500, "oursCents": 2500}` |
| `max-15x` | `{"multiple": 15, "session": 750, "day": 2250, "premiumCents": 7500, "oursCents": 7500}` |
| `ultra` | `{"multiple": 25, "session": 1250, "day": 3750, "premiumCents": 12500, "oursCents": 12500}` |
| `ultimate` | `{"multiple": 50, "session": 2500, "day": 7500, "premiumCents": 25000, "oursCents": 25000}` |
| `unlimited` | `{"multiple": null, "unlimited": true}` |

没有读 `usage` 到闸门或帐单:云政策是用户得到的. 在记录中,没有其他地方表明一个数字——没有 `requestsPer*`编号 :`tokensPerMinute` 限制和无 `ai.*` 津贴权利——和 `test/usage.test.mjs` 计划失败 也就是说 `usage` 或不同意 rung的拷贝。 拷贝名字是两个数字 简言之,从政策上说: 暴走的一倍,在它的用法和它的 5小时和每天的窗户("25x比去多"),一个溢价的球队座位是5x a 标准座椅,和Free的50个免费要求一天. 阶梯线上的其他数字都是价格、座位范围或容量 计划本身的田地状态; `test/copy.test.mjs` 将每个人扣在源头,拒绝 a 使用美元数额、代号、销售商名称或内部单词。 一阵子 只能用云层数字进行销售.

在计划包括的过去,持单人继续使用他们购买的预付信贷; 没有薄荷糖的信用。 个人阶梯只售出一个月;标准 团队席位的年份是240美元,每个成员每月20美元,一个溢价席位是960美元,80美元 a 一个月.

一个团队混合座位类型 : `team` 财务报告和审定财务报表 `team-premium` 命名组 `team`,所以一个 订阅会保留标准席位和保费席位,球队被计算在内 从两个成员(每个成员一个是团队;一个不是团队)到 一百个.

代理员工是Hanzo.Index的,通过付薪卡出售. hanzo.ai:类 `agency` 让他们远离应用的梯子和org门, 他们每月开账单没有 年度价格(顾问的最低季度是合同期,而不是外地),以及 他们携带10x Pro的AI用法(云的代理行),因为预聘者支付人.

专业是 `pro-3x` 因为 `pro` 命名一个计算大小 `plans.json`。 。 。 . `pro-3x` 声明 `"replaces": ["pro-2x"]` 财务报告和审定财务报表 `max-15x` `"replaces": ["max-10x"]`: 每一个 解析存储 id 的读取器(`findPlan`,goja路线,商业,云 使用政策)将旧弹壳的持有者作为重新命名的rung 认购价格不变 企业已退休(`dev`, (中文(简体) ), `max-5x`, (中文(简体) ), `max-20x`, (中文(简体) ), `max-50x`留在目录中与 `"status": "archived"`这样 他们的财产; `max` (99美元)仍然答复如下: `max-5x`。 。 。 . 活动以外的状态会保留一个计划, 然后退出 (单位:千美元)`listedPlans`) (中文(简体) ). 没有计划 `"private"` 今天: 无限制的被列出并像每个 其他杂碎. `ultimate` 是一个新的 rung , 并取代什么, 所以 `max-50x` 保留存档 和解决自己.

### 套装

多个"汉藏"平台级可免费进入"汉藏"世界级,无需二次收费:

| 平台计划 | 套装 |
| --- | --- |
| `max-5x` 编号 : `max-20x` | `world-pro` |
| `team` 编号 : `enterprise` | `world-team` |

根据父母计划创建的订阅,应当对每个输入的零价儿童订阅 `bundles`半藏商业公司自动这样做 `CreateBillingSubscription` 处理者.

### 代理运行时间( O)`seats.json`(中文(简体) )

代理计算按小时计费,而不是按座位计费:

|  | 费率 |
| --- | --- |
| `runtime.agentHourUSD` | 0.08美元/小时 |

一个速率覆盖所有代理运行时间——代理编码,聊天推论会话,和一个bot运行的居民. 时间在订阅之外.

一级包含的是 **能力**,分级: `limits.agents` 财务报告和审定财务报表 `limits.bots` (赞美语) `ai.agents` 编号 : `ai.bots`) (中文(简体) ). 自由可能运行一个代理, `dev` 10,每个最大rung 10加上它自己的bots(1,3,5和10上rungs), `enterprise` 无限( e)`-1`) (中文(简体) ). 这些上限可能存在多少个;它们不是工作时间的允许,因此消费者既需要一半的时间,也不得将两者相读.

`0` 表示分级可能不会运行任何此类,并且是一个真实的,可执行的答案;缺失的密钥意味着还没有人说过,并且不能被读作零.

## 捐款

`hanzoai/plans` 是唯一的峡谷来源。 每个消费者(商业,定价,控制台,云,hanzo.ai营销)都会读到这个套件——从来没有自己的拷贝. 通过 npm 发布 + 下游图像重建 .

## 许可证

Apache 2.0 — 见 `LICENSE`。数据本身是客户化定价;许可证涵盖JavaScript绑定.

## 常见问题

### @hanzo/plans 是什么？

Canonical Hanzo计划和定价定义——单一的真相来源

### 如何安装 @hanzo/plans？

在项目目录运行 npm install @hanzo/plans，或使用 pnpm add / yarn add / bun add。

### @hanzo/plans 支持 TypeScript 吗？

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

### @hanzo/plans 支持 ESM 还是 CommonJS？

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

### @hanzo/plans 可以商用吗？

@hanzo/plans 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @hanzo/plans 的下载量有多少？

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

### @hanzo/plans 还在维护吗？

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

