workbuddy v4.24升v5.0失败主因是残留隐藏标记文件（如\_、backup等）被误判为用户项目目录，需用dir /ah显示并shift+delete彻底清除；再结束所有workbuddy相关进程，最后以“为所有用户安装”方式覆盖安装v5.0。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy v4.24升级到v5.0时卡在“验证安装包”或直接弹出“应用安装目录存在用户项目目录”报错，根本不是版本冲突，而是升级程序误读了旧版残留的隐藏标记文件——这些文件肉眼不可见，但会触发强制中断。
确认并清除升级拦路虎
打开你的 WorkBuddy 安装目录（例如 D:\Apps\WorkBuddy），在文件资源管理器地址栏输入：【dir /ah】 → 回车。这会强制显示所有隐藏文件和文件夹。
重点查找名为 【_】（仅一个下划线）、【backup】、【old】、【backup_old】 的条目，全部选中 → Shift + Delete 永久删除（不进回收站）。
注意：不要只删 visible 文件夹，那个 【_】 文件夹是 v4.24 自动创建的运行时元数据缓存，v5.0 升级器把它当成用户项目目录误判——它通常只有 1KB 大小，却足以让整个升级流程终止。
彻底退出后台服务进程
按 Ctrl + Shift + Esc 打开任务管理器 → 切换到“详细信息”选项卡。
找到所有名称含 WorkBuddy 的进程：WorkBuddy.exe、WorkBuddy Service.exe、ClawService.exe —— 全部右键 → “结束任务”。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
若某个进程显示“访问被拒绝”，说明它已被系统策略锁定，此时必须重启电脑再操作，否则新安装包无法覆盖旧注册表项。
执行干净覆盖安装
第一步：从官网重新下载 v5.0 安装包（链接：https://www.php.cn/link/34a167480f1ee9328cf6f555ef1b7940），校验文件大小是否为 184.3 MB（v5.0 正式版精确值）。
第二步：双击安装包 → 在 UAC 提示中点击“是” → 安装向导出现后，【务必勾选“为所有用户安装”】 → 路径保持与 v4.24 完全一致（如 D:\Apps\WorkBuddy），不要点“浏览”修改。
第三步：安装完成前，取消勾选“开机自启”，等首次启动成功后再手动开启——避免因旧版服务残留导致 v5.0 初始化失败。
第四步：安装完毕，不要立刻点击“启动”，先关闭安装向导窗口，再手动双击桌面快捷方式启动。
