# 🚀 部署工具 - 快速使用指南

## ⚡ 快速启动

### 方式 1：直接启动部署工具（推荐）
```bash
cd AdminTool
python deploy_tool.py
```
**自动跳转到部署功能，忽略后端 API 错误**

### 方式 2：完整管理工具
```bash
cd AdminTool
python admin_gui.py
```
手动切换到「自动化部署」标签页

---

## 📦 完整部署流程

### 1️⃣ 构建前端
```bash
cd D:\main\DesignerCEP\Designer
npm run build:core
```
等待构建完成，生成 `dist_core/` 目录

### 2️⃣ 启动部署工具
```bash
cd D:\main\DesignerCEP\AdminTool
python deploy_tool.py
```

### 3️⃣ 配置服务器（首次使用）
在「服务器配置」区域：
- 服务器地址：`103.97.201.136`
- SSH 端口：`22`
- 用户名：`root`
- 密码：`***`（填入实际密码）

点击「保存配置」

### 4️⃣ 部署
在「部署新版本」区域：
1. 点击「浏览...」选择 `Designer/dist_core` 目录
2. 输入备注（可选）：例如 `修复主题同步bug`
3. 点击 **「🚀 部署到服务器」**

### 5️⃣ 等待完成
部署日志会实时显示进度：
- ✅ 连接服务器
- ✅ 备份当前版本
- ✅ 上传新版本
- ✅ 保存版本历史
- ✅ 更新记录

完成后访问：https://app.aidg168.uk/

---

## 🔄 版本回滚

如果新版本有问题：

1. 在「版本历史管理」表格中查看所有版本
2. 点击要回滚的版本（表格行）
3. 点击 **「⏪ 回滚到选中版本」**
4. 确认操作
5. 刷新网站验证

---

## ⚠️ 常见问题

### Q: 启动时出现 "500 Server Error" 或 "获取组列表失败"？
**A**: 这是正常的，可以忽略！
- 这个错误来自后端 API（组管理功能）
- **不影响部署功能**
- 部署功能完全独立，使用 SSH 直接操作服务器
- 建议使用 `deploy_tool.py` 启动，自动跳过这个错误

### Q: 如何确认部署成功？
**A**: 
1. 查看部署日志，最后应显示「🎉 部署完成！」
2. 访问 https://app.aidg168.uk/ 验证
3. 版本历史列表会显示新版本（带 ✅ 当前标记）

### Q: 部署需要多久？
**A**: 通常 1-2 分钟，取决于：
- 文件大小（dist_core 约 10-15MB）
- 网络速度

### Q: 可以删除旧版本吗？
**A**: 可以，但注意：
- ❌ 无法删除当前正在使用的版本
- 建议保留 3-5 个最近的版本用于回滚

---

## 🎯 部署前检查清单

- [ ] 已运行 `npm run build:core`
- [ ] `Designer/dist_core/` 目录存在
- [ ] 服务器 SSH 配置正确
- [ ] 已点击「测试连接」验证

---

## 📞 技术支持

- 详细文档：[部署功能使用说明.md](./部署功能使用说明.md)
- 修复说明：[修复说明.md](./修复说明.md)
- 测试系统：`python test_version_system.py`

---

## 💡 提示

1. **后端 API 错误不影响部署** - 部署功能完全独立
2. **首次使用建议测试** - 先部署一个测试版本熟悉流程
3. **保留历史版本** - 方便快速回滚
4. **非高峰期部署** - 避免影响线上用户

---

**开始使用：`python deploy_tool.py`** 🚀