homebutler
一个无需守护进程的轻量级家庭服务器管理工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：homebutler。 它的用途是：一个无需守护进程的轻量级家庭服务器管理工具。 完整的 Skill 内容见：https://321skill.com/skills/homebutler/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查一下家庭服务器的健康状况，看看有没有异常容器或资源压力。”，它会调用HomeButler执行 `homebutler report` 命令，并以清晰的结构化文本或JSON格式返回服务器的CPU、内存使用情况、容器状态、端口映射以及任何异常事件（如近期重启）的摘要报告。
介绍
HomeButler 旨在解决家庭实验室（Homelab）管理中那些琐碎但令人头疼的问题，例如不清楚服务器上运行了什么、哪个容器占用了端口、服务为何在半夜重启、备份是否真的可恢复等。它无需安装数据库或常驻的Web服务，仅通过一个Go二进制文件，即可提供清晰的服务器状态概览和诊断。
使用方式非常灵活，你可以通过命令行直接运行状态检查、容器列表、健康报告等命令，也可以通过其Web仪表板进行可视化监控，或者利用其JSON输出与其他工具或AI助手集成。安装过程简单，支持一键脚本或包管理器安装。
它非常适合那些运行小型家庭服务器、希望减少手动维护工作，并希望以结构化、安全的方式让AI助手协助管理服务器的用户，例如个人开发者、技术爱好者或小团队。
建议初次使用时运行 homebutler init 进行交互式设置，并优先使用 homebutler report 命令获取全面的健康报告。注意，它主要面向轻量级管理，对于大型、复杂的企业级集群可能功能有限。
核心特点
与同类服务器管理工具相比，HomeButler的核心区别在于它不依赖常驻的守护进程或数据库，仅通过单一二进制文件运行，提供了对AI助手友好的结构化JSON接口，允许在不授予完整SSH权限的情况下安全地检查和操作服务器。
注意事项
不适合管理大规模、多节点的企业级生产环境集群。
常见问题
HomeButler需要一直运行吗？
不需要，它是一个按需运行的工具，没有常驻的守护进程。
它能管理非Docker的服务吗？
主要针对Docker容器管理，但也提供基本的系统状态监控（如CPU、内存）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/homebutler/raw/index.md 读取 homebutler 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/homebutler/raw/index.md（查看排版版本）