workbuddy生产环境需≥2.5gb磁盘空间且文件系统须为ntfs/apfs/ext4；清理logs/cache目录、配置系统日志轮转、重定向workbuddy_temp至大容量盘、或手动解压安装包可解决空间不足问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在为 WorkBuddy 部署生产环境，但发现磁盘空间持续告急或初始化失败，则可能是由于未预留足够空间应对运行时动态增长。以下是满足稳定运行所需的磁盘空间基准及对应日志清理与扩容操作：
一、WorkBuddy 生产环境最低磁盘空间要求
WorkBuddy 在首次运行时会解压核心运行时、缓存技能包、生成本地知识索引，并保留执行沙箱快照；这些操作均需连续写入，对磁盘空间具有刚性需求。安装包本体约 150–180MB，但完整部署后实际占用空间不低于 2GB，且该空间必须位于支持硬链接与 POSIX 权限的文件系统（Windows NTFS、macOS APFS、Linux ext4），FAT32 或 exFAT 格式不可用。
1、确保目标安装路径所在分区剩余空间 ≥ 2.5GB（预留 500MB 缓冲，避免因临时文件写入峰值触发中断）。
2、检查文件系统格式：Windows 用户可在磁盘属性中确认是否为 NTFS；Linux 用户执行 df -T 查看挂载点文件系统类型；macOS 用户可通过“磁盘工具”查看宗卷格式。
3、禁止将 WorkBuddy 安装至移动硬盘、U 盘或网络共享路径，此类路径不满足硬链接与权限一致性要求，将导致初始化流程阻断。
二、清理 WorkBuddy 相关日志与缓存目录
WorkBuddy 运行过程中会在用户配置目录持续写入日志、模型缓存、技能包副本及沙箱快照，若长期未清理，AppData\Local\WorkBuddy（Windows）或 ~/Library/Caches/com.codebuddy.workbuddy（macOS）可能累积数 GB 冗余数据。手动定位并清理可立即释放空间。
1、Windows 用户按下 Win + R，输入 %LOCALAPPDATA%\WorkBuddy，回车进入目录。
2、删除子目录中名为 logs、cache、temp 的文件夹（保留 config 和 storage 以防配置丢失）。
3、macOS 用户打开终端，执行：rm -rf ~/Library/Caches/com.codebuddy.workbuddy/logs/ 与 rm -rf ~/Library/Caches/com.codebuddy.workbuddy/cache/。
4、Linux 用户执行：rm -rf ~/.cache/workbuddy/logs/ 与 rm -rf ~/.cache/workbuddy/cache/。
三、系统级日志轮转与自动压缩
除 WorkBuddy 自身日志外，系统日志（如 Windows Event Logs、Linux /var/log）也可能被其调用过程间接写入，尤其在启用远程控制（Claw）或 MCP Server 注册失败时产生高频错误记录。通过配置日志轮转策略，可防止单个日志文件无限膨胀。
1、Windows 系统：打开“事件查看器”，右键“Windows 日志 → 应用程序”，选择“属性”，勾选“按需覆盖事件”，将“最大日志大小”设为 256MB，并启用“当达到日志最大值时”的“覆盖超过 7 天的事件”选项。
2、Linux 系统：编辑 /etc/logrotate.d/workbuddy（若不存在则新建），填入以下内容：
/var/log/workbuddy/*.log {
daily
rotate 14
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
compress
missingok
notifempty
create 0644 root root
}
3、执行 logrotate -f /etc/logrotate.d/workbuddy 立即生效轮转规则。
四、重定向 WorkBuddy 临时工作区至大容量磁盘
WorkBuddy 默认将临时文件、沙箱快照及解压中间产物写入系统默认 TEMP 路径（Windows 为 %TEMP%，Linux/macOS 为 /tmp），若该路径所在分区空间紧张，即使目标安装盘富余，仍会报“空间不足”。通过修改环境变量强制其使用高冗余分区，可规避此限制。
1、Windows 用户：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中新建或修改 WORKBUDDY_TEMP 变量，值设为 D:\WB_Temp（需提前创建该空文件夹并赋予完全控制权限）。
2、Linux 用户：在 ~/.bashrc 或 ~/.zshrc 中追加：export WORKBUDDY_TEMP="/mnt/data/wb_temp"，随后执行 source ~/.bashrc。
3、macOS 用户：在 ~/.zprofile 中添加相同 export 语句，并重启终端生效。
五、手动解压安装包并指定部署路径
部分 WorkBuddy 安装程序（如 Inno Setup 打包的 .exe）本质为自解压归档，其内部解压逻辑强依赖 TEMP 路径。若 C 盘 TEMP 已满，即便 D 盘有 20GB 空闲也无法启动。跳过系统临时目录，直接解压到目标位置，可彻底绕过该瓶颈。
1、右键 WorkBuddySetup.exe 文件，选择“用 7-Zip 打开”（需已安装 7-Zip）。
2、确认窗口中显示可浏览结构（含 app/、resources/、setup.dat 等）。
3、点击工具栏“解压到”按钮，指定路径为 D:\WorkBuddy_Deploy（确保该路径所在分区剩余空间 ≥ 2.5GB）。
4、解压完成后，进入该目录，双击运行 WorkBuddy.exe 启动主程序（无需再执行安装向导）。
