qoderwake 无法启动需依次检查系统兼容性、安装 cli 工具（npm 全局安装或 curl 脚本）、windows 独立二进制安装，最后完成 login 绑定与 service install 启动服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在本地环境中启用 QoderWake 功能，但无法正常启动唤醒服务，则可能是由于系统环境未就绪、依赖缺失或 CLI 工具未正确配置所致。以下是解决此问题的步骤：
一、确认系统兼容性与前置条件
QoderWake 是 Qoder 平台提供的轻量级本地唤醒服务组件，用于在桌面端快速触发 AI 编程助手响应，其运行依赖基础运行时环境与网络连通性。需确保操作系统、架构及必要工具链已满足最低要求。
1、检查操作系统版本：Windows 10 或 Windows 11（22H2 及以上），macOS 13 Ventura 或更高版本，Linux 发行版需支持 systemd（如 Ubuntu 22.04+、Debian 12+）。
2、确认 CPU 架构：x86_64（amd64）或 ARM64（aarch64），不支持 32 位系统。
3、验证是否已安装 Node.js v18.19.0 或更高版本：在终端中执行 node -v，输出应为 v18.19.0 或更新版本。
4、验证 npm 是否可用：执行 npm -v，输出应不低于 9.0.0。
二、通过 npm 全局安装 QoderWake CLI
该方式适用于所有支持 Node.js 的平台，安装包由官方 NPM 仓库提供，具备跨平台一致性与版本可控性。
1、打开终端（Windows 使用 PowerShell 或 Windows Terminal；macOS/Linux 使用默认终端）。
2、执行全局安装命令：npm install -g @qoder-ai/qoderwake。
3、等待安装完成，过程中若出现权限错误（如 EACCES），请改用 sudo npm install -g @qoder-ai/qoderwake（macOS/Linux）或以管理员身份运行 PowerShell（Windows）。
4、验证安装结果：执行 qoderwake --version，成功将返回类似 0.3.5 的版本号。
三、通过 curl 脚本安装（Linux/macOS 专用）
该方式绕过 npm 生态，直接下载预编译二进制并部署至系统路径，适合无 Node.js 环境或需最小化依赖的场景。
1、在终端中执行安装脚本：curl -fsSL https://qoder.com/install-wake | bash。
将提醒同步至 Windows/Outlook 日历。用户提及「提醒我」「设置提醒」「加到日历」「同步到日历」「日程」「calendar」「日历」时触发。支持Microsoft Graph API 设备代码流认证，无需 Web 服务器，直接写入用户 Outlook 日历。
2、脚本将自动检测系统类型、下载对应架构的二进制文件，并将其复制至 /usr/local/bin/（需 sudo 权限）。
3、安装完成后，执行 sudo chmod +x /usr/local/bin/qoderwake 确保可执行权限。
4、运行 qoderwake --help 查看可用子命令，确认二进制已就绪。
四、Windows 独立二进制安装（无 Node.js 环境）
针对未安装 Node.js 的 Windows 用户，可直接下载官方签名的 .exe 文件，避免依赖冲突与构建过程。
1、访问 https://qoder.com/releases/qoderwake 页面，选择最新版本下的 qoderwake-v0.3.5-windows-amd64.exe 或 qoderwake-v0.3.5-windows-arm64.exe（根据设备芯片匹配）。
2、将下载文件重命名为 qoderwake.exe，并移至系统路径目录，例如 C:\Windows\System32\ 或用户自定义的 C:\tools\（后者需将该路径加入系统环境变量 PATH）。
3、以管理员身份打开 PowerShell，执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 以允许本地脚本执行。
4、运行 qoderwake --version 验证安装状态。
五、启动并注册 QoderWake 服务
QoderWake 默认以守护进程方式运行，需完成首次登录绑定与系统服务注册，方可实现开机自启与后台监听。
1、在终端中执行 qoderwake login，系统将输出一个授权 URL。
2、复制该 URL，在已登录 Qoder 账号的浏览器中打开，点击“同意授权”完成绑定。
3、执行 qoderwake service install 注册系统服务（Windows 自动创建 Windows Service；macOS 创建 launchd plist；Linux 创建 systemd unit）。
4、启动服务：qoderwake service start，随后可通过 qoderwake status 查看运行状态。
