workbuddy官方仅支持ubuntu 20.04/22.04/24.04 lts，须用.deb包配合apt安装；图形界面双击可能静默失败；需验证系统id、version_id、内核≥5.4、glibc≥2.31、openssl≥1.1.1f；仅从官网下载.deb并校验sha256。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy官方明确支持Ubuntu 20.04 LTS、22.04 LTS及24.04 LTS，必须使用.deb安装包配合apt命令行安装，图形界面双击安装器在部分Ubuntu桌面环境（如KDE Plasma或Wayland会话）中会静默失败或权限异常。
确认系统版本与基础依赖
打开终端，依次执行以下命令：
运行cat /etc/os-release | grep -E "ID|VERSION_ID"，确认输出中ID="ubuntu"且VERSION_ID为"20.04"、"22.04"或"24.04"——【非此三者任意一版，后续步骤极大概率失败】。
运行uname -r，确保内核版本≥5.4；运行ldd --version | head -n1，确认glibc≥2.31；运行openssl version，输出须为1.1.1f或更高（若显示3.x，需额外安装libssl1.1兼容包）。
这一步操作起来很简单，直接把文件拖进去就行。
下载并校验.deb安装包
访问WorkBuddy官网下载页（https://curl.qcloud.com/t6LCDQSc），点击“Linux”→选择“Ubuntu”→下载以workbuddy_*.deb命名的文件，保存至~/Downloads目录。
不要从第三方镜像站或论坛附件下载，【篡改过的.deb包会在安装末尾触发auth.codebuddy.cn证书链校验失败，导致首次登录无限转圈】。
进入下载目录后执行：cd ~/Downloads && sha256sum -c ，若输出"OK"则校验通过。
命令行安装与服务启用
第一步：用dpkg预安装，忽略依赖警告（由apt自动修复）：sudo dpkg -i workbuddy_*.deb。
第二步：强制修复缺失依赖：sudo apt --fix-broken install -y。这步不可跳过，否则systemd服务单元无法注册。
第三步：启用并启动后台服务：sudo systemctl enable workbuddy-claw && sudo systemctl start workbuddy-claw。
第四步：验证服务状态：sudo systemctl is-active workbuddy-claw，返回active即成功；若返回failed，立即执行journalctl -u workbuddy-claw -n 50 --no-pager查看具体错误。
首次启动与账号登录
方法一：图形方式启动
在应用菜单中搜索“WorkBuddy”，点击图标启动；若无响应，说明Wayland会话不兼容，切换至X11登录再试。
方法二：终端强制启动
执行workbuddy-desktop，窗口弹出后输入已注册的CodeBuddy账号（https://curl.qcloud.com/t6LCDQSc注册）。
注意：首次启动必须联网，离线状态下auth.codebuddy.cn域名解析失败会导致界面卡在“正在初始化”；若DNS被污染，可临时修改/etc/resolv.conf添加nameserver 8.8.8.8。
