需先满足双系统严格前置条件：windows 10 22h2+、macos 14.5+、node.js v20.12.0/v20.14.0；再完成双签名校验、分平台安装与首启授权、cli oauth绑定同步身份、最后启用quest mode并配置qwake唤醒指令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在Windows和macOS双系统上完整部署QoderWake v1.0或v2.0正式版，确保数字员工身份一致、CLI可跨平台调用、Quest Mode能同步启用，且不因签名机制差异导致任一平台启动失败。
校验系统兼容性与基础依赖
QoderWake v1.0/v2.0采用Harness-First架构，Windows与macOS必须满足不同但严格的前置条件，缺一不可。v2.0额外要求Node.js v20.14.0+，而v1.0仍支持v20.12.0；若版本错配，首次启动时IDE将静默退出，无错误提示。
Windows：确认系统为Windows 10 22H2或更高版本→打开设置→系统→关于→查看“版本”；若低于22H2，【必须升级系统后才能继续】。
macOS：点击左上角苹果图标→“关于本机”，确认版本号≥14.5（Sequoia）；若显示Ventura（13.x），需先升级系统，否则Gatekeeper会永久拦截启动。
统一验证Node.js：在Windows PowerShell与macOS终端中分别执行node -v，输出必须为v20.12.0或v20.14.0（依所装版本而定）；若报command not found，请先安装LTS版Node.js并重启终端。
Python检查仅macOS需执行：python3 -c "import ssl; print(ssl.OPENSSL_VERSION)"，输出OpenSSL 3.0.13或更高；Windows用户跳过此步——v1.0/v2.0已内嵌精简Python运行时。
下载与签名完整性双重校验
v1.0与v2.0均启用双签名机制，Windows校验数字签名，macOS校验公证状态与SHA256哈希值，二者缺一即无法通过初始化校验。
方法一：Windows平台校验
右键下载的qoderwake-v2.0.0-win-x64.exe（或v1.0对应文件）→属性→数字签名→选中签名项→点击“详细信息”→确认“签名者”为Alibaba Cloud Qoder Signing Authority，且“证书状态”显示“此数字签名正常”。
方法二：macOS平台校验
在终端中执行：shasum -a 256 /Users/yourname/Downloads/qoderwake-v2.0.0-macos-arm64.pkg（路径按实际调整）→复制输出的64位哈希值→打开官网https://qoder.com/zh/docs/installation/checksums→查找v2.0.0-macos-arm64条目→逐字符比对，【任何一位不同都必须重下】。
注意：v2.0的macOS安装包后缀统一为.pkg，不是.dmg；若下载到.dmg，说明你误入了内测通道，需立即切换至官网稳定版下载页登录后获取。
分平台安装与首启权限授予
Windows安装走标准向导流程，macOS则必须手动解除Gatekeeper限制，两者的首启权限授予步骤不可互换，顺序错乱将导致后续Quest Mode无法注册。
第一步：Windows安装
双击exe安装包→勾选“添加到系统 PATH”和“创建桌面快捷方式”→点击“安装”→等待进度条完成→勾选“启动QoderWake”并点击完成。
第二步：macOS安装
双击.pkg文件→按向导完成安装→安装完毕后不要立刻启动→打开“系统设置”→“隐私与安全性”→滚动到底部“安全性”区域→找到刚安装的QoderWake条目→点击右侧“允许”。
第三步：双平台统一首启授权
在Windows中首次启动QoderWake.exe，弹出UAC提示时点“是”；在macOS中首次双击/Applications/QoderWake.app，若弹出“无法验证开发者”，点“取消”→再进“系统设置→隐私与安全性”，在“辅助功能”“全盘访问”“钥匙串访问”三项中分别点击“+”，将QoderWake拖入；每项添加后，重启应用一次。
CLI绑定与跨平台身份同步
QoderWake v1.0/v2.0强制要求CLI与用户账户OAuth绑定，且v2.0新增设备指纹校验，未完成此步则qwake命令始终返回“unauthorized”，Quest Mode开关也无法保存。
① 在Windows PowerShell中执行：curl -fsSL https://qoder.com/install | bash→等待安装完成→执行qodercli --version确认返回v2.0.0或v1.8.3。
② 在macOS终端中执行完全相同的命令→同样验证版本→然后分别在两台机器上运行qodercli→输入/login→选择login with browser。
③ 此时两台设备会各自弹出浏览器窗口，均需登录同一qoder.com账户→确认授权范围包含“Device Registration & Quest Execution”→提交后等待页面显示“Success: Identity synced”。
④ 回到任一终端，执行qodercli config list，检查identity字段是否均为verified@yourcompany.com，且device_id不重复；若Windows显示anonymous，说明未完成浏览器授权，需重新/login。
启用Quest Mode与设置唤醒指令
Quest Mode是QoderWake的核心能力入口，v2.0默认关闭且带熔断保护，v1.0虽默认开启但需手动绑定终端唤醒指令，二者配置路径一致但生效逻辑不同。
在Windows或macOS中打开Qoder IDE→点击右上角用户头像→Settings → Agent Settings→找到Quest Mode Activation→将开关设为开启→务必勾选Enable terminal wake command。
在任意终端中执行：qodercli config set wake-command "qwake"→该指令会同时写入两平台的config.yaml，但仅当前执行终端所在系统立即生效。
为确保双平台均可触发，需分别在Windows PowerShell与macOS终端中各执行一次该命令；执行后，任一系统输入qwake init new-api都将拉起项目初始化流程，无需打开IDE界面。
