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-01

Pro 区块依赖免费组件。CLI 会从 @wobko 获取这些组件,从 @wobko-pro 获取区块本身,所以两项配置都要保留。

在 CI 中使用

在 CI 平台里把 WOBKO_LICENSE_KEY 添加为机密变量,并提供给运行 shadcn CLI 的那一步。只有任务需要安装区块时才用得到它。普通构建不需要,因为区块已经是你仓库里的源码文件。

错误说明

响应含义处理办法
401没有提供密钥,或密钥无效确认运行 CLI 的那个终端里设置了变量,并且密钥没有被删除
403密钥有效,但所属账户没有生效中的套餐查看账户设置里的账单页面
404没有叫这个名字的 Pro 条目在目录里核对名称。免费区块从 @wobko 安装