beui-pro

beUI Pro

将客户实时授权的 beUI Pro 目录作为事实来源。在运行时发现当前条目，只安装项目所需的区块，然后组合并调整源代码。

选择访问路径

按照当前的Agent 访问文档了解连接说明。

• MCP： 使用现有的、已通过身份验证的 https://mcp.beui.dev/pro/mcp 连接。支持 OAuth 的客户端会打开 beUI 的授权页面，用户可在该页面输入其许可证密钥。支持自定义标头的客户端也可以使用 bearer 身份验证。可正常工作的 MCP 连接无需在 Agent 的 shell 中单独提供令牌。
• 直接注册表或 shadcn CLI： 按照安装文档操作。此路径要求命令环境中设置 BEUI_PRO_TOKEN，并为带命名空间的 CLI 命令配置私有注册表。

优先使用可用的、已通过身份验证的 MCP 连接。不要仅因为 shell 中没有令牌就改用令牌配置。

保护访问权限

• 仅在直接请求注册表或通过 CLI 安装时要求提供 BEUI_PRO_TOKEN；已通过身份验证的 MCP 调用不需要。
• 切勿打印、粘贴、提交令牌，或将令牌写入源文件。
• 切勿接受用户复制到提示词中的令牌。使用 OAuth 时，用户只能在 beUI 的授权页面输入密钥。
• 如果 MCP 身份验证缺失或已过期，请使用客户端的原生身份验证流程。切勿提取客户端存储的 OAuth 凭据用于 shell 命令。
• 如果使用直接注册表路径且令牌不可用，请要求用户进行配置。不要用近似方案替代用户要求的 Pro 区块。
• 如果无法获取实时目录，切勿将记忆中、文档中或本地推断的 slug 说成当前目录中的条目。
• 收到 401 时，请恢复所选路径的身份验证。将 404 视为过期或不正确的安装 slug，并刷新目录。

仅限直接访问注册表时，检查令牌是否存在，但不要泄露其值：

test -n "$BEUI_PRO_TOKEN" && echo "beUI Pro token is configured"

配置注册表（仅限直接使用 CLI）

安装 MCP 返回的源代码时，跳过私有注册表设置。

编辑前检查项目现有的 components.json。保留其中的别名和设置。确保两个命名空间都存在，因为 Pro 区块可能依赖公开的 beUI 基础组件：

{
  "registries": {
    "@beui": "https://beui.dev/r/{name}.json",
    "@beui-pro": {
      "url": "https://pro.beui.dev/r/{name}.json",
      "headers": {
        "Authorization": "Bearer ${BEUI_PRO_TOKEN}"
      }
    }
  }
}

将这些内容合并到现有文件中，而不是替换整个文件。除非用户明确要求，否则不要创建或修改密钥文件。

工作流

1. 了解项目

在选择区块前阅读现有应用。确定以下内容：

• 框架和包管理器
• 用户要求的页面或版块
• 现有的字体排版、主题令牌、间距和布局外壳
• 已安装的区块
• 必需的状态、数据和交互

优先组合成协调一致的页面，而不是单独选择区块。

2. 获取实时目录

MCP： 在 Pro 连接上使用 list_components 或 search_components。从实时响应中选择准确的 slug。使用客户端当前的工具架构。

直接注册表： 获取经过身份验证的注册表，而不要依赖记忆中的 slug：

curl -fsS \
  -H "Authorization: Bearer ${BEUI_PRO_TOKEN}" \
  https://pro.beui.dev/r/registry.json

只能从 items[].name 中选择。此端点列出当前可安装的全部 Pro 区块和组件。

如果请求需要更广泛的发现，请使用分组索引：

curl -fsS \
  -H "Authorization: Bearer ${BEUI_PRO_TOKEN}" \
  https://pro.beui.dev/r

根据名称和描述匹配用户意图。不要编造或缩短安装 slug。

3. 有选择地挑选

将页面需求映射到最精简且实用的版块组合。典型的落地页可能需要从每个相关类别中各选一个版块：

1. 导航栏
2. 主视觉区
3. 信任背书或社会证明
4. 功能或内容
5. 适用时添加定价
6. CTA
7. 页脚

除非用户明确要求，否则不要安装整个目录。避免组合视觉方向相冲突的区块。保留每个选定区块最鲜明的美学风格，同时统一页面中共用的字体、间距和主题令牌。

Pro MCP 目录通过 /r/registry.json 提供可安装项目。对于完整的独立模板，请遵循模板文档中说明的授权和下载流程；不要捏造 @beui-pro 模板命令。

4. 安装前先检查

MCP： 使用选定的 slug 调用 get_component。检查其完整源文件、目标路径、软件包依赖、目录依赖、props 和具名导出。

直接使用目录： 通过 CLI 检查每个选定项目：

npx shadcn@latest view @beui-pro/<slug>

适当时使用项目的软件包运行器：

pnpm dlx shadcn@latest view @beui-pro/<slug>
bunx --bun shadcn@latest view @beui-pro/<slug>

如果检查返回 404，请重新获取实时目录。如果返回 401，请恢复所选访问方式的身份验证。

5. 安装选定的源代码

MCP： 安装 get_component 返回的完整源代码：

• 将返回的文件映射到项目的路径和别名。所有写入操作都必须在项目内进行。
• 应用更改前先比较现有文件。保留共享辅助程序和本地修改。
• 使用项目的软件包管理器安装缺失的软件包依赖。
• 解决目录依赖：通过 MCP 获取获得许可的 Pro 依赖，并通过其公开的 MCP 或目录获取公开依赖。包含传递依赖。
• 如果源代码或依赖元数据不完整，请先获取缺失数据再继续。不要凭记忆重建所请求的组件。

install 和 requiredRegistries 字段以及 get_install_command 描述的是单独的 shadcn CLI 流程。这些内容并不意味着必须先配置私有目录才能使用返回的源代码。MCP OAuth 不会对单独启动的 shadcn 进程进行身份验证。

直接使用目录： 通过已配置的命名空间安装：

npx shadcn@latest add @beui-pro/<slug>

该目录可以自动安装公开的 @beui 依赖。请保留这些生成的依赖和辅助程序，不要复制或重新构建它们。

6. 组合并调整

使用生成的文件前，请逐一阅读。然后：

• 从已安装的路径导入其具名导出
• 接入实际文案、链接、图片和数据
• 保留无障碍支持和减少动态效果的行为
• 使用现有的语义化主题令牌
• 优先通过 className 和组合方式调整布局
• 只有在产品需求需要时才修改区块内部实现
• 所有操作都必须在用户的项目内进行

如果已安装的区块依赖公开的 beUI 基础动态效果原语，请勿重新创建低级动态效果原语。

7. 验证

运行项目相关的类型检查和 lint 命令。在桌面和移动设备宽度下渲染更改后的路由，检查交互和减少动态效果的行为，并确认没有溢出或水合错误。

报告已安装的 Pro slug，以及调整过的文件。

常见请求

• 对于“构建落地页”，选择完整但克制的版块顺序，安装每个确切的 slug，并将其组合到现有路由中。
• 对于“添加定价版块”，搜索定价条目，检查最接近需求的变体，安装其中一个，并接入实际方案。
• 对于“使用 beUI Pro 组件”，先检查当前 UI，并优先选择相关的 Pro 区块，而非自定义替代方案。
• 对于“展示 Pro 有哪些内容”，使用实时 MCP 或目录，汇总匹配项目，但不要泄露源代码或令牌。