workbuddy v4.24 在 windows 10/11 安装失败、闪退或白屏，需严格满足系统版本（win10 2004+/win11 22000+）、64位x64架构，关闭杀软，官网下载，uac确认、纯英文路径安装、全选项勾选、防火墙双网络放行，并首次启动后授权桌面和文档文件夹访问权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy v4.24 在 Windows 10/11 上安装失败、闪退、启动白屏或防火墙拦截，不是软件问题，而是系统权限、运行环境或操作路径被卡在了某个具体环节——本文只讲此刻能立刻生效的安装动作，不绕弯、不铺垫、不讲原理。
确认系统硬性门槛
按 Win + R 输入 winver 回车，核对版本号：必须为 Windows 10 版本 2004（19041）或更高，或 Windows 11 任何正式版（22000 及以上）。低于此版本的系统（如 Win10 1809、精简版 Ghost 系统、ARM64 设备）直接无法运行安装包，不会报错，只会双击无反应。
右键“此电脑”→“属性”，确认“系统类型”为 64 位操作系统，x64 基于处理器。ARM64 架构（如 Surface Pro X 默认系统）暂未通过兼容性验证，强行安装后主界面白屏且无法恢复。
下载与安装前强制准备
关闭所有杀毒软件（360、火绒、腾讯电脑管家等）及 Windows Defender 实时保护——它们会静默拦截 WorkBuddySetup.exe 的注册表写入和进程注入，导致安装中途退出，桌面无图标，且无错误提示。
访问唯一安全入口：https://www.php.cn/link/34a167480f1ee9328cf6f555ef1b7940，让网页自动识别系统并下载 WorkBuddySetup.exe（约 172MB）。切勿使用第三方下载站、网盘链接或搜索引擎广告推广的安装包，v4.24 存在校验机制，非官网包会在启动时弹出「签名无效」并终止。
Windows 安装四步执行链
第一步：双击 WorkBuddySetup.exe → 弹出「用户账户控制（UAC）」窗口 → 发布者必须显示为 Tencent Technology (Shenzhen) Company Limited → 点击「是」。
若点「否」或误关窗口，安装将静默失败，任务管理器里看不到进程残留，重试前需手动清空临时目录：%TEMP%\WorkBuddy_*。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
第二步：安装向导中 → 手动修改安装路径为非系统盘纯英文路径，例如：D:\Apps\WorkBuddy。
禁止使用含中文、空格、符号（如 &、#、括号）的路径，否则后续远程控制（Claw）、右键菜单、“用 WorkBuddy 打开”等功能全部失效，且错误日志不提示路径问题。
第三步：勾选全部可选项 → 「创建桌面快捷方式」「添加到开始菜单」「开机自启（可选）」「添加到右键菜单」→ 点击「立即安装」。
不勾选「添加到右键菜单」，会导致后续无法对文件/文件夹右键调用 AI 操作，这是高频办公场景断点。
第四步：进度条走完 → 勾选「立即启动 WorkBuddy」→ 点击「完成」→ 等待 5–8 秒 → 弹出 Windows 防火墙提示 → 必须同时勾选「专用网络」和「公用网络」 → 点击「允许访问」。
仅勾选一项，企业微信扫码绑定失败；两项都不勾，则本地服务监听端口被封，Craft 模式所有文件操作超时卡死。
首次启动必做授权
启动后登录（推荐企业微信或 QQ）→ 进入主界面 → 点击左下角头像 →「设置」→「文件访问权限」→ 至少开启「桌面」和「文档」两个文件夹的读写权限。
这是 Craft 模式能执行任务的前提，拒绝后 AI 会反复提示“找不到目标文件”，但不会说明是权限问题。
若已跳过该步骤，可在系统设置中补授：Windows 设置 → 隐私和安全性 → 文件系统 → 找到 WorkBuddy → 开启对应文件夹开关。
