uptime-kuma

核心用法

Uptime Kuma Skill 是一个面向运维场景的文档型技能，旨在帮助用户通过命令行工具管理 Uptime Kuma 监控服务器。该技能本身不包含可执行代码，而是提供完整的 CLI 使用文档，指导用户安装 uptime-kuma-api Python 包并配置环境变量（UPTIME_KUMA_URL、UPTIME_KUMA_USERNAME、UPTIME_KUMA_PASSWORD），进而实现对监控器的全生命周期管理。

用户可通过 kuma.py 脚本执行多种操作：查看整体状态摘要（status）、列出所有监控器（list）、获取单监控器详情（get）、添加/删除监控器（add//delete）、暂停/恢复检查（pause//resume）、查看心跳历史（heartbeats）以及管理通知渠道（notifications）。支持的监控类型涵盖 HTTP/HTTPS、ICMP Ping、TCP 端口、关键词检测、DNS 解析、Docker 容器、数据库（MySQL/PostgreSQL/MongoDB/Redis）、MQTT 代理等多种场景，几乎覆盖了主流的服务可用性监控需求。

显著优点

该技能的最大优势在于其纯文档型设计，无实际可执行代码，从根本上消除了代码注入和恶意执行的风险。功能定义清晰完整，提供了从基础查询到高级管理的完整 CLI 命令参考，并包含实用的工作流示例（如批量暂停监控器进入维护模式）。依托 Uptime Kuma 这一成熟的开源监控平台，用户可获得企业级的监控能力，包括美观的 Web 界面、丰富的通知渠道（Telegram、Discord、Slack、邮件等）以及多租户支持。

此外，技能支持多种监控类型和灵活的自定义间隔配置，配合 JSON 输出格式便于与 jq 等工具链集成，适合自动化运维场景。Socket.IO 实时通信机制确保了监控状态的即时同步，相比传统轮询方案更加高效。

潜在缺点与局限性

该技能存在明显的实现缺口：文档中引用的 scripts/kuma.py 脚本文件实际不存在，用户必须自行实现完整的 CLI 工具。这不仅增加了使用门槛，还可能因实现质量参差不齐引入安全隐患。依赖管理方面，，uptime-kuma-api 包未指定版本约束，存在依赖冲突或供应链攻击风险。

功能层面，技能仅提供文档指导，无法直接执行任何操作，AI Agent 的自动化能力受限。对于不熟悉 Python 开发的用户，环境配置和脚本调试可能成为障碍。此外，Uptime Kuma 本身不支持分布式部署，大规模监控场景下可能面临性能瓶颈。

适合的目标群体

该技能主要面向DevOps 工程师、系统管理员、SRE 团队以及具备一定开发能力的运维人员。适合已部署或计划部署 Uptime Kuma 监控基础设施的技术团队，尤其是需要通过命令行或自动化脚本批量管理监控器的场景。对于追求"文档即代码"理念、希望将监控配置纳入版本控制的组织尤为适用。

不适合无技术背景的业务人员，或期望开箱即用、无需任何开发工作的用户。若团队缺乏 Python 开发能力，建议直接使用 Uptime Kuma 的 Web 界面而非通过该技能间接操作。

使用风险

性能风险：Socket.IO 长连接在高并发场景下可能消耗较多服务器资源；大规模监控器列表查询时 JSON 输出可能产生较大内存开销。依赖风险：uptime-kuma-api 作为社区维护包，更新频率和长期支持存在不确定性；未锁定版本可能导致破坏性更新。凭证泄露风险：环境变量存储密码在容器化环境中易被通过 /proc 文件系统读取，多用户系统下也存在暴露风险。网络风险：与 Uptime Kuma 服务器的通信若未启用 TLS，凭证和监控数据可能被中间人截获。实现风险：用户自行编写的 kuma.py 若缺乏输入验证，可能引发命令注入或路径遍历漏洞。