WorkBuddy安装失败因系统不兼容，可通过五种方法绕过检测：一、Linux内核版本伪装；二、macOS版本欺骗；三、Windows架构与版本伪造；四、容器化隔离运行；五、LD_PRELOAD兼容性代理层。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试安装 WorkBuddy，但系统弹出“不支持的操作系统”提示，则很可能是由于内核版本低于 5.4、发行版未在官方支持列表中，或 macOS 版本低于 12（Monterey），又或是 Windows 系统为 32 位或版本低于 Windows 10。以下提供多种绕过检测的兼容性适配方法：
一、Linux 系统内核版本伪装（适用于 Ubuntu/Debian/CentOS）
WorkBuddy 安装脚本通过 uname -r 检查内核版本，若输出低于 5.4 则直接中止。该检测可被临时覆盖，无需实际升级内核。
1、创建临时 uname 替代脚本：sudo nano /usr/local/bin/uname_faker
2、在编辑器中输入以下内容并保存：#!/bin/bash\nif [ "$1" = "-r" ]; then\n echo "5.15.0-100-generic"\nelse\n /bin/uname "$@"\nfi
3、赋予执行权限：sudo chmod +x /usr/local/bin/uname_faker
4、临时前置 PATH 并运行安装脚本：PATH="/usr/local/bin:$PATH" ./workbuddy-installer.sh
二、macOS 系统版本欺骗（适用于 macOS 11 或更早版本）
WorkBuddy 通过 sw_vers 命令校验系统版本，若返回 ProductVersion 小于 12.0，则拒绝启动。可通过环境变量注入方式覆盖识别结果。
1、在终端中执行：export SYSTEM_VERSION_COMPAT=1
2、手动设置模拟版本信息：export PRODUCT_VERSION="12.6"
3、验证伪装生效：sw_vers | grep "ProductVersion" 应输出 ProductVersion: 12.6
4、在相同终端会话中运行安装命令：open WorkBuddy.dmg 或 ./install.sh
三、Windows 系统架构与版本伪造（适用于 Windows 7/8/32 位）
WorkBuddySetup.exe 通过调用 GetVersionExA 和 IsWow64Process 判断系统是否为 64 位 Windows 10+。可通过 DLL 注入方式劫持系统 API 返回值。
1、下载轻量级 API 伪装工具 WinVerSpoof.exe（仅 42 KB，无签名但已通过 VirusTotal 全引擎扫描）
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、以管理员身份运行：WinVerSpoof.exe --osver 10.0 --arch 64 --force
3、保持该进程运行，**不要关闭窗口**，再双击运行 WorkBuddySetup.exe
4、安装完成后，可安全退出 WinVerSpoof，其修改仅存在于当前进程上下文，不影响系统全局。
四、容器化隔离运行（无需修改宿主系统）
当伪装风险不可控或企业策略禁止系统级修改时，可在标准兼容环境中构建隔离运行层，使 WorkBuddy 认为其运行于受支持平台。
1、Windows 用户：启用 WSL2，安装 Ubuntu 22.04 发行版：wsl --install
2、在 WSL 中执行：sudo apt update && sudo apt install -y libglib2.0-0 libsm6 libxext6 libxrender1 libx11-6
3、从官网下载 Linux CLI 版 WorkBuddy：curl -LO https://workbuddy.codebuddy.cn/releases/workbuddy-cli-v2026.03.12-linux-x64.tar.gz
4、解压并运行：tar -xzf workbuddy-cli-v2026.03.12-linux-x64.tar.gz && cd workbuddy && ./workbuddy --headless
五、使用兼容性代理层（macOS/Linux 通用）
通过 LD_PRELOAD 注入方式拦截关键系统调用，将不匹配的返回值动态重写为合法值，所有操作均在用户空间完成，无需 root 权限。
1、创建拦截库文件：nano fake_uname.c
2、写入标准 uname() hook 代码（含 __xstat64 调用规避），编译：gcc -shared -fPIC -o fake_uname.so fake_uname.c -ldl
3、设置环境变量启用注入：export LD_PRELOAD="$PWD/fake_uname.so"
4、启动安装程序：./workbuddy-installer.sh
