Higangssh/homebutler

它解决的问题

HomeButler 解决了家庭实验室维护中的“混乱中间地带”，即服务器随着时间推移而漂移，变得难以管理。它解决了自上次检查以来不知道服务器上发生了什么变化的问题，帮助您识别服务为何重启、端口是否被错误的进程占用，以及备份是否真正可恢复。

它的工作原理

它是一个 Go 二进制文件，作为一个运维工具包运行，无需常驻守护进程或数据库。它获取服务器状态（容器、端口、进程）的快照，并与之前的基线进行比较。它提供结构化的、管家式的变更报告（例如，“新增”、“消失”、“替换”），并包含一个用于预检的“doctor”命令和一个“drill”功能，用于验证备份能否成功启动并通过健康检查。

适用人群

这适用于自托管者和家庭实验室爱好者，他们希望有一个清晰、结构化的界面来监控服务器。它也设计用于AI代理或自动化脚本，因为它为所有诊断和监控功能提供机器可读的JSON输出。

亮点

• 变更检测： 自动识别并分类变更，如容器重建、镜像更新或端口所有权转移。
• 备份验证： 包含一个 drill 命令，在隔离容器中启动备份以确认其功能正常。
• 代理友好： 设计用于通过 MCP（模型上下文协议）或 CLI 供 AI 代理使用，提供结构化数据，无需完整的 SSH shell 访问权限。
• 无需守护进程： 作为独立工具通过 SSH 运行，保持服务器占用最小化。
• 崩溃分析： 监控 Docker、systemd 和 PM2 服务，捕获日志并分析崩溃原因，如 OOM（内存不足）或段错误。