dianming/快速使用指南.md

点名系统 - 快速使用指南

🎯 推荐使用方式

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

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

1. 打开后台管理

   • 直接双击 admin.html 文件
   • 或在浏览器中打开 admin.html

2. 登录系统

   • 用户名: admin
   • 密码: admin123

3. 创建点名名单

   • 输入名单名称
   • 输入成员（每行一个姓名）
   • 点击"生成"

4. 用户点名

   • 打开 index.html
   • 输入编号
   • 进行点名

优点：

• ✅ 无需安装Node.js
• ✅ 无需启动服务器
• ✅ 即开即用
• ✅ 数据保存在浏览器

---

方式二：服务器模式（功能完整）

需要Node.js环境

1. 启动服务器

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

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