workbuddy部署前需通过五种方法自检环境：一、验证系统兼容性与内核版本；二、检测硬件资源实时状态；三、校验openssl、sqlite3及glibc等依赖版本；四、运行官方cli自检工具workbuddy-checker；五、启用图形化预检向导。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试部署WorkBuddy但不确定当前服务器是否满足运行条件，则可能是由于操作系统版本、硬件资源或依赖组件不达标导致初始化失败或服务异常退出。以下是检查服务器是否满足WorkBuddy环境要求的多种自检方法：
一、执行系统兼容性与内核版本验证
该方法通过终端命令直接读取系统底层信息，确认是否在官方支持的操作系统及内核范围内，避免因ABI不匹配或驱动缺失引发二进制加载失败。
1、打开终端（Linux/macOS）或 PowerShell（Windows），执行 uname -r 命令，检查Linux内核版本是否 ≥ 5.4；
2、运行 cat /etc/os-release，确认发行版为 Ubuntu 20.04/22.04、Debian 11/12 或 CentOS Stream 9；
3、macOS用户执行 sw_vers，确保输出版本号 ≥ 12（Monterey）；
4、Windows用户在命令提示符中运行 winver，核对版本是否为 Windows 10（1903 及以上）或 Windows 11 全版本。
二、运行硬件资源实时检测脚本
该方法通过系统级工具获取内存、磁盘与CPU的实时可用状态，排除因资源长期被高负载进程占用而导致WorkBuddy多Agent任务卡顿或崩溃的风险。
1、执行 free -h，确认空闲 RAM ≥ 2GB（推荐 ≥ 4GB）；
2、运行 df -h /，检查根分区剩余空间是否 ≥ 5GB；
3、输入 lscpu | grep 'CPU\(s\)' | head -2，验证逻辑CPU核心数 ≥ 2；
4、Windows用户在PowerShell中运行 Get-CimInstance Win32_ComputerSystem | Select-Object TotalPhysicalMemory 与 Get-PSDrive C | Select-Object Free 获取等效数据。
三、校验必要运行时依赖版本
该方法用于识别OpenSSL、SQLite3及GLIBC等关键依赖是否缺失或版本错配，防止WorkBuddy启动时因动态链接库加载失败而中断。
1、执行 openssl version，确认输出版本号 ≥ 1.1.1f；
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、运行 sqlite3 --version，确保版本 ≥ 3.30.0；
3、输入 ldd --version 并比对 glibc 版本，Linux系统要求 ≥ 2.31；
4、macOS用户需额外执行 otool -L $(which python3) | grep ssl 验证Python绑定的OpenSSL路径有效性。
四、调用WorkBuddy官方一键自检工具
该方法使用腾讯云提供的轻量级CLI工具workbuddy-checker，自动整合上述全部检测项并生成结构化报告，适用于批量服务器巡检场景。
1、访问 https://www.codebuddy.cn/work/checker 下载对应平台的workbuddy-checker二进制文件；
2、Linux/macOS用户赋予执行权限：chmod +x workbuddy-checker；
3、Windows用户以管理员身份运行PowerShell，执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 解除脚本限制；
4、在终端中运行 ./workbuddy-checker --full（Linux/macOS）或 workbuddy-checker.exe --full（Windows），等待输出JSON格式检测结果。
五、启用图形化环境预检向导
该方法面向非技术用户，通过WorkBuddy安装包内置的GUI检测模块，在图形界面中逐项反馈系统状态，无需记忆命令或解析日志。
1、双击运行WorkBuddySetup.exe（Windows）或挂载WorkBuddy.dmg后启动安装器（macOS）；
2、在安装向导首屏点击 “运行环境预检” 按钮；
3、向导将自动扫描操作系统版本、可用内存、磁盘空间、网络连通性及代理配置；
4、所有检测项以红/绿图标直观标识，红色项旁附带具体修复指引链接。
