驱动与固件更新
驱动运行在电脑上，固件运行在知言家 AI Coding 伴侣设备中。两类更新的入口、前置条件和失败恢复不同，不要混在一起处理。
更新驱动
- 右键托盘中的知言家 logo，打开“设置”，在“驱动更新”区域点击“检查更新”。
- 检查到新版本后点击下载，并等待进度完成。
- 状态变为可以应用后，点击“应用并重启”。驱动会退出当前进程、完成替换并重新启动。
托盘中的“驱动更新”菜单也会按当前状态执行下一步，依次显示检查、下载、应用并重启或重试。需要查看详细状态和错误阶段时，仍建议从设置页操作。
你应该看到
重新启动后，设置页显示新的驱动版本；如果已经是最新版，更新状态会显示为已是最新版本或允许重新检查。
驱动更新属于电脑端操作，不等同于给设备写入固件。
更新固件
- 先通过 USB 连接设备。
- 等待控制台显示“串口优先”，并确认连接稳定。
- 如果连接了多台设备，先在设备组中选择需要升级的“当前设备”；外观相同时可先点击“标记”确认。
- 在控制台的固件区域检查更新。
- 按页面提示执行更新，直到出现明确的完成或失败结果。
普通固件更新不通过蓝牙执行。只连接蓝牙时看不到固件更新入口是正常限制；插入 USB 并等到“串口优先”后，再重新检查。
你应该看到
固件更新完成后，原设备重新回到设备组，控制台恢复“串口优先”，并显示更新后的固件版本。
固件更新安全检查
更新过程中不要拔线、关闭驱动或让电脑休眠。如果更新仍在进行，请不要卸载驱动。
固件更新异常与恢复
固件 OTA 可能在写入或校验阶段失败。遇到异常时按以下顺序处理：
- 不要拔线：即使页面长时间无响应，也先保持 USB 连接，等待是否出现明确的失败结果。
- 查看结果阶段：失败时页面通常会显示失败发生在下载、写入还是校验阶段，记录该信息便于排查。
- 重新插拔后重试：拔下 USB 重新插入，等待控制台恢复“串口优先”，再次检查更新并执行。
- 确认设备能正常握手：重试前先确认控制台仍能读取设备名称、固件版本和电量；无法握手时先按故障排查定位链路问题。
- 导出诊断包：反复失败时，从驱动设置中导出诊断包，并附上失败阶段信息反馈给官方支持。
设备未变砖的判断
更新失败后，只要重新插入 USB 仍能读取到设备信息并显示“串口优先”，说明设备仍可被驱动识别，可继续重试更新。
固件降级说明
固件降级不在常规更新支持范围内。通常情况下，安装更新的固件版本即可获得修复与改进。
- 如果更新到新版本固件后遇到影响使用的回归，请先查阅更新日志确认是否为已知问题。
- 确需返回上一版本时，不要自行尝试非官方降级方式，请联系官方支持并提供诊断包与失败现象。
- 降级可能涉及设备协议兼容性，盲目操作有导致设备不可用的风险。
驱动版本切换
驱动更新属于电脑端操作，版本切换比固件灵活：
- 回到上一版驱动：从官方驱动发布中心获取目标版本的安装包，直接运行安装程序覆盖当前版本即可，无需先卸载。
- 覆盖安装的保留项：覆盖安装会沿用现有安装目录与用户级插件配置，与安装与卸载驱动中描述的卸载保留范围一致。
- 切换后重新修复插件：跨版本切换后，建议在驱动设置中执行一次“预览并修复插件副本”，确保插件脚本与当前驱动版本一致。
驱动与固件的版本配合
部分驱动版本对设备固件有最低要求，固件版本过低时某些功能可能不可用。跨大版本切换时，请先查阅对应版本的更新日志中的 requires 要求。
升级前后自检清单
更新前
- [ ] 设备通过 USB 连接，控制台显示“串口优先”
- [ ] 设备电量充足（建议高于 20%，避免低电状态下更新）
- [ ] 已退出正在运行的 AI 客户端，避免更新期间产生新任务
- [ ] 已查阅目标版本的更新日志，了解新增、修复与已知问题
- [ ] 电脑不会在更新期间休眠或关机
更新后
- [ ] 控制台恢复“串口优先”，设备信息（名称、固件版本、电量）正常读取
- [ ] 驱动版本或固件版本已更新为目标版本
- [ ] 已执行“预览并修复插件副本”（跨版本切换时必做）
- [ ] 重启 AI 客户端后发送一条普通消息，确认任务状态与灯效正常
更新遇到异常时，请先按故障排查确认当前问题属于驱动层还是设备链路层。