mulerun本地存储空间减少需清理缓存：一、dry-run预览；二、清理本地代理与浏览器缓存；三、清空知识库索引；四、卸载临时agent环境；五、重置配置与日志归档。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用MuleRun过程中发现本地或云端虚拟机存储空间持续减少，可能是缓存数据未及时清理所致。MuleRun虽默认运行于隔离云端虚拟机中，但其本地代理、浏览器插件、知识库索引及临时Agent执行痕迹仍可能在用户设备端积累缓存。以下是释放存储空间的具体操作指南：
一、执行dry-run预览清理范围
在真正删除任何文件前，必须先通过dry-run模式查看MuleRun将扫描和标记哪些缓存项，避免误删关键配置或历史工作流数据。该模式不执行物理删除，仅输出预估释放空间与路径列表。
1、打开终端（macOS/Linux）或Windows PowerShell（以管理员权限非必需，但需确保当前用户对MuleRun配置目录有读取权）。
2、输入命令：mulerun clean --dry-run 并回车执行。
3、等待扫描完成，观察输出中是否包含“Browser cache”、“Knowledge index temp”、“Agent execution logs”、“Local proxy cache”等条目及其对应大小。
4、确认无异常路径（如意外出现~/Documents/或~/Desktop/下的子目录）后，方可进入实际清理阶段。
二、清理本地代理与浏览器缓存
MuleRun桌面客户端或浏览器扩展会在本地生成代理缓存（如HTTP响应快照、嵌入式模型分片缓存），这些内容不随云端虚拟机重置而清除，需手动干预。
1、关闭所有已打开的MuleRun相关窗口，包括Chrome/Firefox/Edge扩展弹窗及主应用界面。
2、在终端中运行：mulerun clean --target local-proxy --target browser-cache。
3、系统将提示确认删除，输入 y 并回车。
4、等待命令返回“Cleaned: X files, freed Y.X GB”，检查输出路径是否全部位于 ~/Library/Caches/mulerun/（macOS）或 %LOCALAPPDATA%\MuleRun\Cache\（Windows）内。
三、清空知识库本地索引缓存
MuleRun的Knowledge模块为加速文档检索会构建本地向量索引副本。当用户频繁上传/删除PDF、Markdown等资料时，旧索引文件可能残留并占用数GB空间。
1、访问MuleRun主界面右上角设置图标，点击「Knowledge」→「Manage Indexes」。
2、在索引列表页底部点击 Clear All Local Indexes 按钮。
3、弹出二次确认框，勾选 Also delete associated raw chunk caches 选项。
4、点击确认后，界面显示“Index cache purged”且状态栏提示释放空间数值。
四、卸载并重建临时Agent运行环境
每次调用自定义Agent或执行Computer模块任务时，MuleRun会在临时目录部署轻量容器镜像及依赖包。部分失败任务可能导致残留未回收环境，占用/var/folders或%TEMP%空间。
1、在终端执行：mulerun cleanup env --force。
2、该命令将终止所有正在运行的临时Agent进程，并递归删除 ~/.mulerun/envs/ 下全部子目录（不含user-agents/主目录）。
3、若需保留特定Agent模板，可在执行前手动移出对应文件夹至其他位置。
4、命令完成后，可运行 mulerun status --envs 验证输出为空列表。
五、重置本地配置与日志归档
MuleRun客户端自身会产生调试日志、崩溃报告及配置快照，长期运行后可能堆积数百MB文本文件，尤其在启用Verbose Logging时。
1、定位到配置根目录：~/.mulerun/（macOS/Linux）或 %APPDATA%\MuleRun\（Windows）。
2、进入 logs/ 子目录，执行 find . -name "*.log" -mtime +7 -delete（macOS/Linux）或使用PowerShell命令：Get-ChildItem -Path ".\logs\" -Filter "*.log" | Where-Object {$_.LastWriteTime -lt (Get-Date).AddDays(-7)} | Remove-Item。
3、进入 backups/ 目录，删除除最新两个日期命名的tar.gz文件外的所有归档。
4、返回 ~/.mulerun/，检查是否存在 config.bak 或 state.tmp 类临时文件，予以删除。
