name: gohome
description: 当 Moltbot 需要通过 gRPC 发现、指标和 Grafana 测试或操作 GoHome 时使用。
metadata: {"moltbot":{"nix":{"plugin":"github:joshp123/gohome","systems":["x86_64-linux","aarch64-linux"]},"config":{"requiredEnv":["GOHOME_GRPC_ADDR","GOHOME_HTTP_BASE"],"example":"config = { env = { GOHOME_GRPC_ADDR = \"gohome:9000\"; GOHOME_HTTP_BASE = \"http://gohome:8080\"; }; };"},"cliHelp":"GoHome CLI\n\n用法:\n gohome-cli [命令]\n\n可用命令:\n services 列出已注册的服务\n plugins 检查已加载的插件\n methods 列出 RPC 方法\n call 调用一个 RPC 方法\n roborock 管理 roborock 设备\n tado 管理 tado 区域\n\n标志:\n --grpc-addr string gRPC 端点 (host:port)\n -h, --help 显示帮助信息\n"}}

GoHome 技能

快速开始

设置所需的环境变量：

export GOHOME_HTTP_BASE="http://gohome:8080"
export GOHOME_GRPC_ADDR="gohome:9000"

命令行工具

列出所有已注册的服务：

gohome-cli services

服务发现流程（只读）

1. 列出所有插件。
2. 查看指定插件的详细信息。
3. 列出所有可用的 RPC 方法。
4. 调用一个只读的 RPC 方法。

指标验证

验证 GoHome 是否正在输出 Prometheus 指标：

curl -s "${GOHOME_HTTP_BASE}/gohome/metrics" | rg -n "gohome_"

有状态操作

重要：只有在获得用户明确批准后，才能调用会修改状态的写入型 RPC 方法。