centos 7非官方支持系统，需手动适配：一、确认内核≥4.15、systemd≥229；二、可用ansible降级部署（仅测试）；三、可二进制直装+sysv脚本；四、claw代理验证本地服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在CentOS 7系统上尝试安装WorkBuddy，但发现官方文档未明确列出该版本为受支持系统，则需特别注意兼容性限制与手动适配步骤。以下是针对CentOS 7的可行部署方案：
一、确认系统兼容性与前置约束
WorkBuddy官方明确支持CentOS 8+（含Stream）及Rocky Linux 8+，CentOS 7不在官方支持列表中，因其内核版本（通常≤3.10）、systemd版本（≤219）及glibc版本均低于最低运行要求。强行部署可能导致Claw代理无法注册服务、Docker容器启动失败或本地模型推理模块崩溃。
1、执行uname -r确认内核版本，若输出低于4.15，必须升级内核或更换系统；
2、运行systemctl --version检查systemd版本，若低于229，无法正确加载workbuddy-server systemd服务单元；
3、执行cat /etc/redhat-release验证发行版标识，确认为CentOS Linux release 7.x；
4、如任一条件不满足，官方推荐迁移至CentOS Stream 8或Rocky Linux 8。
二、使用Ansible脚本强制适配部署（仅限技术验证场景）
该方案绕过官方兼容性校验，通过Ansible Playbook降级适配CentOS 7环境，适用于离线测试或临时调试，不建议用于生产环境。
1、在控制节点安装Ansible 2.10+：执行yum install epel-release -y && yum install ansible-2.10.8-1.el7.noarch -y；
2、关闭SELinux并同步时间：执行setenforce 0 && sed -i 's/SELINUX=enforcing/SELINUX=permissive/g' /etc/selinux/config及chronyctl enable && chronyctl start；
3、编辑/etc/ansible/hosts，添加目标主机并显式声明OS类型：
[workbuddy_centos7]
server1 ansible_host=192.168.3.101 ansible_user=root ansible_python_interpreter=/usr/bin/python2
4、在Playbook的vars/main.yml中覆盖系统变量：
workbuddy_system_type: "centos7"
workbuddy_systemd_unit_template: "centos7-systemd.j2"
5、执行部署命令并忽略OS校验错误：ansible-playbook deploy.yml --skip-tags "os_compatibility_check" -e "force_os=centos7"。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、二进制直装+手动服务注册（最小依赖路径）
跳过Docker与Ansible依赖，直接运行workbuddy-server二进制文件，并使用传统SysV init脚本替代systemd服务管理，适用于资源受限且无法升级系统的旧服务器。
1、下载amd64架构二进制包：curl -L https://www.codebuddy.cn/work/workbuddy-server-linux-amd64.tar.gz -o /tmp/wb.tar.gz；
2、解压至/opt/workbuddy并赋予权限：tar -xzf /tmp/wb.tar.gz -C /opt/ && chmod +x /opt/workbuddy/workbuddy-server；
3、创建SysV启动脚本/etc/init.d/workbuddy，内容包含start/stop/restart函数及/opt/workbuddy/workbuddy-server --config /opt/workbuddy/config.yaml调用逻辑；
4、注册服务：chkconfig --add workbuddy && chkconfig workbuddy on；
5、手动创建配置文件/opt/workbuddy/config.yaml，至少包含claw_port: 3001与log_level: warn字段。
四、启用Claw代理并验证本地服务能力
无论采用何种安装方式，最终必须通过Claw代理暴露本地能力，该步骤不依赖系统版本，但需确保图形会话或后台用户上下文就绪。
1、以目标用户身份运行/opt/workbuddy/workbuddy-server --claw-only启动纯代理模式；
2、访问http://localhost:3001/health，返回{"status":"ok","mode":"claw"}表示代理已就绪；
3、在WorkBuddy桌面客户端中进入Claw Settings，粘贴http://[服务器IP]:3001作为远程Claw Endpoint；
4、点击“测试连接”，若返回Claw Token校验成功，则本地服务能力已接入；
5、在企业微信中发送指令“@WorkBuddy 打开计算器”，观察服务器终端是否弹出对应应用窗口。
