WorkBuddy异常时应按五步自检：一查客户端版本与进程状态；二测网络连通性及服务健康；三清认证缓存并扫码重登；四用curl直连API验证服务层；五关防火墙、放行进程并校准系统时间。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy时遇到响应延迟、指令无反馈、登录失败或连接中断等异常现象，则可能是由于客户端配置异常、网络链路波动或服务端瞬时过载所致。以下是针对WorkBuddy开展本地化故障自检的操作汇总：
一、验证客户端基础状态
该步骤用于确认本地运行环境是否满足最低兼容要求，排除因版本错配或运行冲突导致的功能失效。
1、打开WorkBuddy客户端，点击右上角“设置”图标，进入“关于”页面，核对当前版本号是否为v1.3.7或更高版本；
2、在“关于”页面中点击“检查更新”，若提示“已是最新版本”则跳过升级，否则完成强制更新并重启应用；
3、关闭企业微信与WorkBuddy的协同插件（如已启用），单独启动WorkBuddy进行纯客户端模式测试；
4、在Windows系统中，通过任务管理器查看“WorkBuddy.exe”进程CPU占用是否持续高于95%，若存在则结束进程后以管理员身份重新运行。
二、检测本地网络连通性与路由路径
此方法聚焦于识别客户端至WorkBuddy服务端之间的网络可达性问题，尤其适用于提示“连接超时”或“无法建立会话”的场景。
1、在命令提示符中执行ping workbuddy.code.qq.com -n 5，观察是否全部丢包；
2、若ping不通，继续执行tracert workbuddy.code.qq.com，定位中断节点是否出现在本地网关、运营商骨干网或腾讯云接入层；
3、在浏览器地址栏直接访问https://workbuddy.code.qq.com/health，确认返回HTTP 200及JSON格式的{"status":"ok","region":"shenzhen"}类响应；
4、禁用所有代理软件（含系统代理、Clash、Surge等），将网络设置还原为“自动检测设置”，重试连接。
三、重置认证凭据与会话缓存
该操作可清除因Token过期、设备绑定冲突或SSO票据异常引发的身份校验失败，适用于“登录后立即退出”或“反复要求扫码”的情况。
1、在WorkBuddy主界面左下角点击“账号管理”，选择“退出当前账号”；
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
2、进入电脑文件系统，手动删除以下两个目录：%APPDATA%\Tencent\WorkBuddy\auth_cache 与 %LOCALAPPDATA%\Tencent\WorkBuddy\token_store；
3、重启WorkBuddy，使用企业微信“扫码登录”方式重新绑定，避免输入账号密码直连；
4、登录成功后，在设置中开启“记住设备”选项，并确认设备名称未与其他终端重复。
四、绕过企业微信通道直连调试
当企业微信集成模块出现兼容性异常时，可通过独立HTTP接口验证WorkBuddy核心服务能力是否正常，隔离IM层干扰。
1、确保已安装curl工具，或使用Postman新建POST请求；
2、向地址https://api.workbuddy.code.qq.com/v1/debug/ping发送空JSON体（{}）请求，Header中添加Authorization: Bearer [您的有效Token]；
3、若返回{"code":0,"msg":"pong","server_time":1741772580}，表明服务端逻辑层可用；
4、若返回401错误，说明Token已失效，需返回步骤三重新获取；若返回502/504，则表明CDN或负载均衡层存在转发异常。
五、检查本地防火墙与安全软件拦截行为
部分终端安全策略会主动阻断WorkBuddy的TLS 1.3握手或UDP打洞行为，导致长连接维持失败或指令下发延迟。
1、临时关闭Windows Defender防火墙：在“高级安全Windows Defender防火墙”中点击“启用或关闭防火墙”，选择“关闭”；
2、在第三方安全软件（如火绒、360）的“网络防护”模块中，查找“WorkBuddy.exe”进程并设为“信任”或“放行”；
3、检查系统时间是否准确：若本地时间偏差超过5分钟，会导致JWT Token签名验证失败，需同步Internet时间服务器；
4、在PowerShell中执行Get-NetFirewallApplicationFilter | Where-Object {$_.Program -like "*WorkBuddy*"} | Remove-NetFirewallApplicationFilter -Confirm:$false，彻底清除残留规则。
