如何管理 aily-builder 缓存cache stats / clear 命令完全指南告别磁盘爆满【免费下载链接】aily-builderFaster Arduino compilation CLI. Arduino快速编译工具小项目提速50%大项目提速80%! 时间就是金钱我的朋友!项目地址: https://gitcode.com/gh_mirrors/ai/aily-builderaily-builder 是一款比 arduino cli 更快的 Arduino 快速编译工具小项目提速 50%、大项目提速 80%其智能缓存正是提速的关键。但缓存越积越多磁盘告急怎么办本文用 5 分钟带你完全掌握 aily-builder 缓存管理一条命令查清缓存占用一条命令安全清理从此告别磁盘爆满 先搞清楚aily-builder 到底缓存了什么编译越快落盘的东西就越多。aily-builder 一共维护3 个持久化缓存桶cache bucket统一由缓存注册表 src/CacheRegistry.ts 管理缓存桶存的是什么为什么占空间Object cache对象缓存编译好的.o目标文件及元数据每个源文件一份跨构建复用增量编译的底气Library index cache库索引缓存依赖分析器生成的源码/宏索引跳过重复依赖扫描让预处理超快分析Archive cloud cache归档云缓存可复用的核心库与第三方库.a归档跨项目复用整库编译成果体积最大对象缓存的存放逻辑定义在 src/CacheManager.ts缓存键由命令 参数 源文件的 MD5 生成并按前两位哈希分目录散列存放避免单目录文件过多。缓存都在哪里各平台默认路径一览不用满世界找三个桶的默认位置都遵循同一套路归档云缓存路径见 src/ArchiveCloudCacheManager.tsWindows%LOCALAPPDATA%\aily-builder\cache与%LOCALAPPDATA%\aily-builder\archive-cloud-cachemacOS~/Library/Caches/aily-builder/cache与~/Library/Caches/aily-builder/archive-cloud-cacheLinux~/.aily-builder/cache与~/.cache/aily-builder/archive-cloud-cache 记不住直接跑aily-builder cache stats每个桶的实际绝对路径Path 行都会打印出来比文档更靠谱。一键体检用 cache stats 查看缓存占用查看命令很简单# 人类可读的统计报告 aily-builder cache stats # 加上详情描述、最旧文件使用时间 aily-builder cache stats --verbose # 机器可读 JSON方便写脚本监控磁盘 aily-builder cache stats --json输出会按桶逐项列出Entries缓存条目数对象数 / 库索引数 / 归档条目数Files / Size文件数与占用空间Path该桶的真实目录Last used最近一次使用时间最后给出三项Total汇总。想接入 CI 或磁盘监控脚本加上--json即可拿到结构化数据输出格式定义见 src/CacheRegistry.ts。安全清理cache clear 的 3 种模式cache clear支持三种模式必须且只能三选一选错会报错Choose exactly one clear option逻辑见 main.ts参数作用适用场景--unused-30清理 30 天未使用的缓存日常瘦身最温和 ✅--unused-7清理 7 天未使用的缓存磁盘吃紧时的进阶清理--all清空全部持久化缓存彻底重置下次编译会慢一截两个强力助手参数# 预览模式只告诉你将要删什么、能省多少一个字节都不动 aily-builder cache clear --unused-7 --dry-run # 输出 JSON 报告便于自动化 aily-builder cache clear --unused-30 --json️ 安全性方面有两道保险清理前会做目录安全校验拒绝操作非 aily-builder 缓存目录、拒绝碰文件系统根目录删除时逐路径确认落在缓存目录内部实现见 src/CacheRegistry.ts。未使用的判定基于文件的访问/修改时间且对象缓存会把.o与.meta.json视为同一条目整体处理不会留下半成品。推荐的日常维护流程照抄即可先看aily-builder cache stats确认哪个桶最占地方试删aily-builder cache clear --unused-30 --dry-run预览能释放的空间真删数字符合预期后去掉--dry-run正式执行复查再跑一次cache stats确认瘦身效果删错了怎么办没关系——缓存随时可再生代价只是下一次编译回到全量编译的速度。常见问题问不手动清理会怎样缓存会无限膨胀吗不会。aily-builder 在每次compile结束后会自动执行缓存维护src/CacheManager.ts每 30 天检查一次当缓存超过1 GB 或 5 万个文件时先清 30 天未用的仍超限再清 7 天未用的。手动cache clear相当于给自动维护加急。问清掉缓存会影响我的工程代码吗不会。cache命令只动上面列出的三个缓存目录你的 sketch、构建输出目录aily-builder/project/下都不受影响。问CI 环境里怎么省磁盘跑cache stats --json接监控配合定时任务执行cache clear --unused-7详见官方中文文档 README-ZH.md 的缓存管理章节。小结aily-builder cache stats可加--verbose/--json体检缓存看清三大缓存桶占了多少空间aily-builder cache clear --dry-run零风险预览先看清楚再动手--unused-30/--unused-7/--all三档清理力度按需选择配合内置的 1 GB 自动维护机制缓存只是加速资产清掉随时能重建——放心用、大胆清掌握这两个命令你的 aily-builder 磁盘占用从此尽在掌握编译飞快磁盘清爽 ⚡【免费下载链接】aily-builderFaster Arduino compilation CLI. Arduino快速编译工具小项目提速50%大项目提速80%! 时间就是金钱我的朋友!项目地址: https://gitcode.com/gh_mirrors/ai/aily-builder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考