[新增] 对接 Uptime Kuma

docs/guildline/development-constraints.md

@@ -49,7 +49,9 @@ Frontend：
 
 各组件和模块（Server、Agent、Frontend）的物理目录分层职责详见 [仓库结构](../design/repository.md)。在此结构下，开发必须遵守以下核心分层规则：
 
-* **Server 开发规则**：禁止在 `controller/` 堆积业务逻辑，禁止在 `middleware/` 实现业务流程，禁止为简单需求新增平台层抽象。
+* **Server 开发规则**：
+  * 禁止在 `controller/` 堆积业务逻辑，禁止在 `middleware/` 实现业务流程，禁止为简单需求新增平台层抽象。
+  * **定时任务开发规则**：禁止将不同业务模块（如 Uptime Kuma 整合、WAF IP 同步等）的定时任务具体执行逻辑与状态堆积在单个 `cron.go` 文件中。各模块对应的定时任务结构体和运行逻辑必须在独立的 Go 文件中定义，`cron.go` 只允许承担统一注册、初始化与调度器启停的职责。
 * **Agent 开发规则**：每个模块职责单一，外部命令调用集中封装，状态落盘与配置落盘分离。
 * **Frontend 开发规则**：页面文件只负责获取路由参数、组织页面结构、调用 feature 组件；不应手写复杂 API 细节、复杂表单校验逻辑或维护大量彼此耦合的局部状态。
 

docs/reference/configuration.md

@@ -95,6 +95,17 @@ go run . --port 3000 --log-dir ./logs
 | `GlobalApiRateLimitNum` / `GlobalApiRateLimitDuration` | 全局 API 限流次数 / 时间窗口 | `300` / `180` |
 | `GlobalWebRateLimitNum` / `GlobalWebRateLimitDuration` | 全局 Web 限流次数 / 时间窗口 | `300` / `180` |
 | `CriticalRateLimitNum` / `CriticalRateLimitDuration` | 敏感接口限流次数 / 时间窗口 | `100` / `1200` |
+| `UptimeKumaEnabled` | 是否启用 Uptime Kuma 自动同步 | `false` |
+| `UptimeKumaUrl` | Uptime Kuma 实例地址 | 空 |
+| `UptimeKumaUsername` | Uptime Kuma 登录用户名 | 空 |
+| `UptimeKumaPassword` | Uptime Kuma 登录密码（写专，接口不回显） | 空 |
+| `UptimeKumaMonitorScope` | 监控范围，支持 `all` (全部站点) 或 `selected` (选择站点) | `all` |
+| `UptimeKumaSelectedSites` | 已选择监控站点的名称列表（英文逗号分隔） | 空 |
+| `UptimeKumaSyncInterval` | 自动差分同步间隔（分钟） | `5` |
+| `UptimeKumaInterval` | 监控心跳检测频率（秒） | `60` |
+| `UptimeKumaRetry` | 监控最大重试次数 | `0` |
+| `UptimeKumaRetryInterval` | 监控重试间隔时间（秒） | `60` |
+| `UptimeKumaTimeout` | 监控请求超时断开时间（秒） | `48` |
 
 说明：