feat: 完善项目功能和部署脚本

- 修复页面跳转白屏闪烁问题
- 集成过渡岗位页面(岗位装配中心)
- 添加iframe全屏嵌入(教务系统、就业规划)
- 优化企业资源卡片hover分裂效果
- 添加Windows和macOS快捷部署脚本
- 更新.gitignore忽略测试文件和缓存

🤖 Generated with Claude Code
This commit is contained in:
KQL
2025-12-04 16:03:31 +08:00
parent db6b5627a3
commit b0d2e629d9
9 changed files with 1234 additions and 239 deletions

144
快捷部署说明.md Normal file
View File

@@ -0,0 +1,144 @@
# 🚀 快捷部署指南
本项目提供了 Windows 和 macOS 的一键启动脚本,方便快速部署到局域网。
---
## 📦 前置要求
### 必须安装 Node.js
- **macOS**:
- 官方下载: https://nodejs.org/
- Homebrew 安装: `brew install node`
- **Windows**:
- 官方下载: https://nodejs.org/
- 建议下载 LTS长期支持版本
---
## 🍎 macOS / Linux 使用方法
### 方法一:双击运行(推荐)
1. 找到项目文件夹中的 `启动服务器.sh`
2. **双击**运行(系统会自动使用终端打开)
3. 如果提示权限问题,请使用方法二
### 方法二:命令行运行
```bash
# 1. 打开终端Terminal
# 2. 进入项目目录
cd /Users/apple/Documents/cursor/三合一页面
# 3. 运行脚本
./启动服务器.sh
```
### 方法三:直接拖拽
1. 打开终端Terminal
2. 拖拽 `启动服务器.sh` 到终端窗口
3. 按回车
---
## 🪟 Windows 使用方法
### 方法一:双击运行(推荐)
1. 找到项目文件夹中的 `启动服务器.bat`
2. **双击**运行
3. 会自动打开命令提示符窗口
### 方法二:右键管理员运行(可选)
1. 右键点击 `启动服务器.bat`
2. 选择「以管理员身份运行」
3. 点击「是」允许运行
---
## 📱 如何访问
脚本启动后,会显示访问地址:
```
📍 本机访问: http://localhost:8080
📍 局域网访问: http://192.168.2.9:8080
```
### 本机访问
- 在启动服务器的电脑上打开浏览器
- 输入: `http://localhost:8080`
### 手机/平板访问
1. 确保设备连接到**同一个 WiFi**
2. 打开浏览器
3. 输入局域网地址(如 `http://192.168.2.9:8080`
---
## ⏹️ 如何停止服务器
- **macOS / Linux**: 按 `Ctrl + C`
- **Windows**: 按 `Ctrl + C` 或直接关闭窗口
---
## ❓ 常见问题
### 1. 提示「找不到 Node.js」
**原因**: 未安装 Node.js
**解决**: 访问 https://nodejs.org/ 下载安装
### 2. macOS 提示「权限被拒绝」
**解决方法**:
```bash
chmod +x 启动服务器.sh
```
### 3. 手机无法访问局域网地址
**检查清单**:
- ✅ 手机和电脑是否连接到同一个 WiFi
- ✅ 服务器是否正在运行
- ✅ 电脑防火墙是否阻止了 8080 端口
- ✅ IP 地址是否输入正确
**macOS 防火墙设置**:
1. 系统偏好设置 → 安全性与隐私 → 防火墙
2. 点击「防火墙选项」
3. 确保允许 Node.js 的网络连接
**Windows 防火墙设置**:
1. 控制面板 → Windows Defender 防火墙
2. 高级设置 → 入站规则
3. 新建规则,允许端口 8080
### 4. 端口 8080 被占用
**解决方法**: 修改 `server.js` 中的端口号
```javascript
const PORT = 8080; // 改成其他端口,如 3000
```
---
## 🔧 高级配置
如需修改端口或其他配置,请编辑 `server.js` 文件:
```javascript
const PORT = 8080; // 修改端口号
```
修改后重新运行启动脚本即可。
---
## 📞 技术支持
如遇到其他问题,请检查:
1. Node.js 版本: `node --version` (建议 v14 以上)
2. 项目文件是否完整
3. 防火墙设置
---
**祝使用愉快!** 🎉