必须先确认系统与基础工具链就绪，再按顺序完成五步初始化：授予权限、绑定GitHub账户、配置GitHub Connector、加载权限红线策略集、执行Git仓库分析Quest任务验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在Windows、macOS或Linux上快速跑起QoderWake，但被安装路径混乱、权限报错、CLI不识别、服务起不来等问题卡住超过十分钟——这通常是因为跳过了关键初始化环节，或在错误顺序下执行了绑定操作。
确认系统与基础工具链就绪
这一步必须最先做，否则后续所有操作都可能失败。QoderWake不是纯前端应用，它依赖底层运行时环境，缺一不可。
1、打开终端（Windows用PowerShell，macOS/Linux用默认Terminal），依次执行：node -v → npm -v → qodercli --version；若任一命令报“command not found”，说明对应组件未安装或未加入PATH。
2、【Node.js必须为v18.19.0或更高版本，npm不低于9.0.0】。低于此版本将触发SDK兼容性中断，导致Quest Mode无法加载技能，且错误日志中不会明确提示版本问题。
3、若node/npm已安装但qodercli缺失，直接执行curl -fsSL https://qoder.com/install | bash——该脚本会自动检测并补全CLI，无需手动配置PATH。
完成QoderWake核心安装
根据你的操作系统选择对应方式，三者互斥，不要混用。
方法一：npm全局安装（推荐给开发者）
执行npm install -g @qoder-ai/qoderwake，安装完成后运行qoderwake --version验证输出是否为0.3.5或更新版本。
方法二：curl脚本安装（macOS/Linux专用）
执行curl -fsSL https://qoder.com/install-wake | bash，脚本会自动下载二进制、设权限、写入/usr/local/bin/；安装后务必执行sudo chmod +x /usr/local/bin/qoderwake，否则权限不足会导致服务启动失败。
QoderWake Linux版是阿里推出的生产级数字员工系统，支持Linux环境部署。它作为7×24小时在线的AI员工，具备长期记忆与专业技能（如编程、运维），可自主响应代码审查、告警处理等事件。其核心采用“员工与工位分离”架构，并设置了严格的权限红线，确保持续进化的同时实现安全可控。
方法三：离线包部署（企业内网/无外网环境）
下载qoderwake-core-v1.3.0.tar.gz（SHA256校验值：a7f9b1e8c2d5f4a3b6c7e8d9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b），解压至/opt/qoder/，再运行/opt/qoder/core/bin/init-sandbox.sh初始化沙盒目录结构。
执行五步初始化设置
安装只是开始，以下五项必须按顺序完成，缺一不可。跳过任意一项，QoderWake将无法连接GitHub、无法保存记忆、无法执行真实操作。
第一步：授予文件与文件夹访问权限
打开系统设置→隐私与安全性→文件与文件夹→找到QoderWake→勾选全部文件夹，并额外启用下载文件夹与桌面。未启用下载文件夹将导致本地文档上传失败，且无明确报错提示。
第二步：绑定GitHub账户并启用长期记忆
启动QoderWake→点击右上角用户图标→「登录账户」→选择GitHub（不支持邮箱直登）→登录后进入「设置→记忆管理」→开启跨会话持久化记忆开关。脱离账户会导致所有历史任务上下文丢失，且无法恢复。
第三步：配置GitHub Connector
进入「设置→Connectors」→点击「+ 添加」→选择GitHub→按OAuth流程授权→确认勾选「Read all repositories」权限。未勾选此项，QoderWake将无法读取PR描述、Issue内容及代码变更，所有分析类Quest任务返回空结果。
第四步：加载默认权限红线策略集
进入「设置→权限红线」→点击「加载默认策略集」→确保「修改主干分支」、「删除数据库表」、「向客户群发送消息」三项处于启用状态→点击「保存并激活策略」。系统将自动重启Agent沙盒环境，此过程约需8秒，期间界面会短暂灰显。
第五步：执行Git仓库分析Quest任务闭环验证
在任意项目根目录下打开终端，执行qwake quest analyze-repo --auto-fix；若看到输出中包含「✅ Repo indexed」「✅ Vulnerabilities scanned」「✅ PR draft generated」三行标记，则表示全部模块已就绪。
