QoderWake自动升级失败时需手动下载增量包覆盖安装：先确认版本兼容性并校验签名，再下载校验增量包，停止服务并备份目录，最后执行解压覆盖并验证结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试让 QoderWake 自动升级，但进度停滞在“正在校验增量包”“签名验证失败”或“下载完成但未触发安装”，则可能是由于 CDN 节点缓存污染、增量补丁与当前版本基线不匹配、或本地更新服务进程被沙盒策略拦截所致。以下是手动下载增量包并覆盖安装的具体操作步骤：
一、确认当前版本与目标增量包兼容性
QoderWake 增量升级包非通用二进制，必须严格匹配当前运行版本（如 v0.3.5）与目标版本（如 v0.3.6）之间的差分基线，否则签名校验将直接拒绝加载。需先获取精确版本指纹及官方发布的增量包元信息。
1、启动 QoderWake 客户端，在终端中执行 qoderwake --version --verbose，记录输出中的 build_id（如 20260522-143822）与 channel（如 stable 或 preview）。
2、访问阿里可信更新源地址：https://qoder.com/updates/stable/，在页面中查找与当前 build_id 同日发布的 .delta 文件（例如 qoderwake-v0.3.5-to-v0.3.6.delta）。
3、点击该文件链接，核对响应头中 X-Qoder-Signature: SHA256=... 与页面旁标注的 checksum 是否一致；若不一致，立即中止后续操作。
二、下载增量包并校验完整性
增量包体积小但敏感度高，传输过程中任一字节损坏均会导致应用层校验失败。必须使用支持断点续传与哈希回写机制的工具下载，并在本地完成双重校验。
1、在终端中执行下载命令（Windows PowerShell）：Invoke-WebRequest -Uri "https://qoder.com/updates/stable/qoderwake-v0.3.5-to-v0.3.6.delta" -OutFile "$env:TEMP\qoderwake-update.delta"。
2、Linux/macOS 用户执行：curl -fL -o /tmp/qoderwake-update.delta https://qoder.com/updates/stable/qoderwake-v0.3.5-to-v0.3.6.delta。
3、校验 SHA256：Windows 执行 Get-FileHash $env:TEMP\qoderwake-update.delta -Algorithm SHA256 | Select-Object -ExpandProperty Hash；Linux/macOS 执行 shasum -a 256 /tmp/qoderwake-update.delta | cut -d' ' -f1。
4、将输出值与官网页面标注的 checksum 进行逐字符比对，完全一致方可进入下一步。
三、停止守护进程并备份当前安装目录
QoderWake 升级过程会锁定主二进制与 runtime 目录，若进程仍在运行，覆盖操作将被系统拒绝。必须先终止全部相关进程，并保留可回退的原始副本。
1、执行强制终止命令：qoderwake service stop && taskkill /F /IM qoderwake.exe /T (Windows) 或 qoderwake service stop && pkill -f qoderwake (Linux/macOS)。
QoderWake Linux版是阿里推出的生产级数字员工系统，支持Linux环境部署。它作为7×24小时在线的AI员工，具备长期记忆与专业技能（如编程、运维），可自主响应代码审查、告警处理等事件。其核心采用“员工与工位分离”架构，并设置了严格的权限红线，确保持续进化的同时实现安全可控。
2、定位主安装路径：Windows 默认为 C:\Program Files\QoderWake\，Linux 为 /opt/qoderwake/，macOS 为 /Applications/QoderWake.app/Contents/MacOS/。
3、将整个目录复制为备份，例如重命名为 QoderWake.v0.3.5.backup，确保路径中不含空格与中文。
四、执行增量包解压与覆盖安装
QoderWake 增量包采用自解包格式，不依赖外部工具链，但必须由具备读写权限的用户在安装目录内直接运行，否则无法定位上下文路径与沙盒根目录。
1、将已校验通过的 qoderwake-update.delta 文件复制到主安装目录根层级（与 qoderwake.exe 或 qoderwake 二进制同级）。
2、Windows 用户以管理员身份打开 PowerShell，导航至该目录后执行：.\qoderwake-update.delta --apply --force。
3、Linux/macOS 用户在终端中执行：chmod +x ./qoderwake-update.delta && sudo ./qoderwake-update.delta --apply --force。
4、等待控制台输出 Patch applied successfully. Runtime rebuilt.，期间禁止关闭终端或中断电源。
五、验证升级结果并刷新运行时环境
覆盖安装仅更新二进制与核心模块，但用户配置、插件状态与策略缓存仍保留在原位置。必须主动触发环境重载，否则新版本逻辑不会生效。
1、启动 QoderWake 客户端，打开终端并执行：qoderwake status，确认 version 字段已更新为 v0.3.6，且 build_id 显示新时间戳。
2、执行运行时刷新：qoderwake reload --all --skip-cache，该命令将清空内存中所有策略快照与工具链缓存，并重新加载全部扩展。
3、检查关键功能是否就绪：运行 qoderwake test --module auth 与 qoderwake test --module connector，两项均返回 PASS 表示升级完成。
