WorkBuddy文件存储空间容量与限制详解

遇到WorkBuddy文件保存失败，或者缓存写入报错、大文件处理到一半就中断？别急着怀疑软件本身有硬性文件大小限制。实际上，WorkBuddy并没有一个统一的“最大文件”上限，它的处理能力更多取决于你的本地存储环境是否配置得当。问题往往出在运行时动态增长的需求未被满足，而一旦超限，系统通常会选择静默截断而非明确报错，这就让排查变得有点棘手。

说到底，想让WorkBuddy流畅运行，你得从以下几个存储维度入手检查和调整。

一、安装路径所在磁盘的最低空间要求

第一次启动WorkBuddy时，它可不只是打开个程序那么简单。背后有一系列密集的写入操作：解压核心运行时、生成知识索引、缓存技能包，还要保留沙箱快照。这个过程对磁盘的剩余空间和文件系统格式都有硬性要求。

首先，确保安装分区至少有2.5GB的剩余空间。这还没完，最好再额外预留出500MB的缓冲，用来应对临时文件写入的峰值波动。

其次，文件系统格式是关键。Windows用户请确认分区是NTFS；macOS用户需要APFS；Linux用户则必须是ext4。至于FAT32或exFAT格式，那是绝对不可用的。

最后，安装位置也有讲究。千万别图方便把WorkBuddy装到移动硬盘、U盘或者网络共享路径上。这些路径不支持硬链接，POSIX权限也容易出问题，最终会导致初始化直接失败。

二、工作区目录（workspace）的隐性增长控制

你指定的那个工作区目录，是存放所有原始文件、中间产物和AI生成结果的地方。日子一长，里面很容易堆积起大量的临时文档、分片图像和冗余的JSON日志文件，不知不觉就成了性能瓶颈。

清理起来其实有章可循：先在WorkBuddy主界面右下角点击“指定工作区”按钮，确认当前路径（比如D:WorkBuddyworkspace）。然后打开文件管理器，导航到这个路径，重点进入tasks和exports这两个子文件夹。

接下来，按修改日期排序，把所有创建时间早于90天的文件夹和ZIP包都选中删除。对于更近期的文件，建议保留最近7次的完整任务记录文件夹，其余那些名字里带_draft、_temp、_cache字样的文件夹，可以放心清理掉。

三、应用专属缓存目录（Cache）的强制清理路径

WorkBuddy在运行时会自动下载一些本地模型分片、网页渲染资源和UI快照，这些东西都存放在系统级的缓存目录里。麻烦的是，它们会持续增长，体积可能达到数GB，而且常规的卸载操作根本清理不掉。

不同系统的清理命令如下：

Windows用户，按下Win + R，输入%LOCALAPPDATA%WorkBuddyCache，回车进入目录后手动删除内容。

macOS用户，打开终端，直接执行这条命令：rm -rf ~/Library/Caches/com.codebuddy.workbuddy/cache/。

Linux用户，则执行：rm -rf ~/.cache/workbuddy/cache/。

这里有个重要提醒：清理时请避开那个Sandbox目录。如果误删了它，你已经加载的所有技能都会丢失，需要重新下载。

四、暂存盘（Scratch Disk）的容量与迁移配置

暂存盘的角色有点像“临时调度中心”，负责处理多任务并行时的内存交换、大文件解压缓冲，以及模型推理的中间状态暂存。如果它所在的分区剩余容量低于8GB，系统就会拒绝写入并触发存储告警。

配置方法很简单：在WorkBuddy主窗口点击右上角的「首选项」，然后进入「增效工具」找到「暂存盘」。点击「更改路径」，选择一个剩余空间不小于50GB的非系统盘（例如E:WorkBuddy_Temp）。

记得勾选上「清空原暂存盘缓存」选项，确认后系统会自动完成缓存迁移和缓冲区重置。完成设置并重启WorkBuddy，新的暂存盘就会立刻生效。别忘了，旧路径下可能还有残留文件，需要你手动清理一下。

五、剪贴板与远程指令传输层的隐性上限

很多用户一遇到问题就怀疑是文件太大，但实际上，日常操作中最容易触发限制的，往往是剪贴板和Claw协议层的传输阈值。这个限制独立于磁盘空间，却直接决定了大块内容能否成功注入。

首先，客户端默认的剪贴板上限是maxPayloadSizeKB: 2048（也就是2MB）。超过这个大小的内容会被静默丢弃，而且没有任何提示。

其次，即便你启用了剪贴板分块传输，IM网关层（比如飞书、企业微信的后台）还有自己的校验规则。如果后台设置的单条指令最大字符数限制在20000，那么大约1.5MB的富文本内容就无法成功送达WorkBuddy。

最后，Claw连接还受系统nofile限制的影响。如果ulimit -n的值仍然只是默认的1024，那么当你同时打开3个PDF和2个ZIP文件进行处理时，任务就很可能卡在“等待文件句柄”的状态，动弹不得。