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 --version
   npm --version
   

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

   python3 --version
   

3. Git（克隆源码可选）

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

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

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

# 全局安装
npm install -g uipro-cli

# 国内npm镜像加速（安装慢时用）
npm install -g uipro-cli --registry=https://registry.npmmirror.com

# 验证是否安装成功
uipro --help

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

cd /你的项目文件夹

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

# 适配 Claude Code（官网文档示例）
uipro init --ai claude

# 其他常用AI助手可选
uipro init --ai cursor    # Cursor编辑器
uipro init --ai copilot   # GitHub Copilot
uipro init --ai all       # 全助手兼容模式

执行后自动：

• 下载全套 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. 拉取官方仓库

git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
cd ui-ux-pro-max-skill

2. 本地安装 CLI 工具

npm install -g ./cli

3. 项目内初始化

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

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

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

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

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

git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
cd ui-ux-pro-max-skill/cli
npm pack

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

npm install -g uipro-cli-xxx.tgz --offline

3. 离线初始化项目

cd 你的项目
uipro setup --offline --ai claude

常用管理命令

# 查看工具版本
uipro versions

# 更新素材库与工具
uipro update

# 重装修复配置
uipro install

# 卸载
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 重新拉取设计数据库