qoderwake任务失败需通过agent_id定位独立日志路径，用tail和jq精准提取task_failed事件及fallback_reason、decision_boundary等关键字段分析根因。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake自动化任务执行失败后，控制台只显示“任务中断”或空白状态，根本看不出哪里卡住、为什么跳过、是否权限不足——这种黑盒式失败必须从日志底层抓取真实事件链，否则永远在猜。
定位对应任务的日志文件路径
每个数字员工有独立日志路径，不能直接翻 runtime.log 总文件；必须先确认 agent_id，再进对应子目录。否则你看到的可能是其他员工的历史记录，完全对不上当前任务。
登录部署 QoderWake Agent 的服务器或容器实例。
执行命令 ls -l /var/log/qoderwake/agents/ 查看当前激活的数字员工 ID 列表。
找到与你失败任务匹配的 agent_id（例如 dp-7f3a9b21），【注意：ID 中带 hyphen 且含字母数字混合，不要复制错斜杠或漏字符】。
拼出完整路径：/var/log/qoderwake/agents/dp-7f3a9b21/runtime.log。
提取失败任务的关键日志片段
直接打开整个 runtime.log 文件会淹没在千行日志里，必须用时间+事件双维度快速切片。
第一步：用 tail 定位最近 200 行 → tail -n 200 /var/log/qoderwake/agents/dp-7f3a9b21/runtime.log。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
第二步：从中找包含 "event_type": "task_failed" 或 "fallback_reason" 的 JSON 行，这类行就是失败锚点。
第三步：把这行复制出来，用在线 JSON 格式化工具粘贴解析，重点盯三个字段：decision_boundary、fallback_reason、call_stack 数组最后一项。
如果 decision_boundary 是 halt_on_write_prod 但没出现 human_approval_granted:true，说明任务因生产写入红线被主动终止，不是代码错误；如果 fallback_reason 是 "unhandled_state_transition"，那问题出在状态机逻辑缺覆盖，得回看工作流图谱。
用 jq 精准过滤失败根因
方法一：查所有未处理的状态跳转 → jq 'select(.fallback_reason == "unhandled_state_transition")' /var/log/qoderwake/agents/dp-7f3a9b21/runtime.log。
方法二：查所有因权限中断的任务 → jq 'select(.decision_boundary | contains("halt_on"))' /var/log/qoderwake/agents/dp-7f3a9b21/runtime.log。
方法三：查最近一次失败的完整上下文 → jq 'select(.event_type == "task_failed") | .input_context_hash, .call_stack[-2:], .decision_boundary' /var/log/qoderwake/agents/dp-7f3a9b21/runtime.log | tail -n 3。
这一步输出的结果可以直接拿去复现环境比对，【input_context_hash 必须原样复制，大小写和符号一个都不能改】。
