qoderwake任务不执行需逐层排查：一、检查系统休眠（pmset -g custom确认sleep等为0，否则sudo pmset -a sleep 0 displaysleep 0 disksleep 0）；二、验证定时策略是否启用及cron格式正确（七字段，如0 30 1 *）；三、排查dns解析异常（grep日志关键词，刷新缓存并配置可信dns服务器）；四、检查配置目录权限（windows重置所有权与完全控制，macos/linux用chown/chmod修复）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake任务一直不执行，说明调度链路在某个环节被阻断——可能是系统休眠导致进程挂起、定时策略未激活、DNS解析失败使远程依赖不可达，或是配置目录权限被拦截引发初始化中断，必须逐层验证才能定位真实断点。
确认系统是否进入休眠或锁屏
Mac上任务看似“不执行”，大概率是系统自动休眠把QoderWake进程彻底冻结了，连后台守护线程都停摆，此时日志里看不到任何错误，只有时间戳突然中断。
打开“终端”，执行：pmset -g custom，检查输出中 sleep、displaysleep、disksleep 三项是否全为 0。
若任一值非零，立即执行：sudo pmset -a sleep 0 displaysleep 0 disksleep 0，输入管理员密码后无提示即生效。
这一步必须做，否则所有后续配置都是徒劳——QoderWake无法在深度睡眠中唤醒自己。
验证定时触发策略是否启用并校验Cron表达式
方法一：通过管理控制台检查
登录QoderWake管理控制台 → 进入「触发管理」→「定时触发」模块 → 查看目标计划右侧状态图标：绿色对勾表示已激活，灰色时钟表示已保存但未启用，红色叉号表示参数校验失败。
点击该计划右侧「编辑」→ 检查Cron字段是否符合七字段格式（秒 分 时 日 月 周 年），例如每天01:30执行应为 0 30 1 * * *；若填成六字段（如 0 30 1 * * ?）则会被静默忽略。
方法二：通过CLI快速验证
在终端中执行：qoderwake schedule list，观察输出中对应任务的 status 是否为 active，且 next_fire_time 是未来合理时间点。若显示 pending 或 invalid expression，说明表达式语法错误或时区未匹配。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
排查DNS解析异常导致远程依赖失效
第一步：确认日志中是否存在 DNS解析异常 或 UnknownHostException 提示
执行：qoderwake logs --tail 50 | grep -i "dns\|resolve\|host"，若有匹配行，说明任务卡在连接API网关或消息中间件阶段。
第二步：刷新本地DNS缓存
macOS执行：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
Linux执行：sudo systemd-resolve --flush-caches 或 sudo systemctl restart systemd-resolved
第三步：强制指定可信DNS服务器
编辑 config.yaml，在 network 节点下添加：dns-servers: ["223.5.5.5", "114.114.114.114"]，保存后执行 qoderwake restart。
检查配置目录读写权限是否被拦截
Windows用户请按 Win + R → 输入 shell:appdata → 进入 Roaming\QoderWake 文件夹 → 右键属性 → 安全 → 高级 → 更改所有者为当前用户 → 勾选“完全控制”并确保“应用到此文件夹、子文件夹和文件”。
【关键操作】若“完全控制”复选框灰色不可选，说明父目录禁用了权限继承——必须先点击左上角“禁用继承”，选择“将继承的权限转换为此对象的显式权限”，再重复赋权步骤。
macOS/Linux用户执行：sudo chown -R $USER:$USER ~/.config/qoderwake → 再执行：chmod -R u+rw,go+r ~/.config/qoderwake。
