# 点名系统 - 快速使用指南

## 🎯 推荐使用方式

### 方式一：本地模式（最简单，推荐！）

**无需任何配置，即开即用！**

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` 点名

**无需任何配置，开箱即用！**