WorkBuddy调试模式启用及使用方法包括:一、图形界面启用(连点图标5次→选启用→重启);二、命令行注入参数(--debug-level=verbose等);三、技能卡片长按呼出调试面板查看结构化日志;四、设置中手动触发技能并注入JSON测试Payload启断点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您在使用WorkBuddy技能包时遇到功能异常、响应延迟或指令无反馈等问题,可能是由于技能逻辑未正确加载、上下文状态错乱或本地调试通道未启用所致。以下是启用并使用WorkBuddy调试模式的具体操作方法:
一、启用WorkBuddy调试模式
调试模式是WorkBuddy内置的诊断机制,开启后可实时输出技能执行日志、意图识别结果及变量快照,便于定位逻辑断点与数据异常。
1、确保设备已安装WorkBuddy最新客户端(v3.2.0及以上版本)。
2、进入App主界面,连续点击左上角应用图标5次,触发隐藏调试菜单。
3、在弹出的浮动窗口中选择“启用调试模式”,确认授权日志读写权限。
4、重启WorkBuddy应用,调试模式即生效,状态栏右上角将显示“DEBUG ON”标识。
二、通过命令行注入调试参数
适用于开发者在集成环境中快速切换调试级别,绕过图形界面限制,直接控制日志粒度与输出目标。
1、打开终端或命令提示符,进入WorkBuddy安装目录下的/bin子路径。
2、执行命令:./workbuddy --debug-level=verbose --log-output=console。
3、若需捕获完整技能链路,追加参数:--trace-skills=true。
4、启动后所有技能调用将同步输出至当前终端窗口,含时间戳、技能ID、输入Payload与返回状态码。
三、使用技能调试面板查看实时日志
调试面板提供结构化日志视图,支持按技能名称、执行耗时、错误类型进行筛选,避免在原始日志流中人工排查。
1、在已启用调试模式的WorkBuddy中,长按任意技能卡片3秒,呼出调试面板入口。
2、点击面板顶部的“日志流”标签页,系统自动连接本地调试代理端口(默认9091)。
3、在过滤栏输入技能包名称(如“meeting-scheduler-v2”),仅显示该包相关事件。
4、点击某条日志右侧的“展开详情”按钮,可查看上下文变量原始值与执行堆栈。
四、模拟输入触发技能断点调试
该方式允许在不依赖真实语音或UI交互的前提下,向指定技能注入预设输入,验证其内部条件分支与异常处理逻辑。
1、进入WorkBuddy设置 > 开发者选项 > 调试工具 > “手动触发技能”。
2、从下拉列表中选择目标技能包ID(格式为wb-skill-xxxxxx)。
3、在JSON输入框中粘贴测试Payload,例如:{"intent":"schedule_meeting","participants":["user@domain.com"]}。
4、勾选“启用断点”,点击发送,技能将在首个逻辑判断前暂停,等待调试器连接。










