自动更新检查失败时，需先测试auth.codebuddy.cn连通性；若超时或403，说明防火墙/代理拦截，应加白名单或临时关防火墙；安装卡住则需管理员权限运行并确保英文无空格路径；更新后功能异常须执行--force-reinstall-core重装核心模块。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
自动更新检查失败：检查更新按钮无响应或报错
WorkBuddy 的自动更新依赖客户端内置的 HTTP 客户端向 auth.codebuddy.cn 发起版本比对请求，若按钮点击后无反应、卡在“正在检查”或弹出网络错误，大概率是系统级代理或防火墙拦截了该域名。Windows Defender 防火墙、企业级终端管控软件（如 360EDR、深信服EDR）常会静默阻止非浏览器进程访问认证域名。
实操建议：
- 先在 PowerShell 中手动测试连通性：
curl -Uri "https://auth.codebuddy.cn/api/v1/version?os=win" -Method Get，若返回 403 或超时，说明网络策略已生效 - 临时关闭 Windows Defender 防火墙（仅用于验证）：
Set-NetFirewallProfile -Profile Domain,Private,Public -Enabled False - 若企业环境不允许关防火墙，需联系 IT 部门将
auth.codebuddy.cn加入出站白名单，并确保 TLS 1.2+ 协议被允许 - 不要依赖 IE 兼容性模式或旧版 .NET Framework —— WorkBuddy v2026.03+ 已弃用
WebClient，改用基于HttpClient的现代栈，不兼容 Windows 7 或未打 KB4480970 补丁的 Win10 系统
更新下载完成但安装卡在“准备中”
该现象多见于非管理员权限启动的客户端，或安装路径含中文/空格/特殊符号（如 C:\Program Files (x86)\WorkBuddy）。静默安装器（WorkBuddySetup.exe /S）需要写入系统级注册表项和 %ProgramFiles% 下的文件，普通用户权限下会降级为用户目录安装，但自动更新流程未做此适配，导致升级包解压后找不到目标进程句柄，无法热替换主程序。
windows-shell-syntax
下载
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
实操建议：
- 右键 WorkBuddy 快捷方式 →「以管理员身份运行」后再点「检查更新」
- 确认当前安装路径是否为默认值；若曾自定义到
D:\我的工具\WorkBuddy，建议卸载后重装至纯英文无空格路径（如D:\WorkBuddy） - 任务管理器中结束所有
WorkBuddy.exe进程（包括后台服务WorkBuddy.Service.exe），再触发更新 - 若仍失败，直接走手动覆盖安装流程：从
https://workbuddy.tencent.com/download下载最新WorkBuddySetup.exe，双击运行并勾选「覆盖安装」
更新后功能异常：微信直连图标灰显、Claw 设置页空白
这不是更新失败，而是本地缓存模块与新版协议不兼容所致。v2026.03.12 起，Claw 模块引入 MCP 协议协商机制，旧版 claw_core.dll 无法加载新签名证书，导致初始化中断。此时界面看似正常，但远程控制链路实际已断开。
实操建议：
- 以管理员身份打开 PowerShell，执行：
workbuddy --force-reinstall-core（注意不是--reinstall，后者会清空全部配置） - 等待输出
Core module reinstalled successfully后，再执行：workbuddy --reset-config（仅重置运行时配置，保留技能路径和任务历史） - 重启客户端，进入「Claw 设置」→「企业微信」重新填入 Token 和 Encoding-AESKey —— 不要复用旧值，新内核会生成新密钥对
- 切勿手动删除
%APPDATA%\WorkBuddy\cache\下文件，该目录含加密凭证，误删会导致需重新登录
--force-reinstall-core 显式驱动。
