用途:在 PrimeUI 导出的本地前端项目中构建或编辑整页或单个页面区块,覆盖标准博客、法律、文档、定价、联系等页面类型。
主要能力:PrimeUI 负责候选组件评分、registry 元数据、组件交付、props 校验与外部规划诊断;编码智能体负责任务理解、导出项目检查、本地文件编辑、有序 block 状态与本地验证。支持设计驱动(Figma)、模板驱动和组合驱动三种源模式。
使用方式:先确认导出项目根目录存在 .primeui/project.json;若无,需在确认为空目录或已有 Next.js 项目后运行 npx @primeuicom/cli setup --ai-preset <agent> 完成初始化,并按提示完成邮件命令。随后检查 MCP 健康状态 npx @primeuicom/mcp@latest --health /absolute/project/path。通过 MCP 工具 component_candidates_get 获取候选组件,用 component_props_validate 校验 props,再用 create_component_export、download_component_export 或 copy_registry_component 交付组件,最后编辑本地页面文件并更新有序 blocks 状态。
适用场景:在本地前端项目中按既定主题或标准模板生成页面、基于设计稿还原区块、组合 PrimeUI 组件搭建新页面。
限制:不得直接调用 PrimeUI API,必须经由 MCP 工具;MCP 客户端启动位置错误时需显式传入 projectRoot;本地或 staging Studio 需设置 PRIMEUI_API_BASE_URL。前置条件不满足时应停止规划与编辑。组件检索、props 校验、交付准备与本地文件编辑不会改变 Prime 页面状态。仅在明确同步工作流存在且用户要求时才可调用 sync-back 或页面确认工具。默认不下载 Figma 位图素材,需使用基于 Prime token 的媒体占位符并保留可替换性。浏览器验收前应逐项测试可见控件,仅视觉准确但不可交互的控件视为失败。具体价格、平台支持范围等资料未提供。