Pro 许可证
购买套餐、创建密钥,然后安装付费区块。
Pro 区块由一个会校验许可证密钥的 registry 提供。密钥是你 Wobko 账户里的 API key,且该账户需要有生效中的套餐。
1. 购买套餐
在定价页面选择套餐,按提示登录。
2. 创建密钥
登录后打开设置,进入 API keys,创建一个密钥。密钥只在创建时显示一次,请当场复制保存。
3. 把密钥放进环境变量
CLI 从 WOBKO_LICENSE_KEY 读取密钥。
terminal
export WOBKO_LICENSE_KEY="your-key"Windows PowerShell:
text
$env:WOBKO_LICENSE_KEY = "your-key"不要把密钥提交到 git
不要把密钥直接写进 components.json,那个文件里只写变量名。任何拿到密钥的人都可以用你的账户安装 Pro 区块。
4. 添加 Pro registry
在免费 registry 旁边再加一项:
components.json
{
"registries": {
"@wobko": "https://wobko.dev/r/{name}.json",
"@wobko-pro": {
"url": "https://wobko.dev/api/registry/pro/{name}",
"headers": {
"Authorization": "Bearer ${WOBKO_LICENSE_KEY}"
}
}
}
}5. 安装
terminal
npx shadcn@latest add @wobko-pro/pricing-01Pro 区块依赖免费组件。CLI 会从 @wobko 获取这些组件,从 @wobko-pro 获取区块本身,所以两项配置都要保留。
在 CI 中使用
在 CI 平台里把 WOBKO_LICENSE_KEY 添加为机密变量,并提供给运行 shadcn CLI 的那一步。只有任务需要安装区块时才用得到它。普通构建不需要,因为区块已经是你仓库里的源码文件。
错误说明
| 响应 | 含义 | 处理办法 |
|---|---|---|
| 401 | 没有提供密钥,或密钥无效 | 确认运行 CLI 的那个终端里设置了变量,并且密钥没有被删除 |
| 403 | 密钥有效,但所属账户没有生效中的套餐 | 查看账户设置里的账单页面 |
| 404 | 没有叫这个名字的 Pro 条目 | 在目录里核对名称。免费区块从 @wobko 安装 |