WorkBuddy加密库异常通常由OpenSSL版本不兼容引起，需确保版本在1.1.1g至3.0.12范围内；可通过降级至1.1.1w、升级至3.0.12、或使用容器/静态链接隔离运行时环境解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果在使用WorkBuddy时遇到加密库异常，可能与系统中安装的OpenSSL版本不兼容有关。以下是验证和调整OpenSSL版本以满足WorkBuddy运行要求的具体操作步骤：
一、确认WorkBuddy支持的OpenSSL版本范围
WorkBuddy依赖OpenSSL提供的TLS/SSL功能实现安全通信，其构建时绑定的最低兼容版本为OpenSSL 1.1.1g，最高兼容至OpenSSL 3.0.12（不含3.1.x及以上主版本）。使用低于1.1.1g的版本将导致握手失败或证书解析错误；使用3.1.x及以上版本则可能触发API弃用警告或函数符号缺失异常。
1、执行命令 openssl version -a 查看当前系统OpenSSL完整版本及编译参数。
2、检查输出中 Built on 和 Options 字段，确认是否启用 enable-fips 或 no-deprecated 等可能影响兼容性的配置。
3、比对版本号是否落在 1.1.1g ≤ version ≤ 3.0.12 区间内。
二、降级OpenSSL至1.1.1系列稳定版
当系统默认OpenSSL为3.1.x或更高版本时，需单独部署1.1.1系列运行时库，避免全局替换引发其他软件故障。该方法通过LD_LIBRARY_PATH优先加载指定版本so文件，不影响系统原有OpenSSL。
1、从OpenSSL官方归档下载 openssl-1.1.1w.tar.gz 源码包。
2、解压后进入目录，执行 ./config --prefix=/opt/openssl-1.1.1w --openssldir=/opt/openssl-1.1.1w shared zlib。
3、运行 make && sudo make install 完成安装。
4、启动WorkBuddy前设置环境变量：export LD_LIBRARY_PATH="/opt/openssl-1.1.1w/lib:$LD_LIBRARY_PATH"。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、升级OpenSSL至3.0.x兼容版本
若当前版本为1.0.2或1.1.0等已终止维护的分支，必须升级至3.0.x系列以获得安全补丁和TLS 1.3支持。此方案适用于全新部署或容器化环境，需确保所有依赖模块重新链接。
1、获取OpenSSL 3.0.12源码包，校验SHA256值是否匹配官网发布摘要。
2、配置时添加 --api=3.0 参数以启用向后兼容接口层。
3、编译完成后执行 sudo make install_sw 仅安装共享库与头文件，跳过覆盖系统命令。
4、修改WorkBuddy启动脚本，在exec前插入 export OPENSSL_CONF="/etc/ssl/openssl.cnf" 显式指定配置路径。
四、隔离OpenSSL运行时环境
当无法修改系统级OpenSSL且多版本共存需求强烈时，可采用静态链接或容器封装方式锁定依赖。该方法彻底规避动态库版本冲突，但会增加二进制体积或运维复杂度。
1、使用 gcc -static-libgcc -static-libstdc++ 编译WorkBuddy核心模块，将libcrypto.a与libssl.a静态嵌入。
2、构建Docker镜像时，基于 ubuntu:22.04 基础镜像，通过apt安装 libssl1.1=1.1.1f-1ubuntu2.19 锁定版本。
3、在Dockerfile中添加 RUN dpkg-divert --local --rename --divert /usr/lib/x86_64-linux-gnu/libssl.so.1.1.real /usr/lib/x86_64-linux-gnu/libssl.so.1.1 防止包管理器覆盖。
4、启动容器时挂载宿主机证书目录至 /etc/ssl/certs 并设置 SSL_CERT_FILE 环境变量指向容器内路径。
