================================================================
================================================================
新版包内不含 data/、uploads/，整包覆盖不会丢失帖子、用户、图片、配置。
----------------------------------------------------------------
一、升级前备份（强烈建议，2 分钟）
----------------------------------------------------------------
宝塔面板 → 网站 → 找到你的论坛站点 → 备份
- 网站文件备份
- 数据库备份（若用 MySQL）
或：直接在宝塔「文件」里把 /www/wwwroot/bbs 目录复制一份改名
（如 bbs_old），作为整站备份。
----------------------------------------------------------------
二、上传新版并覆盖（只动程序文件）
----------------------------------------------------------------
1. 下载新版 lightforum.zip，解压得到论坛源码目录
2. 宝塔 → 文件 → 进入 /www/wwwroot/bbs
3. 上传 lightforum.zip → 解压 → 弹窗选择【覆盖】
（也可先删除根目录的旧 php 文件再解压，但【覆盖】即可，无需删除）
4. 覆盖完成后，确认这些目录还在（用户数据，不能被删）：
/www/wwwroot/bbs/data/ ← 数据库、配置、上传附件索引
/www/wwwroot/bbs/uploads/ ← 用户上传的图片/文件/视频
（覆盖不会删除它们；若之前手动删过就糟了，所以先备份）
----------------------------------------------------------------
三、数据库配置自动延续（无需任何操作）
----------------------------------------------------------------
程序的数据库连接信息保存在 data/settings.php，
升级不覆盖该文件 → SQLite/MySQL 连接自动延续，帖子数据原样保留。
新版如需新增字段（如板块禁发、板块隐藏/等级门槛、签名、充值等），
首次访问首页会自动迁移，无需手动建表。
----------------------------------------------------------------
四、源码授权（已预配置，激活请联系开发者）
----------------------------------------------------------------
本包已预填授权服务器配置，无需手动修改任何文件：
1. 直接访问网站首页，应正常打开（无报错）
2. 后台 → 授权管理：显示「未授权」时，联系开发者获取授权码并协助激活；
激活成功后显示「✅ 已授权」
未授权期间：后台功能锁定、前台顶部显示提示横幅，属正常现象。
----------------------------------------------------------------
五、在线更新（已预配置，一键更新）
----------------------------------------------------------------
1. 更新服务器地址已预填，无需手动配置
2. 后台 → 在线更新 → 点击「检查更新」→ 看到新版本后点「安装」
3. 安装前自动备份旧文件（data/backup-update-*/），安装失败可手动恢复
4. 安装完成后确认版本号已更新，即升级成功
----------------------------------------------------------------
六、升级后检查清单
----------------------------------------------------------------
[ ] 首页正常打开、帖子/用户数据都在
[ ] 图片/附件还能正常显示（uploads 完好）
[ ] 登录后台正常，各功能页面无报错
[ ] 授权管理显示 ✅ 已授权
[ ] 后台导航出现「在线更新」，点击可检查更新
[ ] 手机端访问正常（新版 UI 已适配）
出现任何报错：把完整报错文字截图发开发者处理；报错前先确认
data/settings.php 与 data/ 目录未被覆盖或删除。
================================================================