20251222

tempdocs/部署工具使用.md

@@ -0,0 +1,129 @@
+# 🚀 部署工具 - 快速使用指南
+
+## ⚡ 快速启动
+
+### 方式 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`** 🚀
+