caezium/burrow

Burrow – 一款带有 AI 代理接口的原生系统维护应用

简介

• 一款免费、开源的桌面应用程序，支持 macOS（稳定版）和 Windows（预览版），内置小型 Rust 引擎（burrow-engine）。
• 提供商业 Mac 工具中常见的“清理”工具箱：垃圾文件移除、开发产物清除、残留安装程序清理、应用卸载（含残留文件）、安全维护（缓存重建、DNS 刷新、Dock/Finder 重启）、磁盘使用树状图以及实时系统状态仪表板。

为何提及 AI

• Burrow 运行一个 MCP (Machine-Control-Protocol) 服务器 – 一个 JSON-RPC / 可选的 HTTP 端点，公开与内置 CLI (mo) 相同的命令。这让外部 AI 代理（例如 Claude Code、Cursor、Codex）能够查询机器的近期指标，并在用户同意下执行清理或卸载等操作。
• 用户界面还提供“AI 解释”视图，让语言模型能将系统快照转换为易懂的自然语言描述。

主要功能 (macOS)

功能	说明
状态仪表板	CPU、内存、GPU、磁盘 I/O、网络、电池的实时走势图及健康评分。
历史记录	SQLite 数据库存储 5 天至 90 天的指标数据；图表可查看趋势。
清理 / 清除	扫描缓存、日志、node_modules、target/、__pycache__ 等；显示预览后将文件移至废纸篓（可恢复）。
安装程序	查找残留的 .dmg/.pkg 文件并安全移除。
优化	一键维护：重建缓存、修复元数据、刷新 DNS、重启 Dock/Finder。
软件管理	列出已安装应用（大小、来源），支持多选卸载，并显示 Homebrew 更新。
分析	矩形式树状图可视化磁盘使用情况；可深入至任何文件夹。
MCP / 代理 API	burrow mcp (stdio JSON-RPC) 及可选的 localhost HTTP API，为 AI 代理提供状态、指标及工具命令。
菜单栏 HUD	macOS 菜单栏中的小型叠加层，显示健康状况、顶层进程及工作状态。
签名更新	macOS 构建版本均经过 Developer-ID 签名与公证；更新通过 Sparkle 传递，并使用 Ed25519 签名馈送。

Windows 预览版

• 使用 WinUI 3 / .NET 8 实现，界面与 macOS 版本一致。
• 提供遥测、历史记录 (JSON)、MCP 桥接及系统托盘 HUD。
• 尚缺少部分清理合约；标记为 preview。

工作原理

• 用户界面（macOS 为 SwiftUI，Windows 为 WinUI 3）与内置的 burrow-engine 二进制文件通信，该程序采用 Functional Source License (FSL-1.1-ALv2) 授权。引擎命令行与 Mole 项目的开源 mo CLI 相同，因此使用相同的标志（如 mo clean, mo status --json 等）。
• 若为源码构建，可将内置引擎替换为外部 mo 二进制文件。
• 指标收集以可配置的间隔（默认每几秒）执行 mo status --json，并将结果存储于本地 SQLite 数据库。
• MCP 服务器作为子进程运行，通过 stdio 及选用的 loopback HTTP 端口公开 JSON-RPC，允许任何客户端（包含 LLM 驱动的代理）查询或调用工具。

安装

• macOS: brew install --cask caezium/tap/burrow (官方签名版本)。
• Windows: 从 GitHub 发布页面下载最新的 zip/exe，或从 windows/ 文件夹构建。

适用对象

• 需要单一原生应用进行日常 Mac/Windows 维护的高级用户。
• 正在构建 AI 助手工作流，且需要以编程方式查询系统健康状况或触发清理操作的开发者。
• 偏好开源替代方案，而非 CleanMyMac 等商业清理软件的用户。

限制 / 路线图

• Windows 版本仍为预览版；部分清理命令在 Mole 的 Windows CLI 稳定前为预留位置。
• 内置引擎采用源码可用 (Source-available) 的 FSL 授权，而非宽松的 OSS 授权。
• 未来计划包括“一键执行”调优例程、更深入/快速的磁盘分析，以及强化供应链与数据丢失防护机制。

---

以上所有细节均直接取自仓库的 README；未推论任何额外功能。