❓ 常见问题（v2.8）
本文档对应 AgoraIn v2.8（AgoraInPro）。旧版 v2.7 文档已归档：v2.7 常见问题。
构建与运行
Q: 构建报"文件被占用 / 无法复制 AgoraIn.exe"？
A: 先结束旧进程再构建：
powershell
Stop-Process -Name AgoraIn -ForceQ: 自测命令怎么用？
A: 在客户端目录执行：
powershell
& .\AgoraInPro\bin\Debug\net10.0-windows\AgoraIn.exe --selftest退出码 0 表示全部通过。
服务器与连接
Q: 服务器提示"未配置 ServerPassword，已自动生成"？
A: 这是安全默认行为。请打开服务器目录 config.json 查看生成的密码，并在客户端「远程服务器设置」中填入。
Q: 客户端连不上服务器？
A: 依次检查：
- 服务器端口（默认 5250）是否开放
- 服务器 IP 是否正确
- 服务器
config.json中的ServerPassword是否与客户端一致 - 客户端与服务器是否在同一局域网
Q: 服务器地址填哪里？
A: 客户端菜单 远程 → 远程服务器设置，填写服务器 IP、端口（默认 5250）与密码。
排课与课时
Q: 排课无法提交？
A: 检查：
- 上课/下课时间是否已填写（格式 HH:mm）
- 下课时间不得等于上课时间
- 重复排课会被拦截
Q: 开启自动扣减后课时未变化？
A: 确认：
- 排课的起止时间均有效
- 课程已到下课时间
- 系统每 30 秒检查一次，同一时段不会重复扣减（SlotKey 去重）
Q: 如何设置每小时课时消耗？
A: 在「控制模式 → 划课」的设置项中配置 每小时课时消耗，支持小数（如 0.5 / 1 / 1.5，范围 0–24）。
Q: 排课支持跨天课程吗？
A: 支持。如 23:00–01:00 的跨天课程，下课时间不得等于上课时间即可。
Q: 怎么设置不排课日？
A: 在月历中选中日期，点击 设为不排课日，系统自动清空当日排课并以粉底"休"标记；周末默认提示为不排课。
数据与安全
Q: 课时数据存储在哪里？
A: 客户端目录下的 data/classhours.json（版本 v3），包含学生课时、流水、排课、不排课日与自动划消设置。
Q: 服务器数据存储在哪里？
A: 服务器目录的 SQLite 数据库中，包含设备、任务、考勤、用户、签到任务等。
Q: 密码安全吗？
A: 安全。用户密码采用加盐 SHA256 哈希存储；管理员密码通过 SHA256 哈希校验；服务器密码未配置时自动生成随机密码。
Q: 如何备份数据？
A: 直接复制数据文件即可：客户端课时数据（data/classhours.json）、服务器 SQLite 数据库。恢复时覆盖原文件（建议先停止程序）。
其他
Q: 旧版 v2.7 文档在哪里？
A: 已归档，可通过 旧版文档主页 或站点导航中的"旧版文档（v2.7）"入口查看。