必须主动检查更新，因默认不开启后台静默检查；进入「设置→关于 & 检查更新」页，通过双路径（auto-update + github api）检查版本，支持自动下载安装或手动下载安装包，安装前须完全退出程序，重启后核对版本号、electron 版本及任务日志验证成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让AionClaw保持最新功能和安全修复，必须主动检查更新并完成升级，不能依赖系统自动提醒——因为默认不开启后台静默检查。
进入「关于 & 检查更新」设置页
启动 AionClaw 桌面客户端 → 点击左下角齿轮图标打开【设置】→ 在左侧菜单栏滚动到底部，点击「关于 & 检查更新」。
这一页会立即加载当前应用版本号、Electron 运行时版本、构建时间，并显示「检查更新」按钮。注意：页面顶部的版本号格式为 【v3.0.3-beta.2+20260918】 这类带时间戳的完整标识，仅看“3.0.3”可能误判是否为最新。
手动触发双路径更新检查
点击「检查更新」按钮，系统将按顺序执行两条独立检查路径：
路径A（Auto-update）：调用 electron-updater 向 GitHub Release 页面请求 yml 配置文件 → 若网络策略拦截或 GitHub 限流，则静默跳过，不报错也不中断；
路径B（Manual check）：直接调用 GitHub REST API GET /repos/aionclaw/aionclaw/releases → 获取全部发布版本列表、changelog、assets 下载链接，该路径始终执行且优先返回结果。
两路检查完成后，界面会刷新状态。若检测到新版本，「检查更新」按钮变为「下载并安装 v3.0.4」；若无更新，则显示「已是最新版本（v3.0.3）」。
下载并安装新版本
方法一：点击「下载并安装 v3.0.4」→ 弹出确认窗口 → 勾选「安装后自动重启」→ 点击「继续」→ 下载开始，进度条实时显示；
方法二（手动下载）：在更新弹窗中点击「前往 GitHub Releases 页面」→ 找到对应平台的安装包（如 AionClaw-3.0.4-macOS-arm64.dmg 或 AionClaw-3.0.4-win-x64-setup.exe）→ 下载后双击运行安装程序 → 安装过程会自动关闭旧进程并覆盖原目录。
【关键前提：安装前必须完全退出 AionClaw 主程序，否则 Windows/macOS 均会提示“文件被占用”，导致安装失败】
安装完成后，桌面快捷方式图标可能短暂消失，这是正常现象；重新启动应用即可加载新版本。
验证升级是否成功
第一步：重启 AionClaw → 进入「设置 → 关于 & 检查更新」；
第二步：核对顶部显示的版本号是否已变更为目标版本（例如 v3.0.4）；
第三步：打开开发者工具（Ctrl+Shift+I / Cmd+Option+I）→ 切换到 Console 标签页 → 输入 process.versions.electron 回车 → 确认 Electron 版本与新版 release note 中声明的兼容版本一致；
第四步：执行一次基础任务（如发送测试消息、生成简报），观察日志面板是否无「update rollback」「downgrade blocked」类错误输出。
