需通过cgroups v2为workbuddy设置内存配额：先验证并启用cgroups v2，再创建专用cgroup并配置memory.max、memory.oom.group和memory.swap.max，接着将workbuddy进程pid写入cgroup.procs，最后可用systemd用户服务持久化管理，并通过memory.current等接口实时监控验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装WorkBuddy并希望限制其运行时内存占用，防止其无节制消耗系统资源，则需通过Linux cgroups机制对其进程组施加内存配额。WorkBuddy作为桌面级AI应用，启动后以普通用户进程运行，不自动纳入容器或systemd服务单元，因此需手动识别其PID并绑定至自定义cgroup。以下是具体操作步骤：
一、确认cgroups版本并准备环境
WorkBuddy内存限制必须基于cgroups v2（统一层级），因v1已弃用且不支持memory.oom.group等关键隔离特性。现代发行版（Ubuntu 22.04+、RHEL 8+、Arch Linux）默认启用v2，但需验证是否生效。
1、执行mount | grep cgroup，确认输出中包含type cgroup2条目；
2、若未挂载，需确保内核启动参数含systemd.unified_cgroup_hierarchy=1，并重启系统；
3、检查/sys/fs/cgroup/目录是否存在且可写，该路径为v2唯一挂载点。
二、创建专用cgroup并设置memory.max
为WorkBuddy创建独立cgroup可避免与其他进程干扰，memory.max是v2中唯一生效的硬性内存上限，超限后内核将阻塞分配并可能触发OOM Killer。
1、以root权限执行mkdir /sys/fs/cgroup/workbuddy创建子组；
2、写入内存上限值：echo 1G > /sys/fs/cgroup/workbuddy/memory.max（示例设为1GB，可根据物理内存总量调整）；
3、为增强稳定性，同步启用OOM组杀机制：echo 1 > /sys/fs/cgroup/workbuddy/memory.oom.group，确保OOM触发时终止整个WorkBuddy进程树而非单个线程；
4、禁用swap以杜绝内存压力下性能骤降：echo 0 > /sys/fs/cgroup/workbuddy/memory.swap.max。
三、将WorkBuddy进程动态加入cgroup
cgroup v2要求将进程PID写入cgroup.procs（非tasks），此举会迁移整个线程组，确保UI主线程与后台推理线程均受同一配额约束。
1、启动WorkBuddy客户端（双击图标或执行./WorkBuddy）；
2、在另一终端中执行pgrep -f "WorkBuddy" | head -n1获取主进程PID；
3、将PID写入cgroup：echo [PID] > /sys/fs/cgroup/workbuddy/cgroup.procs（将[PID]替换为实际数值）；
4、验证是否生效：cat /sys/fs/cgroup/workbuddy/memory.current应显示非零值，且cat /sys/fs/cgroup/workbuddy/memory.max返回1G。
四、通过systemd用户服务持久化配额
手动绑定在系统重启或WorkBuddy更新后失效，使用systemd用户服务可实现开机自启+资源限制一体化管理，无需root权限即可配置。
1、创建服务文件：mkdir -p ~/.config/systemd/user，随后执行nano ~/.config/systemd/user/workbuddy.service；
2、填入以下内容：
[Unit]
Description=WorkBuddy AI Assistant
StartLimitIntervalSec=0
[Service]
Type=simple
ExecStart=/opt/WorkBuddy/WorkBuddy
Restart=on-failure
RestartSec=5
MemoryMax=1G
CPUQuota=200%
IOWeight=50
[Install]
WantedBy=default.target
3、启用服务：systemctl --user daemon-reload && systemctl --user enable workbuddy.service && systemctl --user start workbuddy.service；
4、检查状态：systemctl --user status workbuddy.service，确认MemoryMax字段显示1G且无failed提示。
五、验证与实时观测内存使用
仅设置配额不足以保障效果，必须通过cgroup原生接口验证实际用量与事件触发情况，避免依赖WorkBuddy自身界面显示（其不暴露底层内存统计）。
1、持续监控当前用量：watch -n1 'cat /sys/fs/cgroup/workbuddy/memory.current'，单位为字节；
2、检查OOM事件计数：cat /sys/fs/cgroup/workbuddy/memory.events | grep oom_kill，若数值递增说明频繁触限，需调高memory.max；
3、查看详细内存构成：cat /sys/fs/cgroup/workbuddy/memory.stat | grep "anon\|file\|swap"，判断是否因page cache膨胀导致误报；
4、强制触发测试（谨慎）：stress-ng --vm 1 --vm-bytes 2G --timeout 30s观察WorkBuddy是否被OOM Killer终止，日志可通过dmesg -T | tail -20查看。
