QoderWake定时任务未执行需防Mac休眠：一、终端执行sudo pmset -a sleep 0 displaysleep 0 disksleep 0；二、QoderWake偏好设置中启用“任务执行期间保持系统唤醒”；三、系统设置中禁用屏幕锁定并设睡眠为“永不”；四、部署CLI守护进程；五、新建截图测试任务验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已配置QoderWake定时任务，但发现任务在预期时间未执行或执行中断，则很可能是由于本地设备进入系统休眠、屏幕锁屏或硬盘休眠所致。以下是实现7×24小时全自动运行所必需的防睡眠配置步骤：
一、禁用系统级自动睡眠（pmset）
macOS系统默认会在闲置后触发深度睡眠，导致QoderWake进程被挂起、定时任务完全失效。必须通过终端命令强制关闭所有电源模式下的睡眠行为，确保后台服务持续活跃。
1、打开“终端”应用。
2、输入以下命令并按回车执行：sudo pmset -a sleep 0 displaysleep 0 disksleep 0
3、系统将提示输入管理员密码，输入后无反馈即表示设置成功。
4、验证设置是否生效：执行 pmset -g custom，确认输出中 sleep、displaysleep、disksleep 三项数值均为 0。
二、启用QoderWake内置保持唤醒功能
QoderWake客户端提供原生的系统唤醒保活机制，可主动阻止macOS进入休眠状态，且无需额外权限申请，与定时任务调度深度集成。
1、启动QoderWake桌面客户端。
2、点击左上角菜单栏中的「QoderWake」→「偏好设置」。
3、切换至「自动化」标签页。
4、勾选 “任务执行期间保持系统唤醒” 和 “定时任务触发前5分钟自动唤醒系统” 两项。
5、关闭偏好设置窗口，更改即时生效。
三、配置Mac屏幕锁定策略（系统设置）
即使系统不休眠，屏幕锁屏也会中断依赖GUI的自动化操作（如浏览器自动化、截图、macOS原生应用调用），导致定时任务中涉及界面交互的部分失败。
1、打开「系统设置」→「锁屏」。
2、将「启用屏幕锁定」设为 “从不”。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、在「需要密码以取消锁屏」选项中，选择 “立即” 或 “5秒后”，避免完全失去安全防护。
4、返回「系统设置」→「节能」→「电池」和「电源适配器」两个标签页，分别将「防止自动睡眠」滑块拖至最右端。
四、部署QoderWake CLI守护进程（Linux/macOS）
对于高级用户，可绕过图形界面依赖，以纯命令行方式部署QoderWake CLI作为系统级守护进程，彻底规避GUI锁屏影响，并支持开机自启与崩溃自动重启。
1、确保已安装QoderWake CLI，执行 qoderwake --version 验证版本不低于 v2.8.0。
2、创建守护服务文件：sudo nano /Library/LaunchDaemons/ai.qoder.wake.plist。
3、粘贴以下内容并保存：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>ai.qoder.wake</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/bin/qoderwake</string>
<string>daemon</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
</dict>
</plist>
4、加载服务：sudo launchctl load /Library/LaunchDaemons/ai.qoder.wake.plist。
5、启动服务：sudo launchctl start ai.qoder.wake。
五、验证防睡眠配置有效性
完成全部配置后，必须进行真实场景验证，确认系统在长时间闲置状态下仍能准时触发并完整执行定时任务，尤其关注含GUI操作的任务流是否中断。
1、在QoderWake中新建一条测试任务：名称为「防睡眠验证」，计划时间为2分钟后，任务内容为「打开Safari，访问https://qoder.ai，截图并保存到桌面」。
2、手动将Mac设为闲置状态：不触碰键盘鼠标，等待至任务触发前1分钟。
3、观察任务是否准时在侧栏生成新对话，且截图文件是否成功出现在桌面。
4、若截图失败，检查「屏幕锁定」设置及「Peekaboo」连接状态；若任务未生成，重新核查 pmset -g custom 输出与LaunchDaemon服务状态。
