workbuddy支持五种终端集成调试方式：一、claw协议直连dap调试器；二、命令行嵌入式repl会话；三、claw日志注入+grep捕获变量快照；四、画布“调试节点”导出json至终端；五、微信指令触发终端变量导出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy开发AI工作流或本地API集成时，需对执行逻辑进行逐行追踪、设置断点并实时查看变量状态，则可能是由于当前调试通道未连接终端环境、调试协议未启用或IDE插件未正确挂载所致。以下是将WorkBuddy与终端深度集成以支持断点调试与变量查看的多种方法：
一、通过Claw调试协议直连终端调试器
该方式利用WorkBuddy内置的Claw调试协议（基于DAP v1.68），允许外部终端调试器（如VS Code Debug Adapter或命令行lldb）建立会话连接，实现源码级断点命中与作用域变量展开。适用于需要在本地脚本、Python连接器或自定义节点中精确控制执行流的场景。
1、启动WorkBuddy Desktop，并确保状态栏显示DEBUG ON标识。
2、打开终端，执行命令：curl -X POST http://127.0.0.1:9091/debug/dap/start -H "Content-Type: application/json" -d '{"adapter":"python","port":5678}'，启动DAP服务并监听5678端口。
3、在VS Code中新建launch.json配置，填入以下内容：{"type":"cppdbg","request":"attach","name":"Attach to WorkBuddy DAP","processId":0,"port":5678}（注意：实际适配器类型依连接器语言而定）。
4、在目标Python连接器代码中插入breakpoint()或在VS Code编辑器左侧行号区域点击设置断点；触发技能后，终端调试器将在断点处暂停，并显示locals()中所有变量键值对。
二、在命令行中启用嵌入式REPL调试会话
该方式绕过图形界面，在终端中直接启动一个与当前WorkBuddy运行时共享上下文的交互式Python解释器（REPL），支持动态执行表达式、打印变量、修改局部状态，无需预设断点即可即时探查。
1、确保WorkBuddy已加载待调试的技能包，且AI工作流中至少有一个已注册的Python连接器节点。
2、打开终端，执行：./WorkBuddy --repl --connector-id wb-conn-custom-py（Windows用户用WorkBuddy.exe替代）。
3、等待输出提示：[REPL] Connected to connector context. Type 'vars()' to list current scope.
4、输入input_data查看传入参数字典；输入dir(__builtins__)检查可用内置函数；输入pprint(response_json)格式化打印响应体；输入exit()退出会话。
三、使用Claw日志注入+grep实时捕获变量快照
该方式不依赖调试器连接，而是通过强制Claw在关键执行节点注入结构化变量日志（JSON格式），再由终端实时过滤提取，适用于无GUI环境或容器化部署下的轻量级变量观测。
1、进入WorkBuddy设置 → Claw集成 → 高级配置，勾选“在每个节点执行前后注入变量快照”并保存。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、重启WorkBuddy，触发一次目标技能执行。
3、在终端中定位日志目录：tail -f %APPDATA%\WorkBuddy\logs\claw_debug.log（Windows）或tail -f ~/Library/Application\ Support/WorkBuddy/logs/claw_debug.log（macOS）。
4、执行过滤命令：grep -A 5 -B 2 '"node_id":"api-call-node-01"' | grep -E '(input|output|context)'，即可提取指定节点的完整变量快照片段。
四、在AI工作流画布中启用“调试节点”并导出变量至终端
该方式通过可视化操作在工作流中插入专用调试节点，其输出自动序列化为JSON并写入标准输出流，可被终端重定向捕获，适合非编程用户快速验证数据流转完整性。
1、打开AI工作流画布，在API调用节点后拖入一个“日志打印”节点（可在搜索框输入“debug”找到）。
2、双击该节点，在配置面板中勾选“输出全部变量到stdout”，并设置输出等级为VERBOSE。
3、保存工作流，然后在终端中执行：WorkBuddy.exe --run-skill skill-id-abc123 --log-level DEBUG 2>&1 | grep -E '\{.*\}'。
4、触发执行后，终端将直接打印出类似{"input":{"url":"http://localhost:8000/api"},"output":{"status":200,"data":[...]}}的结构化变量块。
五、通过微信指令触发终端变量导出模式
该方式专为IM链路调试设计，允许用户在微信中发送特定指令，使WorkBuddy立即采集当前活跃技能上下文的所有变量，并以纯文本格式推送至绑定终端的标准输出，实现跨设备即时变量回传。
1、在微信中向WorkBuddy客服号发送：/debug vars export terminal。
2、WorkBuddy桌面端弹出通知：“已激活终端变量导出模式”，同时系统托盘图标闪烁三次。
3、在任意终端窗口中执行：tail -f /dev/stdout | grep -E '^VARS:'（macOS/Linux）或使用PowerShell：Get-Content .\wb-terminal-vars.log -Wait | Select-String "VARS:"（Windows）。
4、再次在微信中发送任意触发该技能的自然语言指令（如“查询北京天气”），WorkBuddy将立即向终端输出：VARS: input_city=北京, connector_auth_token=xxxxxx, response_time_ms=342。
