WorkBuddy生产环境报错定位需结合五种路径：一、启用内置错误上报并查日志；二、用Claw开启Inspector远程调试；三、解包.wbp提取Source Map反解源码；四、通过MCP Server日志联动分析；五、触发沙箱快照分析崩溃上下文。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy过程中遇到生产环境报错，但错误信息仅显示压缩代码位置或模糊堆栈，无法直接对应原始源码行，则问题很可能源于代码构建产物与源文件之间的映射缺失。WorkBuddy本身不内置传统前端Source Map解析服务，但其运行时依赖的底层技术栈（如Electron+Node.js+Webpack/Vite）与调试生态深度兼容，可通过外部诊断机制实现精准定位。以下是快速定位生产环境报错的多种可行路径：
一、启用WorkBuddy内置错误上报与上下文捕获
WorkBuddy桌面端在启动时默认激活轻量级错误捕获模块，可自动收集未处理异常的执行上下文（含触发指令、当前模型、操作文件路径、时间戳），并关联本地日志快照。该机制无需额外配置，但需确保首次运行时已授权日志访问权限。
1、打开WorkBuddy主界面右上角「设置」图标。
2、进入「隐私与安全」页签，确认「启用错误上下文自动上报」处于开启状态。
3、复现报错操作后，立即前往「帮助」→「查看本地日志」，定位以error_开头且时间戳匹配的日志文件。
4、在日志中查找包含triggered_by、executing_skill和local_path字段的JSON块，这些字段直接指向引发异常的具体技能包、调用参数及所操作的本地文件路径。
二、利用Claw远程调试通道接入Node.js Inspector
WorkBuddy桌面端基于Electron构建，其主进程与渲染进程均支持V8 Inspector协议。当报错发生在本地任务执行阶段（如文件读写、插件调用），可通过Claw远程控制台临时启用调试端口，使用Chrome DevTools或VS Code进行断点追踪。
1、在企业微信或QQ中向已绑定的WorkBuddy发送指令：/debug start --port 9229。
2、等待返回提示“Inspector activated on port 9229”，表示主进程调试服务已就绪。
3、在Chrome浏览器地址栏输入chrome://inspect，点击「Open dedicated DevTools for Node」。
4、在「Remote Target」列表中选择标有WorkBuddy Main Process的条目，即可查看实时调用栈与变量作用域。
5、复现报错流程，异常将直接中断于原始TypeScript源码位置（非编译后JS），且显示完整文件路径与行号。
三、提取并反解WorkBuddy技能包Source Map
WorkBuddy加载的第三方OpenClaw技能包（.wbp格式）在发布时默认内嵌Source Map数据。当报错源自某项具体技能（如“自动生成会议纪要”失败），可解包后提取映射文件，结合错误中的列偏移还原原始逻辑。
1、进入WorkBuddy安装目录下的skills/子文件夹，找到报错技能对应的.wbp文件（如meeting_summary.wbp）。
2、使用任意ZIP解压工具打开该文件（.wbp为ZIP封装格式），定位内部dist/main.js.map文件。
3、将main.js.map复制至本地工作目录，并安装反解工具：npm install --global reverse-sourcemap。
4、执行命令：reverse-sourcemap -v main.js.map -o sourcecode，生成可读源码树。
5、根据错误日志中提示的main.js:line:column，在sourcecode/目录中对应文件的指定行列处，直接查看未经混淆的原始TypeScript函数体与注释。
四、通过MCP Server日志联动定位
WorkBuddy在调用外部模型或执行高危操作（如文件写入、系统命令）时，会通过本地MCP（Model Control Protocol）Server中转请求。该Server独立运行于http://127.0.0.1:8081，其访问日志完整记录每条指令的输入输出、响应状态码及耗时，是排查模型侧或系统侧故障的第一手依据。
1、确保WorkBuddy处于运行状态，打开终端执行：curl http://127.0.0.1:8081/logs/tail?lines=100。
2、在返回的JSON日志流中筛选"status":500或"error":true的条目。
3、提取该条目中的request_id字段值（如req_abc123）。
4、再次请求：curl "http://127.0.0.1:8081/logs/detail?request_id=req_abc123"，获取完整上下文。
5、检查backend_error字段内容，若包含"ENOENT"或"EACCES"，则明确指向文件不存在或权限不足；若含"model_timeout"，则需调整MCP Server的timeout配置。
五、触发WorkBuddy安全沙箱快照分析
WorkBuddy所有任务均在隔离沙箱中执行，当发生未预期崩溃时，会自动生成内存快照（.heapsnapshot）与执行轨迹（.trace）。该机制专为定位C++扩展层或Node.js原生模块异常设计，适用于极少数导致整个进程退出的严重错误。
1、在报错发生后10秒内，立即按下快捷键Ctrl+Shift+I（Windows/Linux）或Cmd+Option+I（macOS）打开开发者工具。
2、切换至「Memory」面板，点击「Take Heap Snapshot」按钮。
3、在快照列表中，选择最新生成的、标注为SandboxCrash_YYYYMMDD_HHMMSS的条目。
4、在左侧分类树中展开「Detached DOM tree」或「Native Objects」节点。
5、查找带有workbuddy::sandbox::前缀的对象，其属性中包含的last_executed_file与pending_op值，即为崩溃前最后尝试加载的文件与挂起的操作指令。
