WorkBuddy安装时Swap报错的解决方法有四种：一、临时创建2GB Swap文件并启用；二、将swappiness设为20并持久化配置；三、禁用旧Swap后重建符合尺寸的新分区；四、在内存充足前提下跳过Swap检查强制安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装WorkBuddy时遇到Swap分区报错，通常是因为系统检测到可用交换空间不足或虚拟内存配置不符合安装要求。以下是多种可独立实施的解决方法：
一、临时创建并启用Swap文件
该方法通过手动添加一个临时Swap文件来满足安装过程对交换空间的最低需求，无需重启，适用于无Swap分区或现有Swap过小的Linux系统。
1、以root权限打开终端，执行命令创建大小为2GB的Swap文件：fallocate -l 2G /swapfile。
2、设置Swap文件权限，防止非root用户读取：chmod 600 /swapfile。
3、将该文件格式化为Swap类型：mkswap /swapfile。
4、立即启用该Swap文件：swapon /swapfile。
5、验证是否生效：swapon --show，确认输出中包含/swapfile且SIZE列不为0。
二、修改系统默认Swappiness值并持久化Swap配置
部分WorkBuddy安装脚本会检查swappiness参数是否处于推荐范围（通常为10–30），过高或过低均可能触发警告。此方法调整内核参数并写入配置文件确保重启后仍有效。
1、查看当前swappiness值：cat /proc/sys/vm/swappiness。
2、临时设为建议值20：sysctl vm.swappiness=20。
3、编辑系统配置文件：echo 'vm.swappiness=20' >> /etc/sysctl.conf。
4、将Swap文件路径写入fstab以实现开机自动挂载：echo '/swapfile none swap sw 0 0' >> /etc/fstab。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、禁用现有Swap并重建符合尺寸要求的Swap分区
当原有Swap分区大小固定且小于WorkBuddy要求（如低于1.5GB），或存在损坏导致swapon失败时，可通过删除旧Swap并重新划分满足尺寸的新分区来解决。
1、关闭所有Swap设备：swapoff -a。
2、使用fdisk或parted识别原Swap分区（如/dev/sda2），执行：fdisk /dev/sda，按提示删除原分区并新建主分区，类型设为82（Linux swap）。
3、刷新分区表：partprobe /dev/sda。
4、格式化新分区为Swap：mkswap /dev/sda2（请替换为实际设备名）。
5、启用新Swap：swapon /dev/sda2。
四、跳过Swap检查强制继续安装（仅限可信离线环境）
若已确认物理内存充足（≥8GB）且确定无需Swap支撑安装流程，可绕过WorkBuddy内置的Swap校验逻辑，直接推进安装步骤。该方式不修改系统配置，但需明确承担潜在中断风险。
1、进入WorkBuddy安装包解压目录，查找校验脚本（常见名为check_prereq.sh或install.sh中的swap_check段）。
2、使用sed命令注释掉Swap检测相关行：sed -i '/swap\|SWAP\|swapon/d' install.sh（根据实际脚本内容调整匹配关键词）。
3、赋予脚本执行权限：chmod +x install.sh。
4、运行修改后的安装脚本：./install.sh --skip-swap-check（若支持该参数）或直接执行./install.sh。
