133 lines
2.6 KiB
Markdown
133 lines
2.6 KiB
Markdown
# 点名系统 - 快速使用指南
|
||
|
||
## 🎯 推荐使用方式
|
||
|
||
### 方式一：本地模式（最简单，推荐！）
|
||
|
||
**无需任何配置，即开即用！**
|
||
|
||
1. **打开后台管理**
|
||
- 直接双击 `admin.html` 文件
|
||
- 或在浏览器中打开 `admin.html`
|
||
|
||
2. **登录系统**
|
||
- 用户名: `admin`
|
||
- 密码: `admin123`
|
||
|
||
3. **创建点名名单**
|
||
- 输入名单名称
|
||
- 输入成员（每行一个姓名）
|
||
- 点击"生成"
|
||
|
||
4. **用户点名**
|
||
- 打开 `index.html`
|
||
- 输入编号
|
||
- 进行点名
|
||
|
||
**优点**：
|
||
- ✅ 无需安装Node.js
|
||
- ✅ 无需启动服务器
|
||
- ✅ 即开即用
|
||
- ✅ 数据保存在浏览器
|
||
|
||
---
|
||
|
||
### 方式二：服务器模式（功能完整）
|
||
|
||
**需要Node.js环境**
|
||
|
||
1. **启动服务器**
|
||
```bash
|
||
node server.js
|
||
```
|
||
或双击 `启动服务器.bat`
|
||
|
||
2. **访问系统**
|
||
- 后台: http://localhost:3000/admin.html
|
||
- 点名: http://localhost:3000/index.html
|
||
|
||
3. **登录使用**
|
||
- 用户名: `admin`
|
||
- 密码: `admin123`
|
||
|
||
**优点**：
|
||
- ✅ 数据永久保存
|
||
- ✅ 支持多用户
|
||
- ✅ 可局域网访问
|
||
|
||
---
|
||
|
||
## ❌ 常见错误解决
|
||
|
||
### 错误1: "Unexpected token '<', ... is not valid JSON"
|
||
|
||
**原因**: 服务器模式但API接口不存在
|
||
|
||
**解决方案**:
|
||
1. **推荐**: 使用本地模式（直接双击HTML文件）
|
||
2. 或确保已启动Node.js服务器（`node server.js`）
|
||
|
||
### 错误2: "无法连接到服务器"
|
||
|
||
**原因**: 服务器未启动
|
||
|
||
**解决方案**:
|
||
1. 使用本地模式（推荐）
|
||
2. 或启动服务器: `node server.js`
|
||
|
||
### 错误3: "Failed to fetch"
|
||
|
||
**原因**: 网络请求失败
|
||
|
||
**解决方案**:
|
||
1. 使用本地模式
|
||
2. 或检查服务器是否运行
|
||
|
||
---
|
||
|
||
## 💡 使用建议
|
||
|
||
### 什么时候用本地模式？
|
||
- ✅ 个人学习测试
|
||
- ✅ 快速演示
|
||
- ✅ 临时使用
|
||
- ✅ 无需多用户
|
||
|
||
### 什么时候用服务器模式？
|
||
- ✅ 正式使用
|
||
- ✅ 需要数据持久化
|
||
- ✅ 多人协作
|
||
- ✅ 局域网访问
|
||
|
||
---
|
||
|
||
## 🔍 如何判断当前模式？
|
||
|
||
打开页面后，在标题下方会显示：
|
||
- "当前运行模式: 本地模式 (数据保存在浏览器本地)"
|
||
- "当前运行模式: 服务器模式"
|
||
|
||
---
|
||
|
||
## 📞 快速故障排查
|
||
|
||
**遇到任何错误，首先尝试：**
|
||
|
||
1. **刷新页面** (F5)
|
||
2. **清除浏览器缓存** (Ctrl+Shift+Delete)
|
||
3. **使用本地模式** (直接双击HTML文件)
|
||
|
||
如果本地模式正常，说明是服务器配置问题，继续使用本地模式即可。
|
||
|
||
---
|
||
|
||
## 🎉 总结
|
||
|
||
**最简单的使用方法：**
|
||
1. 双击 `admin.html`
|
||
2. 登录: admin / admin123
|
||
3. 创建名单
|
||
4. 双击 `index.html` 点名
|
||
|
||
**无需任何配置，开箱即用！**
|