qoder日志提取有五种方法：一、启用debug模式，创建qoder-debug.conf并配置log_level与enable_trace_context；二、用qoderlog --follow实时抓取沙箱日志；三、检查默认json lines日志路径并用tail/jq分析；四、开启knowledge engine模式匹配识别语义异常；五、通过自定义hook捕获特定节点日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 过程中遇到功能异常、响应延迟或行为不符合预期，但控制台未抛出明显错误，则可能是由于后台运行日志未被主动提取或未启用足够粒度的输出。以下是提取 Qoder 运行日志的多种实操路径：
一、启用 Qoder 内置 DEBUG 日志通道
Qoder 默认仅输出 INFO 级别日志，关键执行路径（如上下文解析、规则匹配、Agent 决策链路）需显式激活 DEBUG 模式才能暴露中间状态。该通道是定位逻辑断点与上下文偏差的首要入口。
1、在项目根目录创建名为 qoder-debug.conf 的配置文件。
2、向该文件写入以下两行内容：
log_level = debug
enable_trace_context = true
3、启动 Qoder CLI 时添加 --config qoder-debug.conf 参数，确保配置被加载。
二、通过 CLI 命令实时抓取沙箱环境日志
当问题复现于 Qoder CLI 或 devcontainer 沙箱中时，图形界面日志可能被截断或异步刷新。直接调用底层日志流可获取完整原始输出，尤其适用于 Socket.io 连接抖动、MCP 协议握手失败等底层通信类问题。
1、在终端中执行 qoderlog --follow --level=debug 启动实时日志监听。
2、复现问题操作（例如触发一次 Quest 任务或调用 /browser 智能体）。
3、观察日志中是否出现 [MCP-ERROR]、[TOOL-TIMEOUT] 或 [CONTEXT-TRUNCATED] 等标记字段。
4、按 Ctrl+C 停止监听，日志将自动保存至 ~/.qoder/logs/latest.log 供离线分析。
三、检查默认日志文件路径并读取结构化内容
Qoder 在后台静默运行时，默认将结构化日志写入预设路径，每条日志为 JSON Lines 格式，包含时间戳、身份标识、事件类型、调用栈快照及决策红线触发标记，可被标准日志工具直接消费。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
1、确认当前运行用户身份（如普通用户或 systemd 服务账户）。
2、根据操作系统查找对应路径：
~/.qoder/logs/runtime.log（Linux/macOS 普通用户）
%APPDATA%\Qoder\logs\runtime.log（Windows 用户）
/var/log/qoder/agents/{agent_id}/runtime.log（QoderWake 数字员工沙盒）
3、使用 tail -n 200 或 jq 工具读取并过滤关键字段，例如：
jq 'select(.event_type == "tool_invocation" and .status == "failed")' ~/.qoder/logs/runtime.log
四、启用 Knowledge Engine 模式匹配捕获隐藏日志信号
Qoder 的 Knowledge Engine 可在运行时自动识别日志流中的语义异常模式（如重复 fallback、上下文哈希突变、决策边界越界），无需人工扫描，直接高亮潜在逻辑漏洞线索。
1、在 Qoder IDE 右下角状态栏点击模型名称旁的齿轮图标，打开设置面板。
2、进入【Knowledge Engine】选项卡，勾选 Enable Log Pattern Matching。
3、在【Pattern Library】中启用预置规则集：unhandled_state_transition、context_hash_mismatch、fallback_loop_detected。
4、触发一次任务后，点击【View Matched Logs】按钮，系统将列出所有命中规则的日志片段及关联 trace_id。
五、使用自定义 hook 捕获特定执行节点日志
Qoder CN v0.11.0 起支持在 Agent 执行流的关键节点插入自定义 hook，可精准注入调试日志，覆盖用户提交、工具调用前后、执行失败及终止等场景，避免全局日志泛滥。
1、在项目中创建 hooks/log_on_tool_failure.py 文件，内容包含：def post_tool_use_failure(context, tool_name, error): qCDebug(hook)
2、在 Qoder IDE 的【Settings → Hooks】中注册该文件路径，并启用 PostToolUseFailure 事件绑定。
3、重启当前 Quest 会话，后续工具调用失败时，日志将自动附加 [HOOK] 前缀标记并输出至 runtime.log。
