数据存储

~/monitor/
├── monitors.json       # 监控器定义
├── config.json         # 告警偏好设置
└── logs/               # 检查结果
    └── {name}/YYYY-MM.jsonl

首次使用时创建：mkdir -p ~/monitor/logs

作用范围

本技能具备以下能力：

• ✅ 将监控器定义存储在 ~/monitor/ 目录中
• ✅ 按指定时间间隔执行检查
• ✅ 在状态发生变化时向用户发出告警

执行模型：

• 用户显式定义“监控什么（WHAT）”
• 用户授予所需的所有权限或工具访问权
• 本技能仅负责“何时执行（WHEN）”和“告警（ALERTING）”

本技能不具备以下能力：

• ❌ 不假设可访问任何服务或端点
• ❌ 不在无用户明确定义指令的情况下运行检查
• ❌ 不存储凭据（用户需通过环境变量或其他技能提供）

依赖要求

必需依赖：

• curl — 用于 HTTP 检查

可选依赖（用于告警）：

• PUSHOVER_TOKEN / PUSHOVER_USER — 用于推送通知
• Webhook URL — 用户需自行提供其终端地址

如系统中存在则自动启用：

• openssl — 用于 SSL 证书检查
• pgrep — 用于进程检查
• df — 用于磁盘空间检查
• nc — 用于端口检查

快速参考

核心规则

1. 所有内容均由用户定义

当用户请求新增一个监控器时：

1. WHAT（监控什么）：用户明确指定需检查的目标
2. HOW（如何检查）：用户提供检查方法，或授权对应工具访问权限
3. WHEN（何时检查）：本技能负责管理检查间隔
4. ALERT（如何告警）：本技能负责处理通知逻辑

示例流程：

User: "每 5 分钟监控我的 API（api.example.com）"
Agent: "我将检查 HTTP 状态码。发生失败时是否告警？"
User: "是的，并且同时检查 SSL 证书"
→ 监控器按用户定义的检查项保存

2. 监控器定义格式

位于 ~/monitor/monitors.json 中：

{
  "api_prod": {
    "description": "用户 API 的健康状态",
    "checks": [
      {"type": "http", "target": "https://api.example.com/health"},
      {"type": "ssl", "target": "api.example.com"}
    ],
    "interval": "5m",
    "alert_on": "change",
    "requires": [],
    "created": "2024-03-15"
  }
}

3. 常见检查类型

用户可请求以下任意类型（或自定义其他类型）：

4. 确认信息格式

✅ Monitor: [描述]
🔍 Checks: [将执行哪些检查]
⏱️ Interval: [检查频率]
🔔 Alert: [触发告警的条件]
🔧 Requires: [所需工具或权限]

5. 状态变更告警机制

• 仅在状态变化时告警（OK → FAIL，或 FAIL → OK）
• 告警中包含失败次数统计
• 恢复为 OK 状态时发送恢复通知
• 绝不重复发送相同状态的冗余告警

6. 权限管理

requires 字段列出用户已授予的权限：

• 空数组 [] 表示仅启用基础检查（curl、df、pgrep）
• ["ssh:server1"] 表示用户已授权对 server1 的 SSH 访问
• ["docker"] 表示用户已授权 Docker 访问权限

代理在假设任何访问权限前，必须主动向用户确认。