Qoder 的模型调用链路默认被隐藏,控制台仅展示最终结果。实际调用的模型、请求状态、耗时、输入输出等关键信息,均深埋在结构化日志与 CLI 监控流中,需要主动挖掘。以下三步将教你如何获取完整的调用轨迹。
启用DEBUG日志以捕获完整模型调用链
Qoder 默认不记录模型请求的原始 payload、响应头、token 计数及路由决策。只有在 DEBUG 模式下,才能获取每一轮 LLM 调用的完整上下文。
第一步:在项目根目录下创建一个纯文本文件,命名为 qoder-debug.conf,并确保编码为 UTF-8 且不带 BOM 头。
第二步:写入以下两行关键配置,注意等号前后不能有空格:
log_level = debug
enable_trace_context = true
第三步:启动 Qoder CLI 时,务必显式加载此配置文件,命令为 qoder --config qoder-debug.conf。若忘记添加 --config 参数,则所有模型调用细节将不会输出,导致操作无效。
实时监听沙箱日志流,抓取模型请求快照
图形界面日志会过滤掉 HTTP 级别的细节,而模型调用中最关键的字段(如 model_id、input_tokens、output_tokens、latency_ms、status_code)仅出现在底层沙箱日志流中。
方法一:在终端中直接运行 qoderlog --follow --level=debug,该命令会立即连接沙箱日志管道并持续输出。
方法二:复现一次模型调用操作,例如在 AI Chat 中发送一条消息,或执行 /browser https://example.com。此时所有 DEBUG 级别的事件将实时刷新,重点留意包含 "event_type": "llm_call" 的 JSON 对象。其中的 model 字段标明实际调用的模型,latency_ms 表示真实耗时,response_status 为 HTTP 状态码。
按 Ctrl+C 终止监听后,日志会自动保存至 ~/.qoder/logs/latest.log,这是离线分析模型调用行为的唯一有效入口。
解析 runtime.log,定位失败调用与模型路由偏差
后台静默运行时,Qoder 会将每条模型调用日志记录为独立的 JSON 对象,每行一个。字段包含 model_id、prompt_truncated、fallback_reason、router_decision 等关键诊断信息。
1. 确认操作系统对应的日志路径:
- Linux/macOS 普通用户:
~/.qoder/logs/runtime.log - Windows 用户:
%APPDATA%\Qoder\logs\runtime.log - QoderWake 数字员工:
/var/log/qoderwake/agents/{agent_id}/runtime.log
2. 执行以下命令,精准提取所有模型调用记录:
jq 'select(.event_type == "llm_call") | {model: .model_id, latency: .latency_ms, status: .response_status, tokens_in: .input_tokens, tokens_out: .output_tokens}' ~/.qoder/logs/runtime.log
3. 如果发现大量 model_id 为空,或显示为 fallback-model,则表明模型路由规则未匹配成功。此时需检查 QODER_MODEL_ROUTER 环境变量,或 .qoder/router.yaml 配置文件是否生效。

