qoder调试需四步：启用debug模式（创建qoder-debug.conf并指定配置）、实时抓取沙箱日志（qoderlog --follow）、验证插件稳定性（检查扩展主机日志）、确认lingma服务运行并启用debug构建（切换配置、加-g/-zi、禁用优化）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder运行异常时控制台可能不报错，但Quest执行卡住、Agent决策中断或工具调用静默失败，问题根源往往藏在未被主动提取的操作日志、冲突插件、服务进程状态或调试符号缺失中——这些环节任一失效都会导致行为不可预测。
启用DEBUG模式获取完整执行链路
第一步：在项目根目录创建名为【qoder-debug.conf】的纯文本文件，确保编码为UTF-8且无BOM头。
第二步：向该文件写入两行内容，等号前后绝对不能有空格：
log_level = debug
enable_trace_context = true
第三步：启动Qoder CLI时必须显式加载该配置，命令为qoder --config qoder-debug.conf。若遗漏--config参数，DEBUG日志将完全不输出。
实时抓取沙箱环境原始日志流
方法一：终端中直接运行qoderlog --follow --level=debug，该命令会立即连接沙箱日志管道并持续输出。
方法二：复现问题操作（例如点击“执行Quest”按钮或输入/browser指令），此时所有DEBUG级事件将实时刷出，重点盯住[MCP-ERROR]、[TOOL-TIMEOUT]、[CONTEXT-TRUNCATED]三类标记字段。
按Ctrl+C终止监听后，日志自动保存至【~/.qoder/logs/latest.log】，该路径为离线分析唯一有效入口。
验证插件是否引发崩溃
第一步：进入VSCode，按Ctrl+Shift+P打开命令面板，运行Developer: Open Extension Host Log。
第二步：滚动至日志末尾，查找包含ERROR或ERR!的行，重点关注路径中出现的插件标识符，例如：/Users/xxx/.vscode/extensions/qoder.cn-1.8.2/dist/extension.js:456。
第三步：若发现某插件路径反复出现在错误堆栈顶部，立即禁用该扩展并重启Qoder验证是否恢复稳定。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
检查Lingma服务进程是否存活
1、打开任务管理器（Windows）或活动监视器（macOS），搜索进程名“Lingma”或“qoder”。
2、若未发现该进程，进入目录：
Windows：C:\Users\[用户名]\AppData\Local\.lingma\bin\x.x.x\CPU架构_64_系统\
macOS：~/.lingma/bin/x.x.x/CPU架构_64_系统/
3、双击执行Lingma.exe start（Windows）或终端中运行./Lingma start（macOS）。
4、等待命令行输出Service started on http://127.0.0.1:xxxx，确认端口监听已就绪。
启用Debug构建并加载调试符号
Qoder默认以Release模式运行，会剥离调试信息与符号表，导致断点无法命中、变量不可见。必须切换至Debug构建配置，才能支持源码级单步追踪。
① 在Qoder IDE左侧项目导航栏右键点击项目名称，选择【Properties】。
② 进入【Build Settings】→【Configuration】，将Active build configuration切换为Debug。
③ 在【Compiler Flags】中确认已启用-g参数（Linux/macOS）或/Zi（Windows），并禁用-O2及以上优化等级。
④ 点击【Apply】后执行Clean & Rebuild，确保生成的可执行文件包含完整调试元数据。
