WorkBuddy调试模式可通过五种方式启用：快捷键触发、启动参数、Claw设置、微信指令及编程模式强制调试，分别适用于实时日志查看、冷启动排查、本地日志归档、IM链路诊断和代码逐层追踪。
如果您在使用workbuddy过程中遇到指令响应异常、任务卡顿或提示词未生效等情况，可能需要启用调试模式以查看内部执行日志与步骤反馈。以下是进入并使用workbuddy调试模式的多种方法：
一、通过快捷键触发调试面板
该方法适用于桌面端Windows/macOS系统，可快速唤出实时日志窗口，用于观察当前任务的解析链路与模型调用状态。
1、确保WorkBuddy主程序正在运行且处于前台界面。
2、按下 Ctrl + Shift + D（Windows/Linux）或 Cmd + Shift + D（macOS）组合键。
3、调试面板将从界面右下角滑出，显示当前会话的Token消耗、步骤耗时、提示词注入节点及中间推理结果。
二、启动时附加调试参数
该方式可在程序初始化阶段即加载完整调试上下文，适用于排查冷启动失败、权限校验中断等底层问题。
1、关闭当前运行的WorkBuddy进程。
2、打开终端（Windows使用PowerShell/命令提示符，macOS/Linux使用Terminal）。
3、进入WorkBuddy安装目录，执行带参数的启动命令：./WorkBuddy --debug --log-level=verbose（macOS/Linux）或 WorkBuddy.exe --debug --log-level=verbose（Windows）。
4、程序启动后，控制台将滚动输出详细日志，包括文件读取路径、安全模式判定、Claw连接状态等原始信息。
三、在Claw设置中启用开发者日志
该方法不依赖外部终端，所有日志直接写入本地文件，便于后续归档分析或提交给技术支持团队。
1、点击WorkBuddy界面右上角的Claw设置图标。
2、在弹出菜单中选择“高级配置” → “开发者选项”。
3、勾选“启用完整执行日志”与“记录提示词模板渲染过程”两项。
4、重启WorkBuddy，日志文件将生成于%APPDATA%\WorkBuddy\logs\（Windows）或~/Library/Application Support/WorkBuddy/logs/（macOS）。
四、微信直连场景下的远程调试开关
当通过微信发送指令触发WorkBuddy执行时，需验证消息是否准确解析并转发至本地引擎，此模式专为IM链路诊断设计。
1、在微信中向已绑定的WorkBuddy客服号发送一条测试消息，内容为：/debug on。
2、WorkBuddy桌面端将自动弹出浮动通知，并在系统托盘显示“远程调试已激活”提示。
3、此后所有经微信发来的指令，其原始JSON payload、安全模式匹配结果、工作区路径解析过程均会在调试面板中高亮标出。
五、编程模式下强制进入调试上下文
在代码开发场景中，若需对某段特定提示词或代码补全请求进行逐层追踪，可利用编程模式专属调试入口。
1、切换WorkBuddy至“编程模式”（界面左下角模式切换按钮）。
2、在编辑器区域粘贴待调试的代码片段或自然语言需求描述。
3、按住Alt 键不放，再点击工具栏中的“运行”按钮。
4、界面将分割为左右两栏：左侧为原始输入与AST解析树，右侧为模型输出与代码执行沙箱反馈。
