workbuddy日志轮转有四种配置方法：一、启用内置轮转（桌面端）；二、linux/macos用logrotate；三、windows用task scheduler+powershell；四、docker用json-file日志驱动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy安装后默认将日志写入本地目录，若未启用轮转机制，日志文件将持续增长，可能耗尽磁盘空间或影响排查效率。以下是针对不同部署环境配置日志轮转的具体方法：
一、启用WorkBuddy内置日志轮转功能
该方式无需外部工具，直接通过客户端配置开启自动归档与清理，适用于标准桌面部署场景，所有日志操作均在用户权限下完成，不依赖系统级服务。
1、启动WorkBuddy客户端，确保已登录并进入主界面。
2、点击右上角Claw设置图标，选择“高级配置” → “日志管理”。
3、勾选“启用日志轮转”，设置单个日志文件最大容量为10 MB，保留历史文件数量为7 个。
4、点击“应用并重启”，WorkBuddy将按新策略在下次启动后生效，日志路径保持不变（Windows为%APPDATA%\WorkBuddy\logs\，macOS为~/Library/Application Support/WorkBuddy/logs/）。
二、Linux/macOS系统下配置logrotate守护
该方式适用于以systemd或launchd托管的后台服务模式，利用系统原生日志管理工具实现精确控制，支持压缩、邮件通知及post-rotate脚本联动。
1、创建logrotate配置文件：/etc/logrotate.d/workbuddy，使用sudo权限编辑。
2、填入以下内容：
3、确认WorkBuddy日志路径为/var/log/workbuddy/*.log，若实际路径不同（如~/Library/Logs/WorkBuddy），需同步修改配置中路径并确保logrotate用户有读取权限。
4、执行logrotate -d /etc/logrotate.d/workbuddy进行调试验证，确认无语法错误且匹配规则正确。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
5、手动触发一次轮转：logrotate -f /etc/logrotate.d/workbuddy，检查/var/log/workbuddy/目录下是否生成带日期后缀的归档文件。
三、Windows平台使用Task Scheduler配合PowerShell脚本
该方式弥补Windows原生缺乏logrotate类工具的不足，通过计划任务定期执行清理逻辑，兼容WorkBuddy默认日志存储结构，无需修改程序行为。
1、新建PowerShell脚本文件，命名为rotate-workbuddy-logs.ps1，内容包含查找.log文件、按修改时间排序、保留最新7个、其余压缩为ZIP并移至archive子目录等逻辑。
2、以管理员身份打开任务计划程序，创建基本任务，触发器设为每天02:00，操作为“启动程序”，程序为powershell.exe，参数为-ExecutionPolicy Bypass -File "C:\Scripts\rotate-workbuddy-logs.ps1"。
3、在操作属性中勾选“不管用户是否登录都要运行”，并启用“只在计算机处于空闲状态时才运行此任务”可选优化项。
4、确认脚本中日志路径指向%APPDATA%\WorkBuddy\logs\，且PowerShell具有对该路径的完全控制权限。
四、Docker容器化部署下的日志轮转配置
该方式专用于以Docker运行WorkBuddy的场景，通过容器引擎日志驱动接管输出，避免应用层日志处理逻辑干扰，符合云原生运维规范。
1、停止当前WorkBuddy容器：docker stop workbuddy-container。
2、重新运行容器时添加日志驱动参数：--log-driver json-file --log-opt max-size=10m --log-opt max-file=7。
3、若使用docker-compose.yml，需在service定义下添加logging区块，其中driver设为json-file，options包含max-size与max-file键值对。
4、验证配置生效：执行docker inspect workbuddy-container | grep -A 5 Logging，确认输出中包含指定大小与数量限制。
