First

快速使用指南.md

@@ -0,0 +1,132 @@
+# 点名系统 - 快速使用指南
+
+## 🎯 推荐使用方式
+
+### 方式一：本地模式（最简单，推荐！）
+
+**无需任何配置，即开即用！**
+
+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` 点名
+
+**无需任何配置，开箱即用！**