必须启用模型调试模式来验证实际调用的模型服务、请求头及推理链路是否正确；通过debug panel查看模型元信息，或使用快捷键ctrl/cmd+shift+d唤出实时日志面板，亦可终端启动带参调试或在claw设置中启用模型专项日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在WorkBuddy中遇到模型切换后结果异常、提示词未生效、或AI响应与预期模型能力明显不符时，必须启用模型调试模式来验证当前实际调用的模型服务、请求头信息及推理链路是否正确。该模式不依赖外部工具，直接在客户端内展示底层模型元数据，是排查模型路由错误最快速有效的手段。
通过Debug Panel查看模型服务元信息
这是官方推荐的模型调试方式，无需重启、不改配置、不依赖终端，专为快速复核模型调用真实性而设。
第一步：点击WorkBuddy主界面右上角个人头像 → 进入「设置」→「开发者选项」。
第二步：找到「启用Debug Panel」开关并开启，【必须重启WorkBuddy才能使该设置生效】。
第三步：重启后，在任意聊天窗口执行一次模型切换（例如点击输入框右侧模型图标选GLM），再发送一条指令。
第四步：观察界面底部状态栏右侧——出现「Debug」按钮即表示面板已就绪，点击即可展开实时显示当前请求的模型服务地址、Response包头中的X-Model-ID字段、Token计费归属及推理耗时分布。
快捷键唤出实时日志调试面板
适用于Windows/macOS桌面端，用于同步观察模型切换瞬间的解析动作与Token分配变化，尤其适合对比不同模型在相同指令下的中间推理差异。
确保WorkBuddy主程序正在前台运行 → 按下Ctrl + Shift + D（Windows/Linux）或Cmd + Shift + D（macOS）。
腾讯云代码助手CodeBuddy旗下WorkBuddy 4.24.8版本正式发布。本版本重点修复了上下文压缩异常、冷加载时偶现历史消息丢失、任务停止卡死等问题，并深度优化了Windows沙箱(lightSandbox)的日志写入与误弹窗逻辑，提供更安全稳定的AI协作体验。
调试面板从右下角滑出后，立即检查「提示词注入节点」一栏是否显示新选模型名称；若仍显示旧模型，则说明切换未触发或被Auto模式覆盖。
注意：该面板仅显示当前会话日志，关闭后不保留，如需归档请配合Claw设置中的“启用完整执行日志”使用。
启动时强制加载模型级调试上下文
方法一：终端启动带参调试
关闭所有WorkBuddy进程 → 打开终端 → 进入安装目录 → 执行：
macOS/Linux：./WorkBuddy --debug --log-level=verbose --model-debug
Windows：WorkBuddy.exe --debug --log-level=verbose --model-debug
方法二：Claw设置中启用模型专项日志
点击右上角Claw设置图标 → 「高级配置」→「开发者选项」→ 勾选「记录模型路由决策过程」和「捕获LLM请求原始Payload」两项 → 重启应用。
日志生成路径与普通调试日志一致，但新增model_route.log和payload_dump.json两个文件，其中payload_dump.json可直接查看发送至模型服务的完整JSON请求体，含model字段值、system prompt哈希及temperature等关键参数。
