qoder隐藏bug定位需启用debug日志、cli实时抓取、wiki日志索引解析、knowledge engine模式匹配及自定义hook捕获。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder开发过程中遇到功能异常、响应延迟或行为不符合预期，但控制台未抛出明显错误，则可能是由于隐藏的运行时日志信息未被及时捕获。以下是快速定位此类隐藏BUG的进阶技巧：
一、启用Qoder内置日志增强模式
Qoder默认日志级别为INFO，部分调试级细节（如变量快照、Agent决策链路、工具调用耗时）需手动开启VERBOSE或DEBUG模式才能输出。该模式可暴露AI Agent内部执行路径中的逻辑断点与上下文偏差。
1、在Qoder IDE右下角状态栏点击模型名称旁的齿轮图标，打开设置面板。
2、进入【Advanced Logging】选项卡，将日志级别下拉菜单切换至DEBUG。
3、勾选【Enable Agent Execution Trace】与【Log Tool Invocation Details】两项。
4、重启当前Quest会话或新建一个Ask Mode对话以使配置生效。
二、使用CLI命令实时抓取沙箱环境日志
当问题复现于Qoder CLI或devcontainer沙箱中时，图形界面日志可能被截断或异步刷新。直接调用底层日志流可获取完整原始输出，尤其适用于Socket.io连接抖动、MCP协议握手失败等底层通信类BUG。
1、在终端中执行qoder log --follow --level=debug启动实时日志监听。
2、复现问题操作（例如触发一次Quest任务或调用/browser智能体）。
3、观察日志中是否出现[MCP-ERROR]、[TOOL-TIMEOUT]或[CONTEXT-TRUNCATED]等标记字段。
4、按Ctrl+C停止监听，日志将自动保存至~/.qoder/logs/latest.log供离线分析。
三、解析Repo Wiki自动生成的日志索引
Qoder Teams版本会在每次Quest执行后，基于代码变更与Agent反馈自动生成结构化日志摘要，并同步至项目级Repo Wiki。该索引将非结构化日志映射为可检索的事件节点，便于跨时间维度比对同类BUG的复现条件。
1、在Qoder IDE左侧导航栏点击Wiki图标，进入当前仓库的Wiki视图。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、展开【Execution Logs】目录，查找最近一次失败任务对应的时间戳子目录。
3、打开其中的trace_summary.json文件，重点关注"critical_path"与"context_mismatch_nodes"字段。
4、若发现某次代码生成步骤的"confidence_score"低于0.65，说明该环节AI理解存在显著偏差，应优先审查输入提示词。
四、结合Knowledge Engine回溯历史相似日志模式
Qoder的知识引擎会持续学习用户项目中的错误模式，并建立日志特征指纹库。当新日志片段与历史指纹匹配度超过阈值时，系统将自动关联过往修复方案，跳过重复排查过程。
1、在任意代码文件中右键，选择【Qoder → Analyze Context with Knowledge Engine】。
2、在弹出的分析窗口中粘贴当前控制台报错片段或关键日志行。
3、等待约3秒，查看右侧是否出现"Matched Historical Pattern #QD-7823"提示。
4、点击该提示，系统将高亮显示此前已验证有效的修复代码块及对应日志上下文范围。
五、注入自定义hook捕获隐蔽执行分支
对于Hook机制支持的Qoder版本（v0.11.0+），可在Agent执行关键节点插入轻量级日志钩子，捕获标准日志管道外的中间态数据，例如pretooluse阶段的参数预处理结果或posttoolusefailure中的原始异常堆栈。
1、在项目根目录创建.qoder/hooks/log_context.py文件。
2、写入以下内容：def pretooluse(context): print(f"[HOOK] Tool '{context.tool_name}' called with: {context.input_params}")。
3、在Qoder设置中启用【Custom Hook Injection】并指定该文件路径。
4、触发一次涉及外部工具调用的操作（如/browser或/code-review），观察终端是否输出带[HOOOK]前缀的调试行。
