UI UX Pro Max（[uupm.cc](uupm.cc)）完整安装教程

UI UX Pro Max 是面向 Claude Code / Cursor / Copilot 等 AI 编程助手的 UI 设计技能包，官网uupm.cc对应项目仓库：nextlevelbuilder/ui-ux-pro-max-skill，提供3 种安装方案，优先推荐 CLI 一键安装。

一、前置环境要求（必须先装好）

1. Node.js ≥ 16.x（运行 CLI 工具）

   node--versionnpm--version

2. Python 3.x（内置设计库检索脚本）

   python3--version

3. Git（克隆源码可选）

4. 已安装对应 AI 助手：Claude Code / Cursor / GitHub Copilot

方案 1：CLI 一键在线安装（官方推荐，最简单）

1. 全局安装 uipro-cli 命令行工具

# 全局安装npminstall-guipro-cli# 国内npm镜像加速（安装慢时用）npminstall-guipro-cli--registry=https://registry.npmmirror.com# 验证是否安装成功uipro--help

2. 进入你的前端项目目录

cd/你的项目文件夹

3. 初始化绑定 AI 助手（官网示例uipro init --ai claude）

# 适配 Claude Code（官网文档示例）uipro init--aiclaude# 其他常用AI助手可选uipro init--aicursor# Cursor编辑器uipro init--aicopilot# GitHub Copilotuipro init--aiall# 全助手兼容模式

执行后自动：

• 下载全套 UI 素材库（57 种 UI 风格、配色、字体、图表模板）

• 在项目生成对应 AI 配置目录（Claude 生成.claude/skills）

• 自动注入设计规范、代码模板、39 套网站 Demo

4. Claude Code 市场直接安装（纯 Claude 用户捷径）

在 Claude Code 对话框内直接执行插件指令，无需 CLI：

/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill /plugin install ui-ux-pro-max@ui-ux-pro-max-skill

方案 2：手动源码克隆安装（离线 / 自定义修改）

适合需要修改源码、离线使用场景

1. 拉取官方仓库

gitclone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.gitcdui-ux-pro-max-skill

2. 本地安装 CLI 工具

npminstall-g./cli

3. 项目内初始化

# 切回你的业务项目cd../你的项目 uipro setup--assistantclaude

4. 手动软链（可选）
   将 skill 目录复制到 AI 助手本地技能文件夹，重启编辑器生效：

# Mac Claude示例路径cp-r../ui-ux-pro-max-skill ~/Library/Application\Support/Claude/skills/ui-ux-pro-max

方案 3：离线安装（无外网环境）

1. 在有网络电脑打包 CLI 离线包

gitclone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.gitcdui-ux-pro-max-skill/clinpmpack

2. 把生成的.tgz文件传到离线机器，全局安装

npminstall-guipro-cli-xxx.tgz--offline

3. 离线初始化项目

cd你的项目 uipro setup--offline--aiclaude

常用管理命令

# 查看工具版本uipro versions# 更新素材库与工具uipro update# 重装修复配置uiproinstall# 卸载uipro uninstall

安装完成验证

1. 重启你的 AI 编辑器（Claude/Cursor）

2. 在对话输入生成 UI 指令测试：

Build a landing page for a pet grooming service. Playful and friendly style, with booking CTA.

工具会自动输出配色、字体、Tailwind 代码、页面结构，即安装成功。

常见报错解决

1. npm 权限报错：Mac/Linux 加sudo，Windows 用管理员终端

2. Node 版本过低：升级 Node.js 到 18+ LTS

3. Python 未识别：Windows 配置 Python 环境变量，Mac 安装 brew python3

4. 素材加载失败：执行uipro update重新拉取设计数据库