refactor: 架构升级

.agents/bak-skills/uniapp-project-creator/examples/guide/installation.md

@@ -0,0 +1,119 @@
+# uni-app 安装指南
+
+## 官方文档
+
+参考官方文档：https://uniapp.dcloud.net.cn/quickstart-cli.html
+
+## 安装方式
+
+### 方式一：使用 HBuilderX（推荐新手）
+
+HBuilderX 是 DCloud 官方提供的 IDE，内置 uni-app 开发环境。
+
+**下载安装**：
+1. 访问 https://www.dcloud.io/hbuilderx.html
+2. 下载 HBuilderX（标准版或 App 开发版）
+3. 安装并启动 HBuilderX
+
+**创建项目**：
+1. 文件 → 新建 → 项目
+2. 选择 uni-app
+3. 选择模板（默认模板、uni-ui 项目模板等）
+4. 填写项目名称和路径
+5. 点击创建
+
+### 方式二：使用 Vue CLI（推荐有经验开发者）
+
+**安装 Vue CLI**：
+
+```bash
+# 全局安装 Vue CLI
+npm install -g @vue/cli
+
+# 检查版本
+vue --version
+```
+
+**创建 uni-app 项目**：
+
+```bash
+# 使用官方预设模板
+vue create -p dcloudio/uni-preset-vue my-project
+
+# 或使用 degit（更快）
+npx degit dcloudio/uni-preset-vue my-project
+```
+
+**选择 Vue 版本**：
+- Vue 2：稳定版本，兼容性好
+- Vue 3：最新版本，性能更好
+
+### 方式三：使用官方 CLI（uni-app CLI）
+
+```bash
+# 安装 uni-app CLI
+npm install -g @dcloudio/uvm
+uvm
+
+# 创建项目
+npx degit dcloudio/uni-preset-vue my-project
+```
+
+## 环境要求
+
+### Node.js 版本
+
+- **推荐版本**：Node.js 14.x 或更高版本
+- **最低版本**：Node.js 12.x
+
+```bash
+# 检查 Node.js 版本
+node --version
+
+# 检查 npm 版本
+npm --version
+```
+
+### 其他工具
+
+- **微信开发者工具**：用于开发微信小程序
+- **Android Studio**：用于开发 Android App
+- **Xcode**：用于开发 iOS App（仅 macOS）
+
+## 验证安装
+
+创建项目后，验证安装是否成功：
+
+```bash
+cd my-project
+npm install
+npm run dev:h5
+```
+
+如果浏览器自动打开并显示 uni-app 欢迎页面，说明安装成功。
+
+## 常见问题
+
+### 1. npm 安装慢
+
+使用国内镜像：
+
+```bash
+npm config set registry https://registry.npmmirror.com
+```
+
+### 2. Vue CLI 版本问题
+
+确保使用最新版本：
+
+```bash
+npm update -g @vue/cli
+```
+
+### 3. HBuilderX 无法创建项目
+
+检查 HBuilderX 版本，确保是最新版本。
+
+## 下一步
+
+安装完成后，参考 `quick-start.md` 开始创建第一个项目。