WorkBuddy安装失败主因是系统环境、权限或路径不匹配：Windows需补全.NET和VC++组件并关闭防护；macOS需解除隔离属性并手动授权；Linux需确保bash解释器兼容；通用方案是直用Web版临时替代。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy安装失败时提示错误，不是安装包本身损坏，而是系统环境、权限设置或路径配置与安装器要求不匹配——比如Windows下.NET组件缺失、macOS被隔离属性拦截、Linux脚本解释器版本过低，都会在点击安装后几秒内弹出报错窗口并中断流程。
Windows系统：补全运行库+关闭实时防护
第一步：以管理员身份运行PowerShell，一次性启用必需组件：
Get-WindowsCapability -Online | Where-Object Name -like 'NetFx*' | Add-WindowsCapability -Online
这一步必须执行，否则WorkBuddySetup.exe会因找不到.NET Framework 3.5/4.8而直接闪退。
第二步：下载并安装微软官方Visual C++ 2015–2022 运行库（x64），注意必须选“运行库”而非“可再发行组件包”，后者不包含WorkBuddy依赖的CRT动态链接库。
第三步：临时关闭Windows Defender实时保护——进入“Windows安全中心”→“病毒和威胁防护”→“管理设置”→关闭“实时保护”。杀毒软件如360、腾讯电脑管家也需完全退出进程，不能仅最小化。
第四步：重新运行安装包时，务必勾选“为所有用户安装”和“添加到PATH”，否则后续命令行调用会失败。这一步跳过会导致WorkBuddy无法被AI指令或脚本唤起。
macOS系统：解除隔离属性+手动授权启动
方法一：右键WorkBuddy.app → “显示简介” → 底部勾选“仍要打开”（若灰色不可点，先点左下角锁图标输入密码解锁）→ 关闭窗口后再次右键 → “打开” → 弹窗中点“打开”。
方法二：若方法一无效，打开终端执行强制移除隔离命令：
sudo xattr -rd com.apple.quarantine /Applications/WorkBuddy.app
输密码后无提示即成功，此操作不可逆，但仅影响该App，不影响系统安全策略。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
方法三：检查是否残留Homebrew旧版服务冲突——运行brew services list | grep workbuddy，若存在正在运行的workbuddy服务，先执行brew services stop workbuddy再重试安装。
Linux系统：确认Shell解释器并强制用bash执行
① 查看当前默认Shell是否兼容：
head -n1 ./workbuddy-install.sh 确认首行为#!/bin/bash；
再运行 ls -l /bin/sh，若指向/bin/dash则必然报syntax error。
② 绕过系统默认sh，强制用bash执行：
/bin/bash ./workbuddy-install.sh
③ 若提示bash版本过低（如3.2），检查系统是否已预装高版本：ls /usr/bin/bash* | grep -E 'bash[4-9]'；若有，将脚本首行改为#!/usr/bin/env bash，并在第二行插入版本校验逻辑，避免在不支持的环境中强行运行。
④ WSL用户需额外验证：cat /etc/passwd | grep $(whoami) 确认末字段为/bin/bash，否则执行chsh -s /bin/bash切换默认Shell，否则即使显式调用bash也会因子shell继承问题触发语法错误。
通用绕行方案：跳过客户端直用Web版
打开浏览器访问 https://workbuddy.codebuddy.cn/web ，无需注册、无需登录，页面加载即用。该Web版具备任务自动化、文档解析、多工具协同等核心能力，适合紧急交付场景或持续安装失败时临时替代。
注意：Web版不保存本地工作空间，所有上传文件在会话结束后自动清除，敏感数据勿在此上传。
