docs(manual): 说明书补充设备升级章节/FAQ/注意事项/封面版本, 文档版本V1.2

generate_manual.py

@@ -405,6 +405,12 @@ faqs = [
     ("Q3：Lora信道列表很长，如何快速选择？",
      "Lora信道下拉框支持鼠标滚轮滚动选择，也可以点击下拉后直接滚动浏览。"
      "信道编号和频率一一对应，选择后点击发送即可。"),
+    ("Q4：设备升级失败或超时怎么办？",
+     f"1）确认升级过程中串口连接稳定，未出现断开或断电；2）确认{LQ}设备MAC{RQ}与目标网关一致；"
+     "3）确认固件文件为与设备匹配的.bin文件且未损坏；4）重新点击开始升级再试一次。"),
+    ("Q5：设备管理查询不到设备或列表为空？",
+     "1）确认网关上已注册过通讯单元设备；2）点击刷新查询重试；"
+     "3）确认串口通讯正常（可通过查看配置验证）；4）若刚删除设备，列表已实时更新属正常现象。"),
 ]
 for q, a in faqs:
     story.append(Paragraph(f"<b>{q}</b>", style_body))
@@ -423,6 +429,8 @@ warnings = [
     f"<b>数据备份：</b>修改配置前建议先通过{LQ}查看配置{RQ}记录当前参数，以便需要时恢复。",
     "<b>断电保护：</b>配置修改后请确认网关已保存参数，避免在参数写入过程中断电。",
     "<b>驱动安装：</b>首次使用需安装USB转串口芯片驱动（如CH340、CP2102等），具体型号取决于使用的转接线。",
+    "<b>升级安全：</b>固件升级过程中严禁断开串口、关闭软件或给网关断电，否则可能导致网关固件损坏而无法启动。",
+    "<b>固件匹配：</b>请使用与网关硬件和项目匹配的固件文件（.bin），错误的固件可能导致设备功能异常。",
 ]
 for w in warnings:
     story.append(Paragraph(f"\u26a0 {w}", style_body))