workbuddy服务频繁自动重启是健康检查机制正常触发的自恢复行为，源于claw心跳超时、webhook拦截、.net兼容性问题或安全软件误杀，需按五步调试定位根因。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装WorkBuddy后观察到服务频繁自动重启，这通常不是异常行为，而是由内置的健康检查与自恢复机制主动触发的响应动作。该机制通过心跳探测、状态反馈与可控重试策略维持Claw远程通道与本地Agent的可用性。以下是调试此现象的具体步骤：
一、确认健康检查是否处于活跃状态
WorkBuddy默认启用Claw心跳检测模块，每2–5秒向主线程发送ping消息，并要求Worker在3秒内返回pong响应；若超时即判定为失联并触发重启流程。该行为在首次安装后尤其明显，因本地缓存未建立或Webhook端点尚未完成注册。
1、启动WorkBuddy客户端，确保右下角系统托盘出现蓝色龙虾图标。
2、右键点击该图标，选择【打开主界面】。
3、点击底部工具栏中的【状态看板】按钮。
4、观察“Claw连接”项右侧是否出现脉动动画；若显示“断开”或持续闪烁，则说明健康检查已激活但尚未完成握手。
二、查看调试面板中的实时心跳日志
调试面板可直接暴露isAlive、lastError、restartCount等关键指标，用于判断重启是否由超时、模型服务不可达或Claw通道重建失败引发。
1、确保WorkBuddy主程序处于前台运行状态。
2、按下Ctrl + Shift + D（Windows/Linux）或 Cmd + Shift + D（macOS）组合键唤出调试面板。
3、在面板中查找含“ping”“pong”“timeout”“restart”字样的日志条目。
4、若存在连续多条“pong timeout after 3000ms”记录，则表明Worker线程未按时响应，需进入下一步排查。
三、检查Claw Webhook端点是否被拦截
Claw依赖动态生成的HTTPS Webhook URL接收企业微信指令；若该URL无法被公网IM服务器访问，或被本地防火墙/安全软件阻断，将导致心跳失败并反复触发重启。
1、进入WorkBuddy设置中心 → 【Claw集成】→ 【企微AIBot】页面。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、确认“Webhook URL”字段已生成非空值，格式为https://[随机字符串].claw.codebuddy.cn/xxx。
3、复制该URL，在手机企业微信中新建会话，向任意机器人发送测试消息“你好”。
4、返回电脑端，观察调试面板是否在5秒内输出“received webhook payload”日志；若无输出，检查Windows防火墙或macOS“完全磁盘访问”权限是否已授予WorkBuddy。
四、验证.NET运行时或系统兼容性问题
Worker线程崩溃常源于底层运行环境不匹配，例如.NET Desktop Runtime损坏、高DPI缩放干扰图形渲染线程，或新版Windows API调用失败。此类问题会导致主线程持续收不到pong，从而执行强制销毁与重试。
1、右键WorkBuddy.exe → 属性 → 兼容性选项卡 → 勾选以兼容模式运行这个程序（选择Windows 8）。
2、在同一窗口点击【更改高DPI设置】→ 勾选替代高DPI缩放行为 → 下拉选择应用程序。
3、关闭所有WorkBuddy进程，在PowerShell（管理员）中执行：Get-FileHash -Algorithm SHA256 .\WorkBuddy.exe，确认文件未被篡改。
4、卸载当前.NET 6.x桌面运行时，重新安装官方离线包并重启系统。
五、禁用第三方安全软件实时防护进行隔离验证
部分EDR工具或杀毒引擎会拦截Worker线程创建、内存映射或HTTP回调行为，误判为可疑活动并强制终止进程，造成“假性失联”并触发健康检查重启逻辑。
1、临时退出火绒、360、McAfee等安全软件主程序，非仅关闭通知弹窗。
2、在任务管理器详细信息页签中，确认无hrbmon.exe、360rp.exe等残留防护进程。
3、右键WorkBuddy.exe → 使用管理员身份运行。
4、观察调试面板中是否仍有“worker terminated unexpectedly”或“failed to create Worker”类错误；若消失，则需将WorkBuddy.exe及其安装目录添加至安全软件白名单。
