必须点「是」，因uac提示是安装必需步骤，点「否」或关闭会导致静默失败；安装路径应避开c盘默认位置，改用无中文、空格、特殊符号的非系统盘路径；首次启动时须允许防火墙访问专用及公用网络。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
双击 WorkBuddySetup.exe 后弹出 UAC 提示，必须点「是」
Windows 11 默认启用用户账户控制（UAC），而 WorkBuddy 安装过程需写入 Program Files、注册表项、创建快捷方式等系统级操作。如果点「否」或直接关闭窗口，安装会静默失败，桌面无图标、开始菜单无入口，且不会报错提示。
常见误操作包括：误以为是广告弹窗、被其他全屏应用遮挡后误点取消、杀毒软件同时弹出拦截框导致手滑选错。务必确认弹窗标题为「Windows 安全中心」或「用户账户控制」，发布者显示「Tencent Technology (Shenzhen) Company Limited」再点击「是」。
安装路径别留在 C 盘默认位置
虽然向导默认设为 C:\Program Files\WorkBuddy，但 Windows 11 系统盘（尤其是 SSD）空间紧张很常见。WorkBuddy 运行时会缓存模型分片、日志和临时技能包，长期使用可能额外占用 500MB–1.2GB 空间。
建议在安装路径页手动修改为非系统盘路径，例如：
D:\Apps\WorkBuddyE:\Tools\WorkBuddy
注意：路径中不要含中文、空格或特殊符号（如 &、#），否则后续远程控制（Claw）或插件加载可能出现路径解析异常。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
首次启动时 Windows 防火墙弹窗不能跳过
WorkBuddy 启动后会立即尝试建立本地服务监听（用于 Claw 远程指令、Web UI 调试接口），此时 Windows 防火墙必弹提示。若勾选不全或点了「取消」，会导致以下问题：
- 企业微信/QQ 扫码绑定失败，提示「无法连接本地服务」
- 右键菜单「用 WorkBuddy 打开」功能无响应
- 部分技能（如文件批量重命名、截图OCR）超时卡死
正确操作是：勾选「专用网络」和「公用网络」两项，点「允许访问」。若杀毒软件（如 360、火绒）同步弹窗，需在它的界面中明确选择「信任该程序」或「添加到白名单」，不能仅点「本次允许」。
WorkBuddySetup.exe 运行失败的三个典型原因
不是所有「点不动」「闪退」「进度条卡住」都算“安装失败”，很多是前置条件未满足：
- 系统版本低于 Windows 11 22H2（即 22621.x 及以上），安装包会直接退出，无提示——可按
Win+R输入winver核对 - 内存小于 8GB 且开启虚拟内存限制，安装进程会被系统终止；任务管理器里能看到
WorkBuddySetup.exe突然消失 - 之前装过 CodeBuddy 并未卸载干净，两个同源应用的 IPC 通道冲突，表现为双击后无任何反应——需先在「设置 → 应用 → 已安装的应用」里彻底卸载 CodeBuddy
这些细节容易被忽略，但恰恰是重装三遍仍失败的主因。装前花 30 秒查 winver 和内存，比反复下载安装包更省时间。
