Version Migration.zh cn

QModem 版本迁移与反馈

发布索引

标签	分支	状态	迁移说明	反馈入口
v3.3.0	stable	稳定发布	从旧版本升级前备份 UCI；短信数据库由后端维护，升级后首次同步可能较慢	3.3.0 issues
v3.4.0_rc3	main	预发布、社区测试	含 QModem 设置服务、事件触发短信同步和 VoIP 变更；不建议作为生产固件	3.4.0_rc3 issues

Issue 链接是按版本标签筛选的稳定入口。实际发布时为每个标签创建一个置顶 Issue， 标题包含完整标签，正文固定列出已知问题、升级注意事项和反馈格式；新版本置顶后取消 上一个版本的置顶状态。不要把 IMEI、IMSI、ICCID、电话号码、凭据或短信正文直接贴入 Issue。

升级检查

升级前记录当前固件、QModem 标签、模组型号/固件和 UCI 配置。保留配置升级后检查：

1. qmodem、ubus、at-daemon 和短信后端均已启动；
2. 短信存储位置、URC 注册和模组设置状态已完成；
3. 数据库可读，手动同步只导入一次，SIM 中已导入短信被删除；
4. 旧版本的 LuCI API 调用没有残留，页面显示 timestamp 正确；
5. 出现异常时保留版本、完整提交 SHA 和脱敏日志，再回滚到上一稳定标签。

跨大版本升级不保证直接跳过中间版本。若发布说明标注需要中间版本，先升级到指定 稳定版本完成数据库/UCI 迁移，再继续升级。

Issue 模板

请在标题中写明 [v3.3.0] 或 [v3.4.0_rc3]，并提供路由器型号、模组型号及固件、 QModem 完整提交 SHA、复现步骤和脱敏日志。版本相关的行为先在对应标签的置顶 Issue 下反馈，确认属于新问题后再单独开 issue。