用途：通过 Prometheus HTTP API 查询任何兼容的指标端点，包括自建 Prometheus、Grafana Cloud、Amazon Managed Prometheus、Thanos、Cortex、Mimir；既可作为智能体动作调用，也可作为仪表盘面板的数据源。
凭据：环境变量 PROMETHEUS_URL（必填，基础 URL，无尾斜杠）；PROMETHEUS_USERNAME 与 PROMETHEUS_PASSWORD 为可选基本认证（Grafana Cloud 的用户名为 stack instance ID），必须成对；PROMETHEUS_BEARER_TOKEN 为可选 Bearer 令牌。认证选择顺序确定：完整基本认证对优先，其次 Bearer 令牌，否则不加 Authorization 头；只提供用户名或密码之一视为无基本认证。
主要能力（通过 pnpm action prometheus 调用）：query 即时查询（可加 --time）、query_range 范围查询（需 --start/--end，可选 --step，省略时自动计算约 250 个点、最小 15s）、labels 列出标签名、label_values 列出某标签的值、series 按匹配器列出序列、metadata 查看指标元数据、alerts 查看当前触发的告警。
仪表盘面板：作为面板源时 sql 字段仍是字符串，需放入序列化的 JSON 描述符；默认 mode=range、range=1h、step=auto，mode=instant 仅用于 metric/callout 图表类型。返回行为每 (timestamp, series) 一行，形如 {timestamp, series, value}，面板需设置 xKey 与 yKey 以便渲染。
Node Exporter 仪表盘：可从目录安装，使用 pnpm action list-dashboard-templates 列出、再以 pnpm action install-dashboard-template --templateId=node-exporter-macos 或 node-exporter-full 安装。macOS 上可用 brew install node_exporter prometheus 本地搭建并配置抓取。
限制：范围查询返回矩阵、即时查询返回向量，均展平为 {timestamp, series, value} 行；查询与范围查询不缓存，元数据端点缓存 10 分钟；需注意基数问题，可用标签匹配器或聚合降低序列数；HTTP 200 但 status 为 error 视为失败并原样返回错误信息；不要用数据库查询代替，Prometheus 是独立后端。