workbuddy文件保存失败主因是本地存储配置不足：一、安装盘需≥2.5gb剩余空间且为ntfs/apfs/ext4格式；二、工作区须定期清理90天前文件；三、需手动清理cache目录；四、暂存盘应设为≥50gb非系统盘；五、剪贴板传输上限2mb，claw连接受句柄数限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 WorkBuddy 过程中遇到文件无法保存、缓存写入失败或大文件处理中断等问题，则可能是由于本地存储空间配置未满足运行时动态增长需求。WorkBuddy 并无统一的“最大文件大小”硬性限制，其实际可处理容量由解析方式、文件类型与运行环境配置共同决定，超限时通常静默截断而非报错。以下是针对不同存储维度的具体限制说明与应对操作：
一、安装路径所在磁盘的最低空间要求
WorkBuddy 首次运行需解压核心运行时、生成知识索引、缓存技能包并保留沙箱快照，该过程要求连续写入空间，对文件系统格式与剩余容量均有刚性约束。
1、确保安装路径所在分区剩余空间 ≥2.5GB，其中预留 500MB 缓冲以应对临时文件写入峰值。
2、检查文件系统格式：Windows 用户须确认为 NTFS；macOS 用户须为 APFS；Linux 用户须为 ext4；FAT32 或 exFAT 格式不可用。
3、禁止将 WorkBuddy 安装至移动硬盘、U 盘或网络共享路径，此类路径不支持硬链接与 POSIX 权限一致性，将导致初始化阻断。
二、工作区目录（workspace）的隐性增长控制
用户指定的工作区用于存放原始输入、中间产物及 AI 生成结果，长期未清理易堆积大量临时文档、分片图像与冗余 JSON 日志，形成实际瓶颈。
1、启动 WorkBuddy 主界面，在右下角点击“指定工作区”按钮，确认当前路径（如：D:\WorkBuddy\workspace）。
2、打开文件管理器，导航至该路径，进入子文件夹 tasks 与 exports。
3、按修改日期排序，选中创建时间早于 90 天前 的所有文件夹及 ZIP 包，右键删除。
4、保留最近 7 次完整任务记录文件夹，其余含 _draft、_temp、_cache 字样的文件夹全部清除。
三、应用专属缓存目录（Cache）的强制清理路径
WorkBuddy 运行中自动下载本地模型分片、Web 渲染资源与 UI 快照，这些内容驻留在系统级缓存目录，常规卸载无法清除，且持续增长可达数 GB。
1、Windows 用户按下 Win + R，输入 %LOCALAPPDATA%\WorkBuddy\Cache，回车进入目录。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、macOS 用户打开终端，执行：rm -rf ~/Library/Caches/com.codebuddy.workbuddy/cache/。
3、Linux 用户执行：rm -rf ~/.cache/workbuddy/cache/。
4、注意：请勿删除 Sandbox 目录，否则已加载技能将丢失并需重新下载。
四、暂存盘（Scratch Disk）的容量与迁移配置
暂存盘用于多任务并行时的内存交换、大文件解压缓冲及模型推理中间态暂存；当所选分区剩余容量低于 8GB，系统将拒绝写入并触发存储告警。
1、在 WorkBuddy 主窗口点击右上角「首选项」→「增效工具」→「暂存盘」。
2、点击「更改路径」，选择一个剩余空间 ≥50GB 的非系统盘（如：E:\WorkBuddy_Temp）。
3、勾选「清空原暂存盘缓存」，确认后系统将自动迁移并重置缓冲区。
4、重启 WorkBuddy 后，新暂存盘立即生效，旧路径下残留文件需手动删除。
五、剪贴板与远程指令传输层的隐性上限
多数用户误判文件大小为瓶颈，实则日常最常触发限制的是剪贴板与 Claw 协议层的传输阈值，该限制独立于磁盘空间，但直接影响大内容注入能力。
1、客户端默认剪贴板上限为 maxPayloadSizeKB: 2048（即 2MB），超限内容被静默丢弃，不提示。
2、即使启用剪贴板分块传输，IM 网关层仍有校验；飞书/企微后台设置的单条指令最大字符数若为 20000，则约 1.5MB 富文本 就无法进入 WorkBuddy。
3、Claw 连接受系统 nofile 限制 影响：若 ulimit -n 仍为 1024，同时打开 3 个 PDF + 2 个 ZIP 任务，可能卡在“等待文件句柄”状态。
