@hanzo/plans

中文文档
1.10.3发布于 2026/11/15Apache-2.0TypeScriptES Module近 30 天下载 7756

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

中文使用文档
文档目录13 节
  1. 安装
  2. 使用量
  3. 应享权利——教条词汇(关键词)
  4. tenant_id ——多租户目录
  5. 数据合同: entitlements → price_ref 许可证 features
  6. 司马
  7. 订阅计划 subscription.json (中文(简体) )
  8. 梯子
  9. 使用等级( usage (中文(简体) )
  10. 套装
  11. 代理运行时间( O) seats.json (中文(简体) )
  12. 捐款
  13. 许可证

plans

@hanzo/计划

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

安装

npm install @hanzo/plans

使用量

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 文件 :

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)按结构排列 限制,而不是作为特性字符串,使引擎的字符串集检查具有意义.
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(中文(简体) )

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-20xworld-pro
team 编号 : enterpriseworld-team

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

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

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

费率
runtime.agentHourUSD0.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 共发布 47 个版本,首次发布于 2026/06/08;过去 12 个月发布了 47 个版本。

版本发布日期距今
1.10.3latest2026/11/152 天前
1.10.22026/11/152 天前
1.10.12026/11/134 天前
1.10.02026/11/107 天前
1.9.12026/11/089 天前
1.9.02026/10/2325 天前

关于 @hanzo/plans 的常见问题

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