技能介绍

要解决什么问题

运维和日常盯盘里，很多场景不是「立刻查一次」就够：你要的是页面或接口变了再说话，没变就别刷屏。单靠 Agent 临时抓网页，既没有稳定基线，也很难和固定周期对齐。本技能把「检查逻辑」和「定时调度」拆开：检查与状态落盘在这里，周期触发交给 Calendar。

怎么工作

典型链路是：Calendar 定时触发 → Agent 读日程工单 → 调用本技能脚本 → 对比/判断 → 有变化才通知用户。

核心能力包括：

网页变化检测：抓取页面并计算指纹，与 monitor_state/ 下 {name}_hash.json 基线对比，有差异时返回变更详情
接口状态检查：对 API 做请求，校验状态码与关键字段是否符合预期
条件判断：对数据源字段用 >、==、contains 等运算符做表达式判断，满足再提醒
调度配置生成：根据监控名、间隔与脚本参数，输出 Calendar 日程创建用的 JSON，由 Agent 落地定时任务

脚本侧分工明确：web_check.py 负责 URL 指纹与可选关键词；api_check.py 负责 method、期望状态与字段；condition_check.py 负责条件求值；scheduler.py 只生成日程描述，不自己跑 cron。上次结果与历史写在 {name}_last.json、{name}_history.json，方便追溯。

适用边界与注意点

有状态：首次跑网页监控会建立基线并提示「已建立监控基线」，后续才有「无变化」的静默语义；删状态文件等于重置监控。
静默优先：无变化时应尽量不打扰用户，别把每次轮询都当成要汇报的事件。
依赖外部调度：技能本身不内置定时器，需要和 Calendar（或等价的日程触发）配合，否则只能手动单次检查。
实现约束：脚本设计为纯标准库、输出 JSON，便于 Agent 对接；复杂页面（强动态渲染、登录墙）可能不适合简单指纹方案，需要你在条件或数据源上收窄范围。