WorkBuddy安装报错主因是CentOS版本不匹配或glibc/openssl/python3-devel等依赖缺失或版本过低；需依次验证系统版本、安装开发工具与devel包、修复Python环境、替换musl静态二进制、禁用SELinux并配置LD_LIBRARY_PATH。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在CentOS系统上执行WorkBuddy安装脚本时遇到报错，通常源于系统版本与脚本预设的发行版不匹配，或关键依赖库（如glibc、openssl、python3-devel）版本过低、缺失或架构不兼容。以下是针对该问题的多种排查与修复路径：
一、验证并切换适配的CentOS主版本分支
WorkBuddy安装脚本常硬编码检测特定CentOS大版本（如仅支持7.x或8.x），而实际运行环境为CentOS Stream 9或已停更的CentOS 6，将触发版本校验失败。需手动绕过或修正版本判定逻辑。
1、使用cat /etc/redhat-release确认当前系统精确版本号。
2、下载原始安装脚本并用sed临时注释或替换版本检查段落，例如将if [[ "$distro_version" != "7" ]]改为if false。
3、保存修改后脚本，赋予可执行权限：chmod +x workbuddy-install.sh，再重新运行。
二、强制安装缺失的底层C库与开发头文件
脚本在编译或加载动态链接库阶段报libxxx.so.X: cannot open shared object file或fatal error: xxx.h: No such file or directory，表明glibc、openssl、zlib等基础库或其-devel包未就绪。
1、执行yum groupinstall "Development Tools"安装编译工具链。
2、运行yum install -y glibc-devel openssl-devel zlib-devel libffi-devel补全核心开发依赖。
3、若提示Package xxx is not available，则启用EPEL源：yum install -y epel-release，再重试安装。
三、降级或升级Python解释器及pip模块环境
WorkBuddy脚本依赖特定Python小版本（如3.6.8）及wheel、setuptools版本，但CentOS默认Python 3.6.8可能缺少_ssl模块，或pip版本过旧导致wheel构建失败。
1、检查Python完整性：python3 -c "import ssl; print(ssl.OPENSSL_VERSION)"，若报错则需重装Python3。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、使用dnf install -y python36 python36-devel python36-pip（CentOS 8）或从SCL仓库启用centos-release-scl后安装python38（CentOS 7）。
3、升级pip至21.3.1以上：python3 -m pip install --upgrade pip==21.3.1，并确认which pip3指向正确路径。
四、手动预置静态链接的二进制依赖项
当系统glibc版本低于脚本内嵌二进制（如workbuddy-agent）所需最低版本时，./workbuddy-agent: /lib64/libc.so.6: version 'GLIBC_2.18' not found类错误必然发生，此时无法通过yum升级glibc（存在系统崩溃风险）。
1、从WorkBuddy官方文档获取static-build分支或musl编译版agent压缩包。
2、解压后替换原脚本中调用的workbuddy-agent路径，例如修改脚本中./bin/agent为./bin/agent-musl。
3、确保目标文件具备可执行权限：chmod 755 ./bin/agent-musl，再继续执行后续安装步骤。
五、禁用SELinux策略与调整库搜索路径
SELinux处于enforcing模式时，可能拦截脚本对/usr/lib64或/opt/workbuddy/lib下自定义库的加载；同时LD_LIBRARY_PATH未包含私有库目录也会导致dlopen失败。
1、临时设为permissive模式：sudo setenforce 0，验证是否消除报错。
2、若确认是SELinux引起，在/etc/selinux/config中将SELINUX=enforcing改为SELINUX=permissive并重启。
3、在安装脚本开头插入export LD_LIBRARY_PATH="/opt/workbuddy/lib:$LD_LIBRARY_PATH"，确保运行时能定位到脚本自带的so文件。
